从环境准备到自动发布的全流程,每个步骤都包含验证方法。请按照顺序操作:

一、服务器环境准备(以 CentOS 7 为例)

  1. 安装 JDK 和 Maven

安装 OpenJDK 11

sudo yum install -y java-11-openjdk-devel

安装 Maven

sudo yum install -y maven

验证安装

java -version # 应该显示 11.x
mvn -v # 应该显示 3.x

  1. 安装 Jenkins

添加 Jenkins 仓库

sudo wget -O /etc/yum.repos.d/jenkins.repo
https://pkg.jenkins.io/redhat-stable/jenkins.repo
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

安装 Jenkins

sudo yum install -y jenkins

启动服务

sudo systemctl start jenkins
sudo systemctl enable jenkins

查看初始密码

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

  1. 访问 Jenkins
    浏览器打开 http://你的服务器IP:8080,输入初始密码完成安装,选择安装推荐插件。

二、配置 Jenkins 连接 Gitee

  1. 生成 SSH 密钥(在服务器执行)
    ssh-keygen -t rsa -b 4096 -C “your_email@example.com”

全部按回车,生成默认密钥

cat ~/.ssh/id_rsa.pub # 复制输出的内容

  1. 将公钥添加到 Gitee

登录 Gitee → 右上角头像 → 设置 → SSH公钥
粘贴复制的公钥内容,标题填 Jenkins Server

  1. 在 Jenkins 添加 SSH 凭据

进入 Jenkins → 左侧菜单 Manage Jenkins → Manage Credentials
进入 System → Global credentials (unrestricted)
点击 Add Credentials,按以下配置:
类型:SSH Username with private key
ID:gitee_ssh(必须一致)
用户名:你的 Gitee 账户名
私有密钥:选择 Enter directly,粘贴 ~/.ssh/id_rsa 文件内容(使用 cat ~/.ssh/id_rsa 查看)

三、创建 Spring Boot 项目部署目录

  1. 在服务器创建目录
    sudo mkdir -p /data/app/myapp
    sudo chown -R jenkins:jenkins /data/app # 授权给 Jenkins 用户

  2. 创建部署脚本
    新建文件 /data/app/myapp/deploy.sh:
    #!/bin/bash
    APP_NAME=“myapp”
    JAR_PATH="/data/app/myapp/APPNAME−∗.jar"PID={APP_NAME}-*.jar" PID=APPN​AME−∗.jar"PID=(ps -ef | grep “$JAR_PATH” | grep -v grep | awk ‘{print $2}’)

停止旧进程

if [ -n “$PID” ]; then
echo “Stopping old process $PID…”
kill -9 $PID
fi

启动新进程

echo “Starting new application…”
nohup java -jar $JAR_PATH > ./nohup.log 2>&1 &

赋予执行权限:
chmod +x /data/app/myapp/deploy.sh

四、创建 Jenkins 自动化任务

  1. 安装必要插件
    进入 Manage Jenkins → Manage Plugins → Available plugins,搜索安装:

Gitee
Publish Over SSH
Pipeline

  1. 配置服务器连接
    进入 Manage Jenkins → Configure System,找到 Publish over SSH:

点击 Add:
Name: prod-server
Hostname: 服务器IP
Username: root(或您的服务器用户名)
Remote Directory: /data/app/myapp

在 Advanced 中:
勾选 Password Authentication
输入服务器密码

  1. 创建 Pipeline 任务

首页点击 New Item → 输入任务名 springboot-auto-deploy → 选择 Pipeline
在 Pipeline 标签页粘贴以下脚本:

pipeline {
agent any
stages {
// 阶段1:从Gitee拉取代码
stage(‘拉取代码’) {
steps {
git(
url: ‘git@gitee.com:你的用户名/仓库名.git’,
credentialsId: ‘gitee_ssh’,
branch: ‘master’
)
}
}

    // 阶段2:编译打包
    stage('项目构建') {
        steps {
            sh 'mvn clean package -DskipTests'
        }
    }
    
    // 阶段3:部署到服务器
    stage('部署服务') {
        steps {
            sshPublisher(
                publishers: [
                    sshPublisherDesc(
                        configName: 'prod-server',
                        transfers: [
                            sshTransfer(
                                sourceFiles: 'target/*.jar',
                                remoteDirectory: '',
                                execCommand: 'cd /data/app/myapp && ./deploy.sh'
                            )
                        ]
                    )
                ]
            )
        }
    }
}

}

五、设置 Gitee 自动触发(Webhook)

  1. 在 Jenkins 获取 Webhook 地址

进入任务配置 → Build Triggers → 勾选 Gitee webhook
记录显示的 URL(类似 http://IP:8080/gitee-project/…)和生成的密码

  1. 在 Gitee 配置 Webhook

进入仓库 → 管理 → WebHooks → 添加
填写:
URL: 上一步获得的 Jenkins URL
密码: Jenkins 生成的密码
触发事件: Push 事件

六、测试全流程

  1. 本地修改代码并推送

修改一个文件

echo “TEST” >> src/main/resources/application.properties
git add .
git commit -m “触发自动部署测试”
git push origin master

  1. 观察 Jenkins 自动构建

进入 Jenkins 任务页面,应该看到自动开始的构建
点击构建编号 → 查看 Console Output 确认无报错

  1. 验证服务是否更新

在服务器查看日志

tail -f /data/app/myapp/nohup.log

七、遇到问题怎么办?
问题1:Jenkins 无法克隆代码

检查:在 Jenkins 服务器执行 ssh -T git@gitee.com,应该返回欢迎信息
解决:重新生成 SSH 密钥并确保公钥正确添加到 Gitee

问题2:部署后服务未启动

检查:在服务器执行 ps -ef | grep java 查看进程
解决:手动运行 ./deploy.sh 查看报错信息

问题3:文件权限不足

检查:ls -l /data/app/myapp 查看文件属主
解决:执行 sudo chown -R jenkins:jenkins /data/app

通过以上步骤,你可以实现:代码提交到 Gitee → 自动触发 Jenkins 构建 → 部署到服务器 → 服务自动重启 的完整流程。建议首次成功后,尝试在代码中添加新接口并验证部署结果。

更多推荐