Jenkins安装部署（以及常见报错解决方案），jdk版本控制器sdkman

目录

零、环境介绍

一、Jenkins安装

1、插件安装以及更换插件源

 2、修改jenkins时区

二、sdkman安装（可选）

1、sdkman常用方法

2、sdkman常用方法演示

2.1、查看可用的jdk

2.2、下载jdk并切换版本

三、jenkins报错解决

1、下载sdkman后systemctl启动失败

2、 其他可能的报错

2.1、端口占用问题

2.2、用户名问题

2.3、版本兼容性问题

2.4、 防火墙问题

2.5、权限问题

零、环境介绍

安装之前先调整防火墙：

jenkins官网给的防火墙策略：

YOURPORT=8080
PERM="--permanent"
SERV="$PERM --service=jenkins"

firewall-cmd $PERM --new-service=jenkins
firewall-cmd $SERV --set-short="Jenkins ports"
firewall-cmd $SERV --set-description="Jenkins port exceptions"
firewall-cmd $SERV --add-port=$YOURPORT/tcp
firewall-cmd $PERM --add-service=jenkins
firewall-cmd --zone=public --add-service=http --permanent
firewall-cmd --reload

嫌麻烦直接关掉防火墙也行：

sudo systemctl stop firewalld
sudo systemctl disable firewalld

一、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-2023.key
sudo yum upgrade
# Add required dependencies for the jenkins package
sudo yum install fontconfig java-17-openjdk
sudo yum install jenkins
sudo systemctl daemon-reload
sudo systemctl start jenkins
sudo systemctl enable jenkins
sudo systemctl status jenkins

顺利安装完成的话，执行systemctl status jenkins显示以下结果：

查看jenkins版本

 在浏览器输入：http://192.168.240.11:8080

 管理员密码在红色的提示文件当中，填入你自己的密码

cat /var/lib/jenkins/secrets/initialAdminPassword

 安装推荐的插件，如果嫌慢也可以离线导入。

等待安装完成。

1、插件安装以及更换插件源

依次点击Dashboard--> 系统管理--> 插件管理

在底部填写国内的jenkins插件源

https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json

 提交后重启jenkins，会提示有可更新的插件，将这些插件更新，最后显示No updates available。

 2、修改jenkins时区

 依次点击Dashboard -->系统管理--> Script Console

 填入以下内容，底部运行结果显示Result: Asia/Shanghai

 System.setProperty('org.apache.commons.jelly.tags.fmt.timeZone', 'Asia/Shanghai')

二、sdkman安装（可选）

sdk官方下载网址

yum install -y tar
curl -s "https://get.sdkman.io" | bash
source "$HOME/.sdkman/bin/sdkman-init.sh"
sdk version

查看sdk版本，检验是否下载完毕：

1、sdkman常用方法

sdkman官方使用指南

• 查看SKDMAN版本号： sdk version
• 列出可用的SDK列表： sdk list
• 安装特定的SDK： sdk install <sdk-name> <version>，例如，安装Java 8： sdk install java 8.0.292.hs-adpt
• 切换SDK版本： sdk use <sdk-name> <version>，例如，切换到Java 9： sdk use java 9.0.7-zulu
• 设置默认的SDK版本： sdk default <sdk-name> <version>，例如，设置Java 8为默认版本： sdk default java 8.0.292.hs-adpt
• 卸载SDK： sdk uninstall <sdk-name> <version>，例如，卸载Java 9： sdk uninstall java 9.0.7-zulu
• 更新SDKMAN： sdk upgrade
• 清除旧版本的SDK： sdk flush archives sdk flush temp

以上为SDKMAN的基本使用命令，如果想要更多指令，可以输入sdk help来查看全部的指令内容。

2、sdkman常用方法演示

2.1、查看可用的jdk

sdk list java

下载java 17.0.14-zulu

下载之前，先看看Java二进制文件所在路径

