loomesoftware/agent-uat

Loome UAT Agent 镜像文档

镜像概述

Loome UAT Agent 是 Loome 平台生态中的用户验收测试（User Acceptance Testing, UAT）专用代理工具。该镜像封装了执行用户验收测试所需的核心组件，通过与 Loome 平台服务端通信，实现测试环境连接、测试任务调度、测试用例执行及结果自动化上报，简化用户验收测试流程，提升测试效率与可靠性。

核心功能与特性

• 测试环境集成：支持与 Loome 平台及各类测试环境（如数据库、应用服务）建立安全连接，确保测试环境一致性。
• 测试任务自动化：接收并执行 Loome 平台下发的 UAT 测试任务，支持定时调度与手动触发两种模式。
• 测试结果上报：实时收集测试执行结果（通过/失败/跳过状态、详细日志），并同步至 Loome 平台控制台，便于测试进度追踪。
• 日志与监控：内置日志采集功能，记录测试过程关键信息，支持对接外部监控工具（如 Prometheus），便于问题排查。
• 轻量级部署：基于 Docker 容器化封装，体积小巧，资源占用低，支持跨平台快速部署。

使用场景

• Loome 平台用户验收测试：企业在使用 Loome 平台进行数据集成、数据治理、ETL 流程开发等场景后，通过该 Agent 执行用户验收测试，验证功能是否满足业务需求。
• 自动化测试流程构建：在 CI/CD 流水线中集成该 Agent，实现代码提交后自动触发 UAT 测试，缩短测试周期。
• 分布式测试环境管理：多 Agent 实例可部署于不同测试环境（开发/预发/生产模拟环境），统一由 Loome 平台调度，实现多环境并行测试。

使用方法与配置说明

环境要求

• Docker 19.03+ 环境
• 网络可访问 Loome 平台服务端（默认端口 443）
• 测试目标环境网络连通性（如数据库端口、应用服务端口）

快速启动

通过 docker run 命令直接启动 Agent 容器：

bash
docker run -d \
  --name loome-uat-agent \
  -e LOOME_PLATFORM_URL="https://your-loome-platform.com" \
  -e AGENT_TOKEN="your-uuid-agent-token" \
  -e TEST_ENV="uat-environment-01" \
  -v /var/log/loome-uat:/app/logs \
  docker.xuanyuan.run/loome/uat-agent:latest

核心环境变量配置

数据持久化

Agent 日志默认存储于容器内 /app/logs 目录，建议通过挂载宿主机目录持久化日志：

bash
-v /host/path/to/logs:/app/logs

容器状态监控

通过 Docker 原生命令监控容器运行状态：

bash
# 查看容器日志
docker logs -f loome-uat-agent

# 检查容器状态
docker inspect -f '{{.State.Status}}' loome-uat-agent

停止与更新

bash
# 停止容器
docker stop loome-uat-agent

# 删除容器
docker rm loome-uat-agent

# 更新镜像并重启（需重新指定环境变量）
docker pull docker.xuanyuan.run/loome/uat-agent:latest
docker run -d [同上配置] loome/uat-agent:latest

注意事项

• AGENT_TOKEN 需从 Loome 平台控制台生成，具备时效性，过期需重新获取并更新容器配置。
• 测试环境网络策略需开放 Agent 与 Loome 平台、测试目标之间的通信端口，避免连接失败。
• 高并发测试场景下，建议调整容器 CPU/内存资源限制（通过 --cpus、-m 参数），避免资源瓶颈影响测试效率。