构建阶段模块 Docker 镜像文档

镜像概述和主要用途

本Docker镜像是专为软件开发构建阶段设计的模块化解决方案，集成了必要的构建工具、环境配置及依赖管理组件。其核心目标是简化构建流程，通过标准化构建环境，消除因开发环境差异导致的构建不一致问题，确保跨团队、跨环境的构建结果可靠一致。适用于各类软件开发项目的构建环节，可无缝集成到本地开发或CI/CD流水线中。

核心功能和特性

• 预配置构建工具集：集成常用构建工具（如编译器、打包工具、版本控制工具等），无需手动安装配置
• 轻量级设计：基于精简基础镜像构建，减少资源占用，提升构建效率
• 环境隔离：通过容器化实现构建环境与宿主环境隔离，避免依赖冲突
• 跨平台兼容：支持多种架构（如x86_64、ARM）及主流操作系统的构建需求
• 灵活可扩展：支持自定义构建脚本和工具链扩展，适应不同项目的特殊构建需求
• CI/CD友好：提供标准化接口，易于集成到Jenkins、GitLab CI、GitHub Actions等CI/CD平台

使用场景和适用范围

• 应用程序编译：C/C++、Java、Python等各类语言的应用程序编译构建
• 库文件打包：静态库、动态库等软件库的打包与版本管理
• 前端资源构建：JavaScript/TypeScript项目打包、CSS预编译、静态资源优化等
• 跨环境一致构建：需要在开发、测试、生产等不同环境保持一致构建结果的场景
• 自动化构建流水线：作为CI/CD流程中的标准化构建节点，实现自动化构建

使用方法和配置说明

基本使用

通过docker run命令启动容器，挂载源代码目录和输出目录，执行构建操作：

docker run -it --rm \
  -v /path/to/source:/app/source \  # 挂载源代码目录
  -v /path/to/output:/app/output \  # 挂载构建输出目录
  [镜像名称]:[标签] \
  /app/source/build.sh  # 执行自定义构建脚本

环境变量配置

支持通过环境变量自定义构建行为，常用变量如下：

示例：指定自定义构建命令和输出目录

docker run -it --rm \
  -v /path/to/source:/code \
  -v /path/to/dist:/dist \
  -e BUILD_DIR=/code \
  -e OUTPUT_DIR=/dist \
  -e BUILD_CMD="npm run build" \
  [镜像名称]:[标签]

Docker Compose 配置

创建docker-compose.yml文件，集成到项目构建流程：

version: '3'
services:
  builder:
    image: [镜像名称]:[标签]
    volumes:
      - ./src:/app/source:ro  # 只读挂载源代码
      - ./dist:/app/output    # 挂载输出目录
    environment:
      - BUILD_DIR=/app/source
      - OUTPUT_DIR=/app/output
      - BUILD_CMD="mvn clean package -DskipTests"
    command: $BUILD_CMD  # 执行构建命令

启动构建：

docker-compose run --rm builder

自定义构建脚本

可将自定义构建逻辑编写为脚本（如build.sh），挂载到容器中执行：

# 本地创建 build.sh
#!/bin/bash
cd $BUILD_DIR
npm install
npm run lint
npm run build
cp -r ./build/* $OUTPUT_DIR

# 赋予执行权限
chmod +x build.sh

# 运行容器执行自定义脚本
docker run -it --rm \
  -v /path/to/source:/app/source \
  -v /path/to/output:/app/output \
  -v $(pwd)/build.sh:/app/build.sh \
  [镜像名称]:[标签] \
  /app/build.sh

集成CI/CD示例（GitLab CI）

在.gitlab-ci.yml中配置为构建阶段任务：

stages:
  - build

build_job:
  stage: build
  image: [镜像名称]:[标签]
  script:
    - export BUILD_DIR=$CI_PROJECT_DIR/src
    - export OUTPUT_DIR=$CI_PROJECT_DIR/dist
    - $BUILD_CMD
  artifacts:
    paths:
      - $OUTPUT_DIR/