jaegertracing/xdock-go Docker 镜像 - 轩辕镜像

Go crossdock 镜像文档

镜像概述和主要用途

Go crossdock镜像是一个基于Go语言环境构建的Docker镜像，集成了crossdock测试框架，专为Go语言开发的应用提供跨服务、跨组件的集成测试能力。主要用于验证不同服务或模块间的交互逻辑，确保系统在集成层面的功能正确性。

核心功能和特性

• 原生Go环境支持：内置Go运行时和开发工具链，可直接编译和执行Go测试代码
• crossdock框架集成：预装crossdock测试工具，支持定义和执行跨服务交互测试用例
• 轻量级设计：基于精简基础镜像构建，减少镜像体积和资源占用
• 灵活配置：支持通过环境变量和命令行参数自定义测试行为
• CI/CD友好：可无缝集成到主流CI/CD流水线，支持自动化测试执行

使用场景和适用范围

• Go语言微服务架构的跨服务集成测试
• 多组件协作应用的集成功能验证
• 开发阶段本地调试跨模块交互逻辑
• 发布前的集成测试验证环节
• CI/CD流程中的自动化集成测试步骤

使用方法和配置说明

基本使用（docker run）

bash
# 运行本地测试用例
docker run --rm -v $(pwd)/integration-tests:/testcases go-crossdock:latest crossdock run /testcases

说明：将本地集成测试目录挂载到容器内/testcases，执行crossdock测试命令

环境变量配置

docker-compose配置示例

yaml
version: '3.8'
services:
  crossdock:
    image: go-crossdock:latest
    volumes:
      - ./tests:/app/tests  # 挂载测试代码目录
      - ./go.mod:/app/go.mod  # 挂载依赖文件（如需）
    environment:
      - CROSSDOCK_LOG=debug
      - CROSSDOCK_TIMEOUT=300
    command: crossdock run /app/tests --report junit.xml  # 生成JUnit格式报告
    depends_on:
      - service-a  # 测试依赖的服务A
      - service-b  # 测试依赖的服务B

注意事项

• 测试用例需遵循crossdock框架的规范编写
• 挂载测试目录时确保文件权限正确（可使用-u $(id -u):$(id -g)指定用户）
• 复杂测试场景需在docker-compose中定义完整的依赖服务栈
• 如需自定义Go版本，可使用带版本标签的镜像（如go-crossdock:1.21）