pgbackrest/test Docker 镜像 - 轩辕镜像

开发与测试容器镜像

镜像概述和主要用途

本镜像是专为开发与测试场景设计的容器解决方案，旨在提供标准化开发环境并集成常用测试工具，解决"环境不一致"导致的开发协作与测试效率问题。通过预配置基础开发组件、调试工具及测试框架，支持从代码编写、调试到自动化测试的全流程工作，帮助团队简化多环境开发与测试流程，提升协作效率。

核心功能和特性

核心功能

• 标准化开发环境：提供统一的基础开发环境，包含编译器、运行时及依赖管理工具，消除"本地环境差异"问题。
• 多语言支持：内置对Python、Java、Node.js、Go等主流编程语言的开发环境支持，可通过配置灵活启用指定语言。
• 集成测试工具：预装JUnit、pytest、Mocha等常用测试框架，支持单元测试、集成测试及测试报告生成。
• 调试与诊断：集成GDB、LLDB、Chrome DevTools等调试工具，支持代码断点调试与性能分析。

主要特性

• 轻量级设计：基于Alpine或Debian Slim基础镜像构建，镜像体积小、启动速度快，资源占用低。
• 灵活配置：通过环境变量自定义工具版本、工作目录及语言支持范围，支持用户自定义扩展。
• 跨平台兼容：适配Linux、macOS（Docker Desktop）及Windows（WSL2）环境，支持x86_64与ARM架构。
• 持续更新：定期更新内置工具版本，修复安全漏洞，确保环境安全性与工具兼容性。

使用场景和适用范围

典型使用场景

• 团队协作开发：统一团队开发环境，确保代码在不同成员本地环境中的一致性运行。
• 自动化测试执行：作为测试环境容器，运行单元测试、集成测试脚本并生成标准化测试报告。
• CI/CD流程集成：嵌入CI/CD流水线（如GitHub Actions、Jenkins），作为自动化构建与测试的执行环境。
• 多项目环境隔离：为不同项目提供独立容器环境，避免依赖冲突（如不同版本SDK、库文件）。
• 教学与培训：快速搭建标准化教学环境，学员无需手动配置开发工具，直接开展实践操作。

适用范围

• 软件开发团队（小型到大型企业级团队）
• 自动化测试工程师与QA团队
• CI/CD流程维护人员
• 教育培训机构（编程教学、实训课程）
• 个人开发者（管理多项目开发环境）

使用方法和配置说明

快速启动容器

通过以下命令启动基础开发环境容器，默认挂载当前目录至容器工作区：

bash
docker run -it --rm -v $(pwd):/workspace dev-test-container:latest

参数说明：

• -it：启用交互式终端，支持命令行操作
• --rm：容器退出后自动清理，避免残留
• -v $(pwd):/workspace：将本地当前目录挂载至容器内/workspace工作目录

环境变量配置

通过环境变量自定义容器行为，常用配置项如下：

示例：启动支持Python+Go且预装pytest的容器

bash
docker run -it --rm \
  -v $(pwd):/workspace \
  -e LANG_SUPPORT="python,go" \
  -e TEST_TOOLS="pytest,go-test" \
  dev-test-container:latest

Docker Compose配置

创建docker-compose.yml文件，配置多服务开发测试环境：

yaml
version: '3.8'
services:
  dev-env:
    image: dev-test-container:latest
    volumes:
      - ./project-code:/workspace  # 挂载本地项目代码
      - dev-deps:/root/.cache      # 持久化依赖缓存
    environment:
      - WORKSPACE=/workspace
      - LANG_SUPPORT=python,nodejs
      - TEST_TOOLS=pytest,jest
    ports:
      - "8080:8080"  # 映射调试端口（如Node.js调试）
      - "5005:5005"  # Java远程调试端口
    command: /bin/bash  # 启动交互式终端

volumes:
  dev-deps:  # 持久化依赖缓存，加速重复构建

启动服务并进入容器：

bash
docker-compose up -d
docker-compose exec dev-env bash

自定义扩展配置

安装额外工具

容器支持通过包管理器安装额外工具（基于基础镜像类型选择命令）：

• Debian基础镜像：

  bash
  apt update && apt install -y <工具名称>  # 如：apt install -y git-lfs
  

• Alpine基础镜像：

  bash
  apk add --no-cache <工具名称>  # 如：apk add --no-cache curl
  

构建自定义镜像

如需固化自定义配置，可基于本镜像构建新镜像。创建Dockerfile：

dockerfile
FROM dev-test-container:latest

# 安装项目专属工具
RUN apt update && apt install -y terraform kubectl

# 配置自定义环境变量
ENV DEFAULT_TOOL=terraform

构建并使用：

bash
docker build -t custom-dev-test:latest .
docker run -it --rm custom-dev-test:latest

CI/CD集成示例

GitHub Actions配置

在.github/workflows/test.yml中集成容器执行测试：

yaml
jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - name: Checkout code
        uses: actions/checkout@v4

      - name: Run tests in container
        run: |
          docker run -v $(pwd):/workspace dev-test-container:latest \
            sh -c "cd /workspace && pytest tests/ --cov=src"  # 执行测试并生成覆盖率报告

GitLab CI配置

在.gitlab-ci.yml中配置容器测试步骤：

yaml
test:
  stage: test
  image: dev-test-container:latest
  script:
    - cd /workspace
    - pip install -r requirements.txt  # 安装项目依赖
    - pytest tests/  # 执行测试
  artifacts:
    paths:
      - test-reports/  # 持久化测试报告

以上配置确保测试在标准化环境中执行，避免CI平台环境差异影响测试结果。