jaegertracing/xdock-py

Python crossdock 集成测试镜像

镜像概述

Python crossdock镜像专为集成测试设计，提供基于Python环境的crossdock测试框架，用于验证多服务间的协同工作能力。该镜像旨在简化跨服务交互测试流程，确保不同服务组件在协同工作时符合预期行为，是开发团队进行系统集成验证的实用工具。

核心功能与特性

• Python环境集成：内置Python运行时环境，兼容主流Python测试库（如pytest、unittest）
• crossdock测试框架：支持跨服务接口调用验证，模拟多服务交互场景
• 轻量级设计：基于精简基础镜像构建，减少资源占用，适合CI/CD流程快速部署
• 灵活配置：支持自定义测试参数、环境变量注入，适配多样化测试需求

使用场景与适用范围

• 微服务架构集成测试：验证Python微服务与其他组件（如API服务、数据库、消息队列）的交互逻辑
• CI/CD流程自动化：在持续集成/部署流程中自动执行集成测试，确保代码变更不影响服务间协作
• 多团队协作验证：统一测试标准，帮助不同团队开发的服务组件验证接口兼容性
• 跨语言服务测试：作为Python服务测试端，与其他编程语言实现的服务进行交互验证

使用方法与配置说明

基本运行方式

通过docker run命令启动基础集成测试：

bash
docker run --rm python-crossdock

自定义测试用例

挂载本地测试脚本目录至容器，执行自定义测试逻辑：

bash
docker run --rm -v $(pwd)/integration-tests:/app/tests python-crossdock pytest /app/tests

环境变量配置

通过环境变量设置测试目标服务地址、超时时间等参数：

bash
docker run --rm \
  -e TARGET_SERVICE=http://api-service:8080 \
  -e TEST_TIMEOUT=60s \
  -e LOG_LEVEL=DEBUG \
  python-crossdock

Docker Compose集成示例

在docker-compose.yml中配置多服务联合测试环境：

yaml
version: '3.8'
services:
  test-runner:
    image: python-crossdock
    volumes:
      - ./tests:/app/tests
    environment:
      - TARGET_SERVICE=[***]
      - DB_SERVICE=[***]
    depends_on:
      - user-service
      - postgres

  user-service:
    build: ./user-service
    ports:
      - "8080:8080"

  postgres:
    image: postgres:14
    environment:
      - POSTGRES_DB=testdb
      - POSTGRES_USER=testuser
      - POSTGRES_PASSWORD=testpass