newcity/builder

镜像概述

该Docker镜像专为持续集成(CI)流程设计，提供标准化的构建环境，旨在解决软件开发中因环境差异导致的"在我这里能运行"问题。通过预配置常用构建工具和依赖，简化CI/CD流水线中的构建阶段配置，提高开发效率和流程一致性。

核心功能与特性

核心功能

• 标准化环境：内置预配置的构建工具链，确保不同CI环境中构建过程的一致性
• 多语言支持：兼容多种主流编程语言（Java、Python、Node.js、Go等）的构建需求
• 轻量级设计：基于精简基础镜像构建，减少镜像体积，加快CI流程启动速度
• 工具集成：预安装常用构建工具（Maven、Gradle、npm、yarn、go build等）及测试工具

主要特性

• 开箱即用，无需手动配置构建依赖
• 支持自定义环境变量，灵活调整构建参数
• 兼容主流CI/CD平台（Jenkins、GitHub Actions、GitLab CI、Bitbucket Pipelines等）
• 定期更新以包含最新工具版本和安全补丁

使用场景

• 自动化构建流程：集成到CI/CD流水线，实现代码提交后的自动构建
• 多语言项目构建：统一管理多语言项目（如前后端分离项目）的构建环境
• 跨平台一致性：确保开发、测试、生产环境中构建过程的一致性
• 快速迭代开发：减少环境配置时间，加速开发团队的迭代速度

使用方法与配置说明

基本使用

直接运行构建环境

通过docker run命令启动镜像，挂载项目目录并执行构建命令：

bash
docker run --rm -v $(pwd):/app -w /app [镜像名称] [构建命令]

示例（Node.js项目构建）：

bash
docker run --rm -v $(pwd):/app -w /app ci-build-env npm run build

集成到CI/CD平台

GitHub Actions示例

在.github/workflows/build.yml中配置：

yaml
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 使用构建环境镜像
        uses: docker://[镜像名称]
        with:
          args: ./build.sh  # 项目中的构建脚本

GitLab CI示例

在.gitlab-ci.yml中配置：

yaml
build_job:
  image: [镜像名称]
  script:
    - ./build.sh  # 项目中的构建脚本
  stage: build

环境变量配置

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

示例（启用缓存并设置日志级别为debug）：

bash
docker run --rm -e LOG_LEVEL=debug -e CACHE_ENABLED=true -v $(pwd):/app -w /app ci-build-env ./build.sh

数据卷挂载

为确保构建产物可持久化或供后续流程使用，建议挂载项目目录和缓存目录：

bash
docker run --rm \
  -v $(pwd):/app \          # 挂载项目源代码目录
  -v ci-cache:/root/.cache  # 挂载缓存目录（可选，加速重复构建）
  -w /app \
  ci-build-env \
  ./build.sh

注意事项

• 该镜像为构建环境专用，不建议用于生产环境部署
• 若需支持特定工具或依赖，可基于此镜像通过Dockerfile扩展构建自定义镜像
• 定期更新镜像以获取最新的工具版本和安全修复