roomz/pytest-ci

docker-pytest-ci 镜像文档

镜像概述

docker-pytest-ci是一个专为TeamCity CI/CD环境设计的Docker镜像，预配置了Python运行环境及必要测试插件，旨在简化Python项目在TeamCity上的自动化测试流程，确保测试环境一致性和稳定性。

核心功能与特性

该镜像预装以下关键组件：

• teamcity：提供与TeamCity CI平台的集成能力，支持测试结果报告和构建状态同步
• mock：Python单元测试常用的模拟库，用于创建测试替身和模拟对象
• py launcher：模拟PEP-0397标准的Python启动器，提供统一的Python版本管理接口，方便多版本Python环境下的测试执行

使用场景

• TeamCity CI/CD管道中Python项目的自动化单元测试
• 需要在隔离环境中执行Python测试的场景
• 需与TeamCity平台集成并生成标准化测试报告的项目

使用方法

基本使用

通过以下命令在本地或TeamCity构建代理中运行测试：

bash
docker run --rm -v $(pwd):/app -w /app docker-pytest-ci pytest tests/

参数说明：

• -v $(pwd):/app：将当前工作目录挂载到容器内的/app目录
• -w /app：设置容器工作目录为/app
• pytest tests/：执行测试命令，运行tests目录下的测试用例

集成到TeamCity

在TeamCity构建步骤中配置如下命令：

bash
docker run --rm -v %system.teamcity.build.workingDir%:/app -w /app docker-pytest-ci pytest tests/

此配置将利用TeamCity内置变量%system.teamcity.build.workingDir%挂载当前构建目录，确保测试环境与构建环境一致。