优易官方网站百度一下手机版首页
目录
零、环境介绍
一、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、权限问题
零、环境介绍
| Operating System | openEuler 22.03 (LTS-SP2) |
| Kernel | Linux 5.10.0-153.12.0.92.oe2203sp2.x86_64 |
| ip address | 192.168.240.11 |
| JDK version | jdk-17 |
| jenkins version | 2.479.3-1.1 |
安装之前先调整防火墙：
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.service2.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.service2.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找出。