jenkins + gitee码云搭建全自动发布流程
从环境准备到自动发布的全流程,每个步骤都包含验证方法。请按照顺序操作:
一、服务器环境准备(以 CentOS 7 为例)
- 安装 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
- 安装 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
- 访问 Jenkins
浏览器打开 http://你的服务器IP:8080,输入初始密码完成安装,选择安装推荐插件。
二、配置 Jenkins 连接 Gitee
- 生成 SSH 密钥(在服务器执行)
ssh-keygen -t rsa -b 4096 -C “your_email@example.com”
全部按回车,生成默认密钥
cat ~/.ssh/id_rsa.pub # 复制输出的内容
- 将公钥添加到 Gitee
登录 Gitee → 右上角头像 → 设置 → SSH公钥
粘贴复制的公钥内容,标题填 Jenkins Server
- 在 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 项目部署目录
-
在服务器创建目录
sudo mkdir -p /data/app/myapp
sudo chown -R jenkins:jenkins /data/app # 授权给 Jenkins 用户 -
创建部署脚本
新建文件 /data/app/myapp/deploy.sh:
#!/bin/bash
APP_NAME=“myapp”
JAR_PATH="/data/app/myapp/APPNAME−∗.jar"PID={APP_NAME}-*.jar" PID=APPNAME−∗.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 自动化任务
- 安装必要插件
进入 Manage Jenkins → Manage Plugins → Available plugins,搜索安装:
Gitee
Publish Over SSH
Pipeline
- 配置服务器连接
进入 Manage Jenkins → Configure System,找到 Publish over SSH:
点击 Add:
Name: prod-server
Hostname: 服务器IP
Username: root(或您的服务器用户名)
Remote Directory: /data/app/myapp
在 Advanced 中:
勾选 Password Authentication
输入服务器密码
- 创建 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)
- 在 Jenkins 获取 Webhook 地址
进入任务配置 → Build Triggers → 勾选 Gitee webhook
记录显示的 URL(类似 http://IP:8080/gitee-project/…)和生成的密码
- 在 Gitee 配置 Webhook
进入仓库 → 管理 → WebHooks → 添加
填写:
URL: 上一步获得的 Jenkins URL
密码: Jenkins 生成的密码
触发事件: Push 事件
六、测试全流程
- 本地修改代码并推送
修改一个文件
echo “TEST” >> src/main/resources/application.properties
git add .
git commit -m “触发自动部署测试”
git push origin master
- 观察 Jenkins 自动构建
进入 Jenkins 任务页面,应该看到自动开始的构建
点击构建编号 → 查看 Console Output 确认无报错
- 验证服务是否更新
在服务器查看日志
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 构建 → 部署到服务器 → 服务自动重启 的完整流程。建议首次成功后,尝试在代码中添加新接口并验证部署结果。
更多推荐


所有评论(0)