Jenkins+Docker+Harbor快速部署Spring Boot项目详解

Jenkins、Docker和Harbor是现代DevOps流程中的核心工具，结合使用可以实现自动化构建、测试和部署。下面我将详细介绍如何搭建这个集成环境。

一、各工具的核心作用

1. Jenkins

   • 自动化CI/CD工具，负责拉取代码、编译、测试、构建Docker镜像并部署
   • 提供可视化界面管理Pipeline

2. Docker

   • 容器化平台，将应用及其依赖打包成独立容器
   • 确保环境一致性，提高部署效率

3. Harbor

   • 企业级Docker镜像仓库，存储和管理Docker镜像
   • 支持权限控制、镜像复制、安全扫描等功能

二、环境准备

1. 服务器规划

   • Jenkins服务器：2核4G+，用于运行Jenkins服务
   • Harbor服务器：4核8G+，用于存储Docker镜像
   • 应用服务器：根据项目需求配置，运行Docker容器

2. 软件安装

   • 在所有服务器安装Docker：

     curl -fsSL https://get.docker.com | bash
     systemctl enable docker && systemctl start docker
     

   • 在Jenkins服务器安装Docker Compose：

     curl -L "https://github.com/docker/compose/releases/download/v2.16.0/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
     chmod +x /usr/local/bin/docker-compose
     

三、Harbor安装与配置

1. 下载并解压Harbor

   wget https://github.com/goharbor/harbor/releases/download/v2.8.3/harbor-offline-installer-v2.8.3.tgz
   tar xvf harbor-offline-installer-v2.8.3.tgz -C /opt/
   cd /opt/harbor
   

2. 配置Harbor

   cp harbor.yml.tmpl harbor.yml
   vi harbor.yml
   

   修改以下关键配置：

   hostname: harbor.example.com  # 修改为你的域名或IP
   http:
     port: 80
   harbor_admin_password: Harbor12345  # 管理员密码
   data_volume: /data/harbor  # 数据存储路径
   

3. 生成证书（可选，推荐使用HTTPS）

   mkdir -p /data/cert
   openssl req -newkey rsa:4096 -nodes -sha256 -keyout /data/cert/harbor.key -x509 -days 365 -out /data/cert/harbor.crt
   

   更新harbor.yml启用HTTPS：

   https:
     port: 443
     certificate: /data/cert/harbor.crt
     private_key: /data/cert/harbor.key
   

4. 安装Harbor

   ./install.sh
   

5. 验证Harbor

   • 访问http://harbor.example.com
   • 使用admin/Harbor12345登录

四、Jenkins安装与配置

1. 使用Docker安装Jenkins

   mkdir -p /data/jenkins_home
   chown -R 1000:1000 /data/jenkins_home  # Jenkins用户UID为1000
   
   docker run -d \
     --name jenkins \
     -p 8080:8080 \
     -p 50000:50000 \
     -v /data/jenkins_home:/var/jenkins_home \
     -v /var/run/docker.sock:/var/run/docker.sock \
     -v $(which docker):/usr/bin/docker \
     jenkins/jenkins:lts
   

2. 初始化Jenkins

   • 访问http://jenkins-server:8080
   • 获取初始密码：

     docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword
     

   • 安装推荐插件，创建管理员账号

3. 安装必要插件

   • Docker Pipeline
   • Pipeline
   • Git
   • Credentials Plugin

五、Jenkins与Harbor集成

1. 在Jenkins中添加Harbor凭证

   • 进入Jenkins → 凭据 → 系统 → 全局凭据
   • 添加用户名密码凭证，用户名和密码为Harbor的账号密码

2. 配置Docker Host

   • 进入Jenkins → 管理Jenkins → 系统设置 → Docker
   • 添加Docker Host：unix:///var/run/docker.sock

六、Spring Boot项目配置

