自动化部署-01-jenkins安装

---

前言

spingcloud微服务等每次部署到服务器上，都需要本地编译打包，然后将打好的包上传到服务器再启动。这样比较麻烦。我们可以使用自动化部署，自动在服务器上部署新代码。
jenkins部署版本是：2.462.3
我是使用的部署skywalking的虚拟机10.211.55.120，已经装好了open-jdk-21.0.2，但这个jdk版本安装jenkins有点问题。

---

一、下载安装

参考文档：
https://www.jenkins.io/doc/book/installing/linux/
https://pkg.jenkins.io/redhat-stable/

我的虚拟机是CentOS系统，所以执行：

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
#安装
yum install jenkins

以下是详情

[root@localhost config]# sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo
--2024-10-24 16:58:31--  https://pkg.jenkins.io/redhat-stable/jenkins.repo
Resolving pkg.jenkins.io (pkg.jenkins.io)... 151.101.194.133, 151.101.66.133, 151.101.130.133, ...
Connecting to pkg.jenkins.io (pkg.jenkins.io)|151.101.194.133|:443... connected.
HTTP request sent, awaiting response... 200 OK
Length: 85
Saving to: ‘/etc/yum.repos.d/jenkins.repo’/etc/yum.repos.d/jenkins.repo                 100%[==============================================================================================>]      85  --.-KB/s    in 0s      2024-10-24 16:58:33 (200 KB/s) - ‘/etc/yum.repos.d/jenkins.repo’ saved [85/85][root@localhost config]# sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io-2023.key
[root@localhost config]# yum install jenkins
Jenkins-stable                                                                                                                                       8.0 kB/s |  29 kB     00:03    
Dependencies resolved.
=====================================================================================================================================================================================Package                                   Architecture                             Version                                          Repository                                 Size
=====================================================================================================================================================================================
Installing:jenkins                                   noarch                                   2.462.3-1.1                                      jenkins                                    89 MTransaction Summary
=====================================================================================================================================================================================
Install  1 PackageTotal download size: 89 M
Installed size: 89 M
Is this ok [y/N]: y
Downloading Packages:
jenkins-2.462.3-1.1.noarch.rpm                                                                                                                       4.6 MB/s |  89 MB     00:19    
-------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------
Total                                                                                                                                                4.6 MB/s |  89 MB     00:19     
Running transaction check
Transaction check succeeded.
Running transaction test
Transaction test succeeded.
Running transactionPreparing        :                                                                                                                                                             1/1 Running scriptlet: jenkins-2.462.3-1.1.noarch                                                                                                                                  1/1 Installing       : jenkins-2.462.3-1.1.noarch                                                                                                                                  1/1 Running scriptlet: jenkins-2.462.3-1.1.noarch                                                                                                                                  1/1 Verifying        : jenkins-2.462.3-1.1.noarch                                                                                                                                  1/1 Installed:jenkins-2.462.3-1.1.noarch                                                                                                                                                         Complete!

二、启动

执行：

sudo systemctl daemon-reload
sudo systemctl start jenkins

按照官方文档此时应该可以启动成功。

三、问题

3.1 jdk版本问题

解决：
1.下载jdk17版本，比如解压到/opt/java17目录。
2.修改jenkins启动脚本：

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

修改Java home directory

3.2 端口冲突

因为skywalking的端口也是8080，所以修改jenkins的启动端口。
解决：
1.修改jenkins启动脚本：

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

修改JENKINS_PORT

3.3 库文件加载问题

执行

#通过包管理工具（根据系统使用不同的命令）来安装 libfreetype6 依赖库
sudo yum install freetype
#安装完成后，验证 libfreetype 是否正确安装
ldd /opt/java17/lib/libfontmanager.so | grep freetype#如果出现
ldd: warning: you do not have execution permission for `/opt/java17/lib/libfontmanager.so'libfreetype.so.6 => /lib64/libfreetype.so.6 (0x00007fd778362000)#再执行
sudo chmod +x /opt/java17/lib/libfontmanager.so
#是否还存在权限警告
ldd /opt/java17/lib/libfontmanager.so | grep freetype

3.4 系统字体配置问题

解决：

#安装必要的字体：Java应用程序通常依赖于fontconfig中的字体来正确渲染图形组件。在Linux系统中，可以通过以下命令安装一些基础字体
sudo yum install fontconfig dejavu-sans-fonts
#重新生成字体缓存：安装字体后，建议重新生成字体缓存，以确保更改生效
sudo fc-cache -fv
#确保Jenkins可以访问字体：确保Jenkins进程有访问字体和相关配置文件的权限。你可以通过以下命令查看是否能够列出系统中的字体
fc-list

四、再次启动

systemctl start jenkins

如果出现

就执行：

journalctl -xeu jenkins.service

发现日志正常，没有错误。
注意其中的密码

Oct 25 08:52:09 localhost.localdomain jenkins[61917]: Jenkins initial setup is required. An admin user has been created and a password generated.
Oct 25 08:52:09 localhost.localdomain jenkins[61917]: Please use the following password to proceed to installation:
Oct 25 08:52:09 localhost.localdomain jenkins[61917]: dc63794d88ba4141bd7b5ee928bca97b
Oct 25 08:52:09 localhost.localdomain jenkins[61917]: This may also be found at: /var/lib/jenkins/secrets/initialAdminPassword

再执行：

systemctl status jenkins

发现启动成功。

五、配置jenkins

浏览器打开：http://10.211.55.120:8089

5.1 解锁

输入上面日志中的密码后

5.2 安装插件

建议选择插件来安装，因为安装插件超慢，不如项目先启动起来后，通过别的方法下载安装插件。

5.3 创建管理员用户

5.4 实例配置

5.5 开始使用

5.6 完成

---

总结

后续使用jenkins实现自动化。