Jenkins
Jenkins
1 Jenkins
Jenkins 说明
- Jenkins 官网
- Jenkins war-stable 资源
- Jenkins 离线安装
- 环境,以 Jinken 2.479 版本为例说明。
- Jenkins war 包 下载地址。
- Jdk 17。必须,该版本最低要求,安装步骤略。
- Jetty 11 or later。可选,看部署方式,有内置容器支持。
- OS:CentOS 7。
CentOS7.9 在线安裝 Jenkins
参考如下。
wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key
# jdk 安装好
yum install jenkins
# 此时直接启动会报错:Failed to start Jenkins Continuous Integration Server
# 是因为其不会使用 etc/init.d/jenkins,而是使用 /usr/lib/systemd/system/jenkins.service 文件,配置下文件内容
vim /usr/lib/systemd/system/jenkins.service
# jenkins 的账号、密码
User=root
Group=root
# JDK 路径
Environment="JAVA_HOME=/usr/local/jdk-17.0.15+6"
# 重新加载配置后启动
systemctl daemon-reload
systemctl start jenkins
systemctl status jenkins
# 浏览器访问 http://192.168.37.100:8080
# 首次进入会提示密码在这里 /root/.jenkins/secrets/initialAdminPassword,用这个文件的密码登录
注意:这里未安装插件。
CentOS7.9 war 方式部署安装
生成环境建议启动命令如下。
mkdir -p /var/jenkins/war /var/jenkins/plugins /var/log/jenkins
nohup java -jar jenkins.war --httpPort=9090 > /var/log/jenkins.log 2>&1 &
nohup java -jar jenkins.war \
--httpPort=9090 \
--webroot=/var/jenkins/war \
--pluginroot=/var/jenkins/plugins \
--logfile=/var/log/jenkins/jenkins.log \
> /var/log/jenkins/nohup.out 2>&1 &
注意:安装好插件后,系统重启,登录 Jenkins 首页会提示创建第一个管理员账号,我们都用 admin 即可。
Jenkins 插件安装指南(含加速源配置)
加速源配置
修改 Jenkins 更新中心配置。
- 访问 Jenkins 更新中心配置。
- 在"Update Site"部分修改 URL 为国内镜像。
# 华为云镜像源,镜像源为变化,可自行搜索最新可用源并替换
https://mirrors.huaweicloud.com/jenkins/updates/update-center.json
- 点击"Submit"保存。
1. 通过 Jenkins Web 界面安装(推荐新手)
- 访问 Jenkins 控制台。
- 在"Available"标签页搜索需要的插件
- 勾选插件并点击"Install without restart"
2. 通过 Jenkins CLI 安装
# 下载 jenkins-cli.jar
wget http://localhost:9090/jnlpJars/jenkins-cli.jar
# 安装插件示例
java -jar jenkins-cli.jar -s http://localhost:9090/ install-plugin git
3. 手动安装插件(.hpi 文件)
- 从 Jenkins 插件中心 下载 .hpi 文件
- 上传到 Jenkins
- 在"Upload Plugin"部分选择文件并上传
部署示例:Jenkins 部署 Gitee 上的 Spring Boot 项目完整指南
1. 环境准备
- 安装 Maven 3.9.10。
- 安装 Git。
- Jenkins 安装插件。
- Maven Integration - Maven 项目支持
- Git - Git 仓库支持
- Publish Over SSH - 远程部署支持
- JDK:
/usr/local/java/jdk-17.0.15+6
。 - Git:
/usr/bin/git
。 - MAVEN:
/usr/local/maven
- JDK:
2. 项目配置与部署
2.1 创建 Maven 项目
- 点击"新建任务" > 输入任务名称 > 选择"Maven项目"。
- 在"源码管理"部分。
- 2.1 选择"Git"
- 2.2 填写 Gitee 仓库 URL (如 https://gitee.com/shj.com/spring-boot-demo.git)
- 2.3 添加凭据(Gitee 账号密码或 SSH 密钥)
- 构建触发器配置,可以配置定时或钩子触发,可选。
- 构建配置。
- 4.1 在"Build"部分: Goals 填写: clean package -DskipTests
- 4.2 POM 文件: 通常为 pom.xml(如果是多模块项目需指定子模块 pom 路径)
- 4.3 Post Steps(构建后操作),新增 shell 命令,详细如下。
构建后操作命令。
# 停止旧服务
pkill -f hello.jar || true
# 备份旧版本
mv /opt/app/hello.jar /opt/app/backup/hello.jar.$(date +%Y%m%d%H%M%S) || true
# 复制新版本
cp target/hello.jar /opt/app/hello.jar
# 启动新服务,需要避免被 jenkins 杀死
BUILD_ID=dontKillMe nohup java -jar /opt/app/hello.jar > /opt/app/logs/hello.log 2>&1 &