1. 项目概述
在当今的软件开发领域，持续集成和持续交付(CI/CD)已经成为提升团队效率的标配。作为一名经历过无数次手动部署痛苦的老兵，我深刻体会到自动化部署的价值。本文将分享如何利用Jenkins和Docker这对黄金组合搭建完整的CI/CD流水线。
这个方案特别适合中小型团队，它能将原本需要数小时的部署过程缩短到几分钟内完成。我们团队在使用这套方案后，部署频率从每周一次提升到每天多次，而部署失败率却降低了80%。
2. 环境准备与安装
2.1 Docker环境搭建
首先需要在服务器上安装Docker引擎。我推荐使用官方安装脚本，它能自动检测系统版本并安装合适的Docker版本：
curl -fsSL https://get.docker.com | sh安装完成后，记得将当前用户加入docker组以避免每次都要sudo：
sudo usermod -aG docker $USER注意：修改用户组后需要重新登录才能生效
国内用户建议配置镜像加速器，这里以阿里云为例：
sudo mkdir -p /etc/docker sudo tee /etc/docker/daemon.json <<-'EOF' { "registry-mirrors": ["https://<你的ID>.mirror.aliyuncs.com"] } EOF sudo systemctl daemon-reload sudo systemctl restart docker2.2 Jenkins容器化部署
传统方式安装Jenkins需要配置Java环境等各种依赖，而使用Docker可以一键搞定：
docker run -d \ --name jenkins \ -p 8080:8080 \ -p 50000:50000 \ -v jenkins_home:/var/jenkins_home \ jenkins/jenkins:lts-jdk11这个命令做了以下几件事：
- 使用官方LTS版本的Jenkins镜像
- 映射8080端口用于Web访问
- 映射50000端口用于agent连接
- 创建数据卷持久化Jenkins配置
首次启动后，需要通过日志获取初始密码：
docker logs jenkins在日志中找到类似这样的行：
Jenkins initial setup is required. An admin user has been created and a password generated. Please use the following password to proceed to installation: xxxxxxxxxxxxxxxxxxxxxx3. Jenkins基础配置
3.1 初始化设置
访问http://服务器IP:8080，输入刚才获取的密码完成初始化。我建议选择"安装推荐插件"，这会包含最常用的插件如Git、Pipeline等。
创建管理员账户时，务必使用强密码并妥善保存。我们团队曾经因为使用简单密码导致被入侵，造成了不小损失。
3.2 关键插件安装
除了默认插件外，还需要安装以下关键插件：
- Docker Pipeline：用于在Pipeline中操作Docker
- Blue Ocean：提供更直观的流水线视图
- SonarQube Scanner（可选）：代码质量分析
- Email Extension：邮件通知
提示：国内用户可能会遇到插件下载慢的问题，可以更换为清华镜像源：
- 进入"Manage Jenkins" → "Manage Plugins" → "Advanced"
- 在"Update Site"中将URL替换为： https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json
- 点击"Submit"后立即生效
3.3 系统配置
在"Manage Jenkins" → "Configure System"中，有几个关键配置：
- 设置系统管理员邮箱，用于发送通知
- 配置Docker Cloud（后续会详细介绍）
- 设置全局环境变量，如：
- DOCKER_HOST=tcp://localhost:2375
- JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64
4. Docker与Jenkins集成
4.1 Docker-in-Docker方案
为了让Jenkins能够使用Docker命令，有几种方案可选。经过多次实践，我发现最稳定的是Docker-in-Docker（DinD）：
docker run -d \ --name jenkins \ -p 8080:8080 \ -p 50000:50000 \ -v jenkins_home:/var/jenkins_home \ -v /var/run/docker.sock:/var/run/docker.sock \ jenkins/jenkins:lts-jdk11关键点是挂载docker.sock文件，这使得容器内的Jenkins可以直接调用宿主机的Docker引擎。
安全提示：这种方案有潜在安全风险，仅建议在可信环境中使用。生产环境应考虑更安全的方案，如使用Jenkins Agent。
4.2 测试Docker集成
创建一个测试Pipeline任务，使用以下脚本验证Docker是否可用：
pipeline { agent any stages { stage('Test Docker') { steps { script { docker.image('alpine').inside { sh 'echo "Hello from Docker!"' } } } } } }如果看到"Hello from Docker!"输出，说明集成成功。
5. 构建第一个CI/CD流水线
5.1 基础流水线设计
我们来创建一个完整的Java项目CI/CD流程，包含以下阶段：
- 代码检出
- 代码质量检查（SonarQube）
- 单元测试
- 构建Jar包
- 构建Docker镜像
- 推送镜像到仓库
- 部署到测试环境
对应的Jenkinsfile如下：
pipeline { agent any environment { DOCKER_REGISTRY = 'your-registry.com' PROJECT_NAME = 'my-java-app' VERSION = "${env.BUILD_NUMBER}" } stages { stage('Checkout') { steps { git branch: 'main', url: 'https://github.com/your-repo.git' } } stage('SonarQube Analysis') { steps { withSonarQubeEnv('sonarqube-server') { sh 'mvn sonar:sonar' } } } stage('Test') { steps { sh 'mvn test' } } stage('Build') { steps { sh 'mvn package -DskipTests' } } stage('Build Docker Image') { steps { script { docker.build("${DOCKER_REGISTRY}/${PROJECT_NAME}:${VERSION}") } } } stage('Push Image') { steps { script { docker.withRegistry('https://${DOCKER_REGISTRY}', 'docker-registry-creds') { docker.image("${DOCKER_REGISTRY}/${PROJECT_NAME}:${VERSION}").push() } } } } stage('Deploy to Test') { steps { sshagent(['test-server-creds']) { sh """ ssh user@test-server " docker pull ${DOCKER_REGISTRY}/${PROJECT_NAME}:${VERSION} && \ docker stop ${PROJECT_NAME} || true && \ docker rm ${PROJECT_NAME} || true && \ docker run -d --name ${PROJECT_NAME} -p 8080:8080 ${DOCKER_REGISTRY}/${PROJECT_NAME}:${VERSION} " """ } } } } }5.2 凭证管理
流水线中使用了多种凭证，需要在Jenkins中提前配置：
- Git仓库凭证：在"Credentials" → "System" → "Global credentials"中添加
- Docker仓库凭证：同上，选择"Username with password"类型
- SSH部署凭证：添加SSH私钥用于服务器部署
经验分享：建议为不同环境使用不同的凭证，并严格控制权限。我们曾经因为测试环境凭证被误用于生产环境导致事故。
6. 高级技巧与优化
6.1 使用Docker Compose部署
对于复杂应用，建议使用Docker Compose管理服务。可以在部署阶段这样做：
stage('Deploy with Compose') { steps { sshagent(['prod-server-creds']) { sh """ scp docker-compose.yml user@prod-server:/app/ ssh user@prod-server " cd /app && \ docker-compose pull && \ docker-compose down && \ docker-compose up -d " """ } } }6.2 多阶段构建优化
利用Docker的多阶段构建可以显著减小镜像大小。示例Dockerfile：
FROM maven:3.8.4-jdk-11 AS builder WORKDIR /app COPY . . RUN mvn package FROM openjdk:11-jre-slim WORKDIR /app COPY --from=builder /app/target/*.jar app.jar EXPOSE 8080 ENTRYPOINT ["java","-jar","app.jar"]6.3 流水线并行执行
对于大型项目，可以并行执行测试和构建以节省时间：
stage('Parallel Stages') { parallel { stage('Unit Test') { steps { sh 'mvn test' } } stage('Integration Test') { steps { sh 'mvn verify -DskipUnitTests' } } } }7. 常见问题排查
7.1 Docker连接问题
错误：Cannot connect to the Docker daemon
解决方案：
- 确保容器内已挂载docker.sock
- 检查docker.sock权限：
ls -l /var/run/docker.sock - 在容器内安装Docker客户端：
apt-get update && apt-get install -y docker-ce-cli
7.2 构建缓存问题
现象：代码已更新但构建仍使用旧代码
解决方法：
- 在docker build时添加
--no-cache参数 - 或者使用
docker system prune清理缓存
7.3 资源不足问题
错误：Container killed due to memory usage
解决方法：
- 增加Docker内存限制
- 优化构建过程，如使用
.dockerignore排除不必要的文件 - 在Jenkins中设置构建超时和资源限制
8. 监控与日志
完善的监控是CI/CD的重要部分。建议：
- 配置构建失败通知（邮件/Slack）
- 使用ELK或Grafana收集和分析日志
- 设置构建健康指标，如：
- 构建成功率
- 平均构建时间
- 测试覆盖率趋势
一个简单的日志收集配置示例：
post { always { archiveArtifacts artifacts: '**/target/*.log', allowEmptyArchive: true junit '**/target/surefire-reports/*.xml' } failure { emailext body: '构建失败: ${BUILD_URL}', subject: '构建失败: ${JOB_NAME}', to: 'team@example.com' } }在实际使用中，我发现这套方案最大的价值在于它的灵活性。你可以根据项目需求自由组合各个阶段，比如前端项目可以加入npm构建和SonarJS分析，Python项目可以加入pytest和pylint检查。关键是要建立适合团队工作流程的标准化流程，而不是盲目追求复杂的工具链。
)
 agent和组件)