Jenkins编译流水线Docker镜像文档

1. 镜像概述

本Docker镜像专为Jenkins CI/CD流水线设计，提供标准化的编译构建环境。通过整合主流开发语言的构建工具与运行时依赖，确保跨项目、跨环境的构建一致性，解决"环境差异导致构建失败"的常见问题，简化Jenkins流水线配置，提升自动化构建效率与可靠性。

2. 核心功能与特性

2.1 多语言构建支持

• 预集成主流构建工具：Maven 3.9.x、Gradle 8.5+、npm 18+、Yarn 4.x、Go 1.21+、Python 3.11+、Ruby 3.2+
• 支持Java、JavaScript/TypeScript、Go、Python、Ruby等多语言项目编译与打包

2.2 Jenkins无缝集成

• 兼容Jenkins Agent协议，可直接作为Jenkins Agent节点使用
• 支持Jenkins Pipeline语法，可通过agent { docker { image 'jenkins-compiler-pipeline:latest' } }直接调用
• 内置Jenkins工具路径自动配置，无需手动设置工具位置

2.3 环境标准化与一致性

• 基于Alpine Linux构建，体积轻量（基础镜像约800MB）
• 固定依赖版本，避免工具版本变更导致的构建波动
• 提供离线构建支持，内置常用依赖缓存机制

2.4 可定制化配置

• 支持通过环境变量调整构建参数
• 允许挂载外部缓存目录（如Maven/Gradle本地仓库）提升构建速度
• 提供扩展接口，可通过Dockerfile二次构建添加项目特定依赖

3. 使用场景与适用范围

3.1 典型应用场景

• 多团队协作项目的标准化构建环境
• 需要快速搭建CI/CD流水线的中小型项目
• 对构建环境一致性要求高的***、电商等核心业务系统
• 多语言混合开发的复杂项目构建流程

3.2 适用范围

• 基于Jenkins的自动化构建、测试、打包流程
• 需跨平台（如开发、测试、生产环境）保持一致构建结果的场景
• 资源受限环境下的轻量级CI/CD部署
• 教育或培训场景中标准化开发工具教学环境

4. 使用方法与配置说明

4.1 基础使用（本地测试）

4.1.1 拉取镜像

bash
docker pull jenkins-compiler-pipeline:latest

4.1.2 执行本地构建（以Maven项目为例）

bash
# 挂载当前项目目录到容器/app，执行mvn打包
docker run --rm \
  -v $(pwd):/app \
  -w /app \
  jenkins-compiler-pipeline:latest \
  mvn clean package -DskipTests

4.2 作为Jenkins Agent使用

4.2.1 Jenkins系统配置

1. 进入Jenkins管理页面 → 系统管理 → 节点管理 → 配置云
2. 添加Docker云，配置Docker API地址
3. 添加Agent模板：
   • 名称：compiler-agent
   • 镜像：jenkins-compiler-pipeline:latest
   • 远程文件系统根目录：/home/jenkins
   • 标签：compiler pipeline maven gradle node

4.2.2 Jenkinsfile示例（Pipeline语法）

groovy
pipeline {
  agent {
    docker {
      image 'jenkins-compiler-pipeline:latest'
      reuseNode true
    }
  }
  stages {
    stage('Build') {
      steps {
        sh 'npm install'       // 前端项目依赖安装
        sh 'npm run build'     // 前端构建
        sh 'mvn clean package' // 后端项目打包
      }
    }
    stage('Test') {
      steps {
        sh 'mvn test'          // 运行单元测试
      }
    }
  }
  post {
    success {
      archiveArtifacts artifacts: 'target/*.jar', fingerprint: true
    }
  }
}

4.3 Docker Compose集成（本地模拟Jenkins环境）

yaml
version: '3.8'
services:
  jenkins:
    image: jenkins/jenkins:lts
    ports:
      - "8080:8080"
    volumes:
      - jenkins_home:/var/jenkins_home
      - /var/run/docker.sock:/var/run/docker.sock
    environment:
      - JAVA_OPTS=-Djenkins.install.runSetupWizard=false
  
  compiler-agent:
    image: jenkins-compiler-pipeline:latest
    volumes:
      - maven_cache:/root/.m2
      - npm_cache:/root/.npm
    command: sleep infinity  # 保持容器运行供Jenkins连接

volumes:
  jenkins_home:
  maven_cache:  # Maven本地仓库缓存
  npm_cache:    # npm缓存

4.4 环境变量配置

4.5 高级配置：自定义工具版本

如需使用特定版本的构建工具，可通过Dockerfile二次构建：

dockerfile
FROM jenkins-compiler-pipeline:latest

# 安装特定版本Maven
RUN apk add --no-cache wget \
  && wget [***] -P /tmp \
  && tar -zxvf /tmp/apache-maven-3.8.8-bin.tar.gz -C /usr/local \
  && ln -sf /usr/local/apache-maven-3.8.8/bin/mvn /usr/local/bin/mvn \
  && rm -rf /tmp/*

5. 注意事项

• 首次运行可能因依赖缓存下载导致构建时间较长，建议挂载缓存目录（如-v $HOME/.m2:/root/.m2）
• 生产环境建议使用固定版本标签（如:1.2.0）而非:latest，确保构建稳定性
• 如需支持更多构建工具，可通过提交Issue或PR参与镜像扩展
• 镜像默认使用root用户运行，生产环境可通过--user参数指定非特权用户