which java

 [root@openEuler-1 ~]# which java
/usr/bin/java

 之所以查看这个路径，是因为安装了sdkman，并且切换jdk版本后，默认的java二进制文件路径会变更为/root/.sdkman/candidates/java/current/bin/java，稍后验证。

2.2、下载jdk并切换版本

sdk install  java 17.0.14-zulu

查看jdk版本

java -version

[root@openEuler-1 ~]# java -version
openjdk version "17.0.14" 2025-01-21 LTS
OpenJDK Runtime Environment Zulu17.56+15-CA (build 17.0.14+7-LTS)
OpenJDK 64-Bit Server VM Zulu17.56+15-CA (build 17.0.14+7-LTS, mixed mode, sharing)

初次下载会自动切换，现在我的机器jdk版本由17.0.11变为17.0.14

三、jenkins报错解决

1、下载sdkman后systemctl启动失败

我们刚才切换了jdk版本后，虽然jdk版本由17.0.11变为17.0.14，但是同为jdk-17，应该不会出错

尝试重启Jenkins，发现的确没有出错。

但是，有时编译安装jdk后，再下载sdkman，可能会有如下报错：

关键提示：Unit jenkins.service not found

 意思是jenkins服务单元没有找到，原因是因为systemctl启动时调用的jenkins.service文件在/usr/lib/systemd/system目录下，无法调用/etc/init.d/下的jenkins。所以如果遇到服务方式无法启动jenkins，则需要修改jenkins.service来进行适配：

vim /usr/lib/systemd/system/jenkins.service

添加或者去掉注释修改以下内容：

Environment="JAVA_HOME=/root/.sdkman/candidates/java/current/bin/java"

 添加的内容其实就是，sdkman给我们修改的java二进制文件路径

重载并重启jenkins发现错误解决了：

systemctl daemon-reload
systemctl start jenkins
systemctl status jenkins

2、 其他可能的报错

2.1、端口占用问题

查看/etc/sysconfig/jenkins的JENKINS_PORT="8080”或者/usr/lib/systemd/system/jenkins.service的Environment="JENKINS_PORT=8080"

grep -i jenkins_port= /usr/lib/systemd/system/jenkins.service
ps -aux | grep 8080

vim /usr/lib/systemd/system/jenkins.service

把/usr/lib/systemd/system/jenkins.service的Environment="JENKINS_PORT=8080"改为你当前linux空闲的端口，然后重启jenkins

systemctl daemon-reload
systemctl start jenkins.service
systemctl stop jenkins.service
systemctl status jenkins.service

2.2、用户名问题

 查看/etc/sysconfig/jenkins或者/usr/lib/systemd/system/jenkins.service的JENKINS_USER="root"，如果不是root，而是jenkins或者其它，要改成root。或者相反操作。

vim /usr/lib/systemd/system/jenkins.service
User=root
Group=root
systemctl daemon-reload
systemctl start jenkins.service
systemctl stop jenkins.service
systemctl status jenkins.service

2.3、版本兼容性问题

检查当前的jdk版本是否对应jenkins版本，不符合兼容性就切换jdk到对应版本。如何选择jdk版本或者jenkins版本参考jenkins官方文档：

Java Support Policy

2.4、 防火墙问题

文章开头已经讲过了，如果开始放行的是8080端口，你后面又改为了其他端口，自己配置对应的防火墙策略即可。

2.5、权限问题

如果使用jenkins用户和jenkins组的身份来启动jenkins服务，有可能因为jenkins用户的权限低而不能读取有关文件而导致启动失败，我们给jenkins用户提权即可。

echo "jenkins ALL=(ALL) NOPASSWD: ALL" >> /etc/sudoers
sudo chown -R jenkins:jenkins /var/lib/jenkins
sudo chown jenkins:jenkins /usr/share/java/jenkins.war

不同版本的路径可能不同，可以使用find找出。