igwn/packaging

镜像概述

该Docker镜像专注于测试容器的打包与管理，旨在简化测试环境容器的构建、打包、分发流程，帮助开发和测试团队标准化测试容器的创建过程，确保测试环境的一致性和可移植性。

核心功能和特性

• 自动化打包流程：支持自动识别测试项目结构，生成符合规范的测试容器镜像
• 多框架兼容：兼容JUnit、PyTest、RSpec等主流测试框架，适配多语言测试场景
• 轻量级设计：基于Alpine Linux构建，镜像体积小，资源占用低，部署效率高
• 灵活输出选项：支持将打包后的容器导出为tar归档文件或直接推送至容器仓库
• 配置可定制：通过环境变量和配置文件自定义打包规则、依赖管理和输出格式

使用场景和适用范围

• CI/CD流水线集成：在持续集成过程中自动打包测试容器，作为测试阶段的执行环境
• 测试环境标准化：统一团队内部测试容器配置，避免"本地可运行，CI失败"的环境差异问题
• 测试容器分发：方便测试团队共享预配置的测试环境容器，加速测试环境搭建
• 测试版本管理：配合版本控制系统，实现测试容器版本化管理和回溯

使用方法和配置说明

基本使用（docker run）

基础打包命令

bash
docker run -v $(pwd):/app \
  -e TEST_PROJECT_PATH=/app \
  -e OUTPUT_FORMAT=tar \
  -e OUTPUT_PATH=/app/test-container.tar \
  docker.xuanyuan.run/packaging-test-containers

推送至容器仓库

bash
docker run -v /var/run/docker.sock:/var/run/docker.sock \
  -e TEST_PROJECT_PATH=/app \
  -e OUTPUT_FORMAT=registry \
  -e REGISTRY_URL=my-registry.example.com \
  -e IMAGE_NAME=test-container \
  -e IMAGE_TAG=v1.0.0 \
  docker.xuanyuan.run/packaging-test-containers

环境变量配置

Docker Compose配置示例

yaml
version: '3.8'
services:
  test-container-packager:
    image: docker.xuanyuan.run/packaging-test-containers
    volumes:
      - ./test-project:/app
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - TEST_PROJECT_PATH=/app
      - OUTPUT_FORMAT=registry
      - REGISTRY_URL=registry.example.com
      - IMAGE_NAME=integration-test
      - IMAGE_TAG=${CI_COMMIT_SHA::8}
      - INCLUDE_DEV_DEPS=true

自定义配置文件

通过挂载配置文件自定义打包规则，配置文件路径：/etc/packager/config.yaml（需通过-v $(pwd)/config.yaml:/etc/packager/config.yaml挂载）

配置文件示例：

yaml
packaging:
  exclude_patterns:
    - "**/node_modules/**"
    - "**/.git/**"
  dependencies:
    auto_install: true
    lock_file: "requirements.txt"  # 根据项目类型自动识别，支持package.json、Gemfile等
output:
  compression_level: 6  # 仅对tar格式有效
  registry:
    timeout: 300  # 推送超时时间(秒)