consumerphysics/circleci

测试基础镜像

1. 镜像概述

测试基础镜像是一个专为测试环境设计的Docker基础镜像，旨在提供轻量级、标准化的测试运行环境。该镜像预装了测试场景所需的基础依赖和运行组件，可简化测试相关应用的构建流程，降低测试环境配置复杂度，适用于各类测试场景的快速搭建。

2. 核心功能与特性

2.1 轻量级设计

• 基于精简操作系统构建，镜像体积小，启动速度快，节省测试环境资源。

2.2 基础依赖预装

• 集成常用测试工具基础依赖（如基础命令行工具、网络工具、日志工具等），避免重复配置。

2.3 环境兼容性

• 支持主流Linux架构，兼容Docker、Kubernetes等容器化部署环境，确保测试环境一致性。

2.4 易于扩展

• 提供标准化基础层，支持通过Dockerfile或容器启动参数灵活扩展功能，满足个性化测试需求。

3. 使用场景与适用范围

3.1 单元测试环境

• 作为单元测试的基础运行环境，提供测试脚本执行所需的基础依赖。

3.2 集成测试环境

• 用于搭建多组件集成测试环境，简化多服务联动测试的环境配置。

3.3 CI/CD流程测试阶段

• 适用于CI/CD流水线中的自动化测试环节，作为测试任务的执行载体。

3.4 临时测试环境

• 快速搭建临时测试环境，用于功能验证、问题复现等临时测试场景。

4. 使用方法与配置说明

4.1 基本使用

4.1.1 拉取镜像

（若镜像已上传至镜像仓库）

bash
docker pull docker.xuanyuan.run/[镜像仓库地址]/test-base-image:latest

4.1.2 启动容器

bash
# 交互式运行容器
docker run -it --name test-env docker.xuanyuan.run/test-base-image /bin/bash

# 后台运行容器
docker run -d --name test-env docker.xuanyuan.run/test-base-image

4.2 环境变量配置

该镜像支持通过环境变量调整基础测试环境参数，常用环境变量如下：

示例：指定测试环境标识和日志级别

bash
docker run -it -e TEST_ENV=dev -e LOG_LEVEL=debug --name test-env docker.xuanyuan.run/test-base-image

4.3 基于镜像构建自定义测试镜像

可通过Dockerfile基于该基础镜像构建包含特定测试工具或依赖的自定义测试镜像，示例如下：

dockerfile
# 基于测试基础镜像构建
FROM docker.xuanyuan.run/test-base-image

# 安装自定义测试工具（如Python测试库pytest）
RUN apt-get update && apt-get install -y python3 python3-pip \
    && pip3 install pytest

# 设置工作目录
WORKDIR /app

# 复制本地测试脚本到容器
COPY ./test-scripts /app/test-scripts

# 定义默认命令（执行测试脚本）
CMD ["pytest", "/app/test-scripts"]

构建并运行自定义测试镜像：

bash
# 构建自定义镜像
docker build -t custom-test-image .

# 运行自定义测试容器
docker run --name custom-test-env docker.xuanyuan.run/custom-test-image

4.4 数据持久化

如需保存测试结果或日志，可通过挂载卷实现数据持久化：

bash
# 挂载本地目录到容器的测试结果目录
docker run -it -v /local/test-results:/app/test-results --name test-env docker.xuanyuan.run/test-base-image

5. 注意事项

• 该镜像专为测试环境设计，不建议用于生产环境。
• 使用前请确保本地Docker环境版本≥19.03，以保证兼容性。
• 如需扩展功能，建议通过构建自定义镜像实现，避免直接修改基础镜像。