Docker for CI (基于Tetraweb) 镜像文档

1. 镜像概述

本镜像基于Tetraweb基础镜像构建，专为持续集成(CI)场景优化，提供标准化的运行环境和预安装的CI工具集。旨在简化CI流水线配置，减少环境差异导致的构建/测试失败，提升自动化流程效率。

2. 核心功能与特性

• 轻量级基础：基于Tetraweb镜像，继承其轻量级、高性能特性，镜像体积小，启动速度快
• 工具预集成：内置CI流程常用工具，包括Git、构建工具（Maven、npm、Gradle）、测试框架（JUnit、pytest）及容器化工具（Docker CLI）
• 多平台兼容：支持x86_64和ARM架构，兼容主流CI系统（Jenkins、GitLab CI、GitHub Actions、Bitbucket Pipelines）
• 可定制配置：通过环境变量和挂载卷灵活调整运行参数，支持自定义工作目录和工具版本
• 安全更新：定期更新基础镜像和内置工具，修复安全漏洞，确保运行环境安全性

3. 使用场景与适用范围

• 自动化测试：在CI流水线中执行单元测试、集成测试、E2E测试
• 应用构建：编译源代码并生成可部署产物（如JAR包、二进制文件、Docker镜像）
• 代码质量检查：集成静态代码分析工具（SonarQube Scanner）执行代码质量检测
• 多环境适配：为不同项目提供一致的构建/测试环境，消除"本地可运行，CI失败"问题
• 轻量级CI节点：作为临时CI执行节点，完成任务后自动销毁，节省资源

4. 使用方法与配置说明

4.1 基本运行命令

# 基础用法：执行自定义测试脚本
docker run --rm -v $(pwd):/workspace tetraweb/ci:latest \
  /bin/sh -c "cd /workspace && ./scripts/run-ci.sh"

4.2 核心配置参数

4.2.1 环境变量

4.2.2 数据卷挂载

4.3 CI系统集成示例

4.3.1 GitLab CI/CD 配置（.gitlab-ci.yml）

stages:
  - test
  - build

ci-test:
  stage: test
  image: tetraweb/ci:latest
  variables:
    WORKSPACE: /builds/$CI_PROJECT_PATH
    LOG_LEVEL: debug
  script:
    - cd $WORKSPACE
    - npm install
    - npm run lint
    - npm test
  artifacts:
    paths:
      - $WORKSPACE/test-reports/

ci-build:
  stage: build
  image: tetraweb/ci:latest
  variables:
    BUILD_CACHE_DIR: /cache/npm
  script:
    - cd $WORKSPACE
    - npm install --cache $BUILD_CACHE_DIR
    - npm run build
  cache:
    paths:
      - $BUILD_CACHE_DIR
  artifacts:
    paths:
      - $WORKSPACE/dist/

4.3.2 Jenkins Pipeline 配置

pipeline {
  agent {
    docker {
      image 'tetraweb/ci:latest'
      args '-v $WORKSPACE:/workspace -v /var/run/docker.sock:/var/run/docker.sock'
    }
  }
  environment {
    WORKSPACE = '/workspace'
    SKIP_TESTS = 'false'
  }
  stages {
    stage('Build') {
      steps {
        sh '''
          cd $WORKSPACE
          mvn clean package -DskipTests=$SKIP_TESTS
        '''
      }
    }
  }
  post {
    success {
      archiveArtifacts artifacts: 'target/*.jar', fingerprint: true
    }
  }
}

5. 注意事项

• 建议使用指定版本标签（如:1.2.0）而非:latest，确保CI流程稳定性
• 如涉及敏感信息（如API密钥），建议通过CI系统的保密变量功能传入，避免硬编码
• 如需扩展工具集，可基于本镜像构建自定义镜像：

  FROM tetraweb/ci:latest
  RUN apt-get update && apt-get install -y <额外工具>
  

• 容器运行时需确保挂载目录权限正确，建议使用与宿主机相同的UID/GID运行容器以避免权限问题