1. 添加Dockerfile
   在Spring Boot项目根目录下创建Dockerfile：

   FROM openjdk:17-jdk-slim
   VOLUME /tmp
   ARG JAR_FILE=target/*.jar
   COPY ${JAR_FILE} app.jar
   ENTRYPOINT ["java","-jar","/app.jar"]
   

2. 添加Jenkinsfile
   在项目根目录添加Jenkinsfile：

   pipeline {
       agent any
       
       environment {
           DOCKER_IMAGE = "harbor.example.com/devops/spring-boot-demo"
           DOCKER_TAG = "${env.BUILD_NUMBER}"
           HARBOR_CREDS = credentials('harbor-credentials')
       }
       
       stages {
           stage('Build') {
               steps {
                   sh 'mvn clean package -DskipTests'
               }
           }
           
           stage('Build Docker Image') {
               steps {
                   sh "docker build -t $DOCKER_IMAGE:$DOCKER_TAG ."
               }
           }
           
           stage('Push to Harbor') {
               steps {
                   sh "docker login -u $HARBOR_CREDS_USR -p $HARBOR_CREDS_PSW harbor.example.com"
                   sh "docker push $DOCKER_IMAGE:$DOCKER_TAG"
                   sh "docker tag $DOCKER_IMAGE:$DOCKER_TAG $DOCKER_IMAGE:latest"
                   sh "docker push $DOCKER_IMAGE:latest"
               }
           }
           
           stage('Deploy') {
               steps {
                   sh """
                   ssh user@deploy-server << EOF
                   docker login -u $HARBOR_CREDS_USR -p $HARBOR_CREDS_PSW harbor.example.com
                   docker stop spring-boot-demo || true
                   docker rm spring-boot-demo || true
                   docker run -d --name spring-boot-demo -p 8080:8080 $DOCKER_IMAGE:$DOCKER_TAG
                   EOF
                   """
               }
           }
       }
   }
   

七、Jenkins Pipeline配置

1. 创建新Pipeline项目

   • 进入Jenkins → 新建任务 → 输入名称 → 选择Pipeline → 确定

2. 配置Pipeline

   • 进入项目配置 → Pipeline部分
   • 定义方式选择"Pipeline script from SCM"
   • SCM选择Git，填写项目Git仓库地址
   • 指定Jenkinsfile路径

八、关键配置说明

1. Harbor关键配置

   • harbor.yml中的hostname必须正确配置
   • 生产环境建议启用HTTPS
   • 可配置磁盘配额和垃圾回收策略

2. Jenkins关键配置

   • 确保Jenkins用户有访问Docker的权限
   • 正确配置Harbor凭证
   • 确保Jenkins服务器可以SSH到部署服务器

3. Jenkinsfile关键参数

   • DOCKER_IMAGE：镜像名称，格式为Harbor地址/项目名/镜像名
   • DOCKER_TAG：建议使用构建号或Git提交哈希
   • HARBOR_CREDS：Harbor凭证ID

九、优化建议

1. 添加测试阶段
   在Build阶段后添加测试步骤：

   stage('Test') {
       steps {
           sh 'mvn test'
       }
       post {
           always {
               junit 'target/surefire-reports/*.xml'
           }
       }
   }
   

2. 使用Docker Compose部署
   创建docker-compose.yml并使用它部署：

   version: '3'
   services:
     spring-boot-demo:
       image: harbor.example.com/devops/spring-boot-demo:${BUILD_NUMBER}
       ports:
         - "8080:8080"
       environment:
         - SPRING_PROFILES_ACTIVE=prod
   

3. 添加质量检测
   集成SonarQube进行代码质量检测：

   stage('Code Quality') {
       steps {
           sh 'mvn sonar:sonar'
       }
   }
   

十、故障排除

1. Docker连接问题

   • 确保Jenkins容器可以访问宿主机的Docker daemon
   • 检查/var/run/docker.sock权限

2. Harbor认证失败

   • 检查Harbor凭证配置是否正确
   • 确保Harbor服务器可以访问
   • 如果使用HTTPS，确保证书已正确配置

3. 部署失败

   • 检查部署服务器SSH配置
   • 确保部署服务器可以访问Harbor
   • 检查容器运行日志：docker logs spring-boot-demo