fibery/ci

CI构建环境镜像

概述

本镜像专为持续集成(CI)流程设计，提供预配置的构建环境，集成CI构建所需的各类工具、依赖和运行时环境。旨在简化CI/CD管道中的构建环节，确保构建过程的一致性和高效性，减少环境配置带来的复杂性。

核心功能和特性

• 预配置工具集：集成常见CI构建工具（如编译器、打包工具、版本控制工具等），开箱即用
• 轻量级设计：优化镜像体积，加速CI流程中的镜像拉取和启动速度
• 环境一致性：确保不同CI节点上的构建环境统一，避免"在我机器上能运行"问题
• 多平台支持：兼容主流CI平台（如Jenkins、GitLab CI、GitHub Actions等）
• 可定制化：支持通过环境变量或配置文件调整构建参数和工具版本

使用场景和适用范围

• 自动化测试后的应用程序构建流程
• 多环境（开发、测试、生产）下的一致性构建
• CI/CD管道中构建阶段的标准化集成
• 需要快速部署和重复执行的构建任务

使用方法和配置说明

基本使用（docker run）

bash
docker run -v /path/to/project:/app -w /app [镜像名称] [构建命令]

• -v /path/to/project:/app：将本地项目目录挂载到容器内的/app工作目录
• -w /app：设置工作目录为/app
• [构建命令]：指定CI构建命令（如make build、npm run build等）

环境变量配置

可通过环境变量自定义构建行为：

• BUILD_TARGET：指定构建目标（如production、development），默认值：production
• LOG_LEVEL：设置构建日志级别（info、debug、warn），默认值：info
• CACHE_DIR：指定构建缓存目录，默认值：/tmp/build-cache

示例：

bash
docker run -e BUILD_TARGET=development -e LOG_LEVEL=debug -v /path/to/project:/app -w /app [镜像名称] npm run build

卷挂载

• 项目目录：必须挂载项目源代码目录至容器内工作目录（如/app）
• 缓存卷（可选）：挂载缓存目录以复用构建缓存，加速重复构建：

  bash
  docker run -v /path/to/project:/app -v build-cache:/tmp/build-cache -w /app [镜像名称] make build
  

docker-compose配置示例

yaml
version: '3'
services:
  ci-build:
    image: [镜像名称]
    volumes:
      - ./project:/app
      - build-cache:/tmp/build-cache
    working_dir: /app
    environment:
      - BUILD_TARGET=production
      - LOG_LEVEL=info
    command: ["npm", "run", "build"]

volumes:
  build-cache:

集成到CI平台

以GitLab CI为例，在.gitlab-ci.yml中使用：

yaml
build_stage:
  image: [镜像名称]
  stage: build
  variables:
    BUILD_TARGET: production
  script:
    - npm run build
  artifacts:
    paths:
      - dist/

注意事项

• 确保本地项目目录具有适当的读写权限，避免容器内权限问题
• 对于大型项目，建议挂载缓存卷以提升重复构建效率
• 根据项目需求选择合适的构建命令和环境变量配置