xoidocker/build Docker 镜像 - 轩辕镜像

镜像概述

本镜像为CI（持续集成）工具设计，提供一系列预配置的Dockerfile集合，旨在标准化CI流程中的构建环境，减少因环境差异导致的构建问题，简化持续集成与持续部署（CI/CD）流程中的环境配置工作。

核心功能与特性

• 标准化构建环境：统一CI流程中的依赖版本与工具配置，避免因环境差异导致的"在我机器上能运行"问题
• 多CI工具兼容：支持主流CI/CD平台，包括GitHub Actions、Jenkins、GitLab CI、CircleCI、Bitbucket Pipelines等
• 预集成常用工具：内置CI流程常用工具链（如Git、Docker、Maven、npm、Python、Java等），减少手动安装步骤
• 轻量级优化：基于 Alpine 或 slim 基础镜像构建，最小化镜像体积，缩短CI流程中的环境拉取时间
• 可定制化配置：支持通过构建参数（ARG）和环境变量（ENV）自定义工具版本、路径配置等

使用场景与适用范围

• 各类CI/CD流程中的自动化构建环节（代码编译、依赖安装、测试执行等）
• 需要跨团队、跨项目保持一致构建环境的开发团队
• 简化新CI项目的环境配置，降低环境维护成本
• 支持多语言项目构建（Java、Node.js、Python、Go等）
• 需在CI流程中集成容器化构建（Docker-in-Docker）的场景

使用方法与配置说明

基本使用流程

1. 从仓库拉取目标Dockerfile（或通过镜像仓库直接引用预构建镜像）
2. 在CI配置文件中指定使用该Dockerfile作为构建环境
3. （可选）通过构建参数或环境变量自定义配置
4. 执行CI流程，利用标准化环境完成自动化构建任务

CI配置示例

1. GitHub Actions配置示例

在 .github/workflows/build.yml 中引用：

yaml
name: CI Build
on: [push]

jobs:
  build:
    runs-on: ubuntu-latest
    container:
      image: your-registry/ci-utilities:latest  # 预构建镜像地址
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      
      - name: Install dependencies
        run: npm install  # 示例：Node.js项目依赖安装
      
      - name: Run tests
        run: npm test
      
      - name: Build artifact
        run: npm run build

2. GitLab CI配置示例

在 .gitlab-ci.yml 中配置：

yaml
stages:
  - build

build_job:
  stage: build
  image: your-registry/ci-utilities:latest  # 预构建镜像地址
  script:
    - mvn clean package  # 示例：Java Maven项目构建
  artifacts:
    paths:
      - target/*.jar

3. 本地测试与自定义构建

如需基于Dockerfile自定义构建：

bash
# 拉取Dockerfile（假设来自Git仓库）
git clone [***]
cd ci-utilities-dockerfiles

# 自定义构建（例如指定Node.js版本）
docker build \
  --build-arg NODE_VERSION=20 \  # 自定义Node.js版本
  --build-arg MAVEN_VERSION=3.9.6 \  # 自定义Maven版本
  -f Dockerfile.node-java \  # 选择特定工具组合的Dockerfile
  -t custom-ci-env:latest .

# 本地测试构建环境
docker run --rm -it custom-ci-env:latest /bin/sh

常用构建参数（ARG）

环境变量（ENV）配置

注意事项

• 预构建镜像需提前推送到私有/公共镜像仓库（如Docker Hub、AWS ECR、Harbor等）
• 对于Docker-in-Docker场景，需在CI配置中挂载Docker套接字（如-v /var/run/docker.sock:/var/run/docker.sock）
• 根据项目需求选择对应工具组合的Dockerfile（如纯Node.js环境、Java+Maven环境等）
• 定期更新基础镜像版本以修复安全漏洞（建议配合Dependabot等工具自动更新）