Jenkins Docker集成

Jenkins Docker集成

Jenkins Docker集成是指将Jenkins与Docker容器技术相结合，以实现更高效、可移植和可扩展的持续集成/持续交付（CI/CD）流程。通过Docker，Jenkins可以运行在容器化环境中，或管理容器化的构建和部署任务。

介绍

Docker是一种轻量级的容器化技术，允许开发者将应用程序及其依赖项打包到一个标准化的单元中。Jenkins作为流行的CI/CD工具，与Docker集成后可以带来以下优势：

• **环境一致性**：构建和测试在相同的容器环境中运行，避免“在我机器上能运行”的问题。
• **资源隔离**：每个构建任务在独立的容器中执行，互不干扰。
• **快速部署**：通过Docker镜像快速部署Jenkins本身或其构建代理。
• **可扩展性**：动态启动和销毁容器以应对构建负载变化。

Jenkins在Docker中运行

安装Docker

在开始之前，确保已在主机上安装Docker。以下是在Linux上安装Docker的命令：

# 更新包索引并安装依赖
sudo apt-get update
sudo apt-get install -y apt-transport-https ca-certificates curl software-properties-common

# 添加Docker官方GPG密钥
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

# 添加Docker仓库
sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu $(lsb_release -cs) stable"

# 安装Docker CE
sudo apt-get update
sudo apt-get install -y docker-ce

# 验证安装
sudo docker --version

输出示例：

Docker version 20.10.12, build e91ed57

运行Jenkins容器

使用官方Jenkins Docker镜像启动Jenkins服务器：

# 创建数据卷以持久化Jenkins数据
docker volume create jenkins_data

# 运行Jenkins容器
docker run -d \
  --name jenkins \
  -p 8080:8080 \
  -p 50000:50000 \
  -v jenkins_data:/var/jenkins_home \
  jenkins/jenkins:lts-jdk11

参数说明：

• `-d`：后台运行容器
• `--name`：指定容器名称
• `-p`：端口映射（8080为Web界面，50000为代理通信）
• `-v`：挂载数据卷

访问Jenkins

容器启动后，通过浏览器访问 `http://localhost:8080`。首次运行时需要解锁Jenkins：

# 获取初始管理员密码
docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword

在Jenkins中使用Docker

安装Docker插件

1. 登录Jenkins，导航到 **Manage Jenkins > Manage Plugins** 2. 在"Available"选项卡中搜索"Docker" 3. 安装"Docker"和"Docker Pipeline"插件

配置Docker Cloud

1. 导航到 **Manage Jenkins > Manage Nodes and Clouds** 2. 选择"Configure Clouds"，添加"Docker Cloud" 3. 配置Docker主机URI（通常是 `unix:///var/run/docker.sock`） 4. 测试连接并保存

使用Docker代理

可以配置Jenkins使用Docker容器作为动态构建代理。以下是Docker模板配置示例：

graph LR A[Jenkins Master] -->|请求构建| B[Docker Daemon] B --> C[创建容器] C --> D[执行构建] D --> E[销毁容器]

实际案例

案例1：构建Java应用

以下是一个使用Docker构建Java应用的Jenkinsfile示例：

pipeline {
    agent {
        docker {
            image 'maven:3.8.4-jdk-11'
            args '-v $HOME/.m2:/root/.m2'
        }
    }
    stages {
        stage('Build') {
            steps {
                sh 'mvn clean package'
            }
        }
    }
}

此配置： 1. 使用Maven官方镜像作为构建环境 2. 挂载本地Maven仓库缓存以加速构建 3. 在容器内执行Maven构建命令

案例2：多容器测试

对于需要数据库等服务的测试，可以使用`docker-compose`：

pipeline {
    agent any
    stages {
        stage('Test') {
            steps {
                script {
                    dockerCompose.build('docker-compose.yml')
                    dockerCompose.up('docker-compose.yml')
                    sh './run-tests.sh'
                    dockerCompose.down('docker-compose.yml')
                }
            }
        }
    }
}

高级主题

自定义Docker镜像

为特定项目创建自定义构建镜像：

FROM maven:3.8.4-jdk-11
COPY settings.xml /root/.m2/
RUN apt-get update && apt-get install -y python3

构建并推送镜像：

docker build -t my-org/build-agent:latest .
docker push my-org/build-agent:latest

安全考虑

• 限制容器资源（CPU、内存）
• 使用非root用户运行容器
• 定期更新基础镜像
• 扫描镜像中的漏洞

常见问题

权限问题

如果遇到Docker socket权限问题，可以将Jenkins用户加入docker组：

sudo usermod -aG docker jenkins

网络问题

容器间通信可能需要自定义Docker网络：

docker network create jenkins-net
docker run --network jenkins-net ...

总结

Jenkins与Docker集成提供了强大而灵活的CI/CD解决方案。通过容器化：

• 构建环境可版本化、可重现
• 资源利用率提高
• 支持更复杂的构建和测试场景
• 便于实现云原生部署

随着对Docker和Jenkins的深入理解，开发者可以构建更高效、可靠的自动化流水线。