在 CentOS 8 系统上安装 Jenkins 的全过程

一、前言

我是一个前端开发，需要频繁将编写的前端系统打包更新到公司的linux服务器，觉得这种工作纯体力活，有时候太浪费时间，以前用过别人搭建的Jenkins可以很好的解决这个问题。

Jenkins 是一款流行的开源持续集成和持续交付（CI/CD）工具，以下是在 CentOS 8 系统上安装 Jenkins 的详细步骤：

二、安装 Java 环境

Jenkins 是用 Java 编写的工具。它的代码运行需要 Java 虚拟机来执行，就像汽车需要汽油才能跑一样，没有 Java 环境，Jenkins 无法工作。而且，Jenkins 凭借 Java“一次编写，到处运行”的特性，可以在多种操作系统上使用。同时，它的众多插件很多也是 Java 编写的，这些插件要在 Java 环境里才能正常运行，从而扩展 Jenkins的功能。

1、查看系统信息

执行命令 cat /etc/os-release，确认系统为 CentOS 8，以便后续选择合适的安装包和配置步骤。

cat /etc/os-release

2、查看系统 Java 环境

1. 分别执行以下命令查看系统中是否已安装 Java 相关组件：

rpm -qa | grep java：此命令用于查找已安装的所有与 “java” 相关的 RPM 包，可能会列出一些 Java 运行时环境或开发工具包的信息。

rpm -qa | grep jdk：专门查找已安装的 JDK（Java Development Kit）包。

rpm -qa | grep gcj：检查是否安装了 GNU Java 编译器（GNU Compiler for Java）相关组件。

2. 如果系统中存在旧版本的 Java，并且你打算安装新的 Java 版本，可使用以下命令卸载旧版本：

rpm -qa | grep java | xargs rpm -e --nodeps：这会卸载所有通过 RPM 安装的与 “java” 相关的包，--nodeps 选项表示忽略包之间的依赖关系，强制卸载。不过使用此选项时需谨慎，确保不会影响其他正在运行的关键系统服务或应用程序。
rpm -qa | grep jdk | xargs rpm -e --nodeps：专门卸载已安装的 JDK 包。

3、安装 Java 环境

1. 配置 yum 镜像源：

首先进入 /etc/yum.repos.d/ 目录，使用命令 cd /etc/yum.repos.d。
为了防止原有的 yum 镜像源文件被修改或丢失，先创建一个备份目录 mkdir /etc/yum.repos.d/backup，然后将原有的 .repo 文件移动到备份目录中，使用命令 mv /etc/yum.repos.d/*.repo /etc/yum.repos.d/backup/。
从阿里云下载适用于 CentOS 8 的镜像源文件，执行命令 curl -o /etc/yum.repos.d/CentOS-Base.repo http://mirrors.aliyun.com/repo/Centos-8.repo。
下载完成后，清理 yum 缓存并重新建立元数据，依次执行以下命令：
yum clean all：清除 yum 缓存中的所有数据，包括已下载的 RPM 包和元数据信息。
yum makecache：根据新的镜像源文件重新生成 yum 缓存的元数据，以便更快地查找和安装软件包。
最后，使用命令 yum repolist 查看新配置的 yum 镜像源是否生效，列出的仓库列表应显示来自阿里云的源信息。

2.检索 Java 可安装的列表：

执行命令 yum list java*，这会列出 yum 仓库中所有与 Java 相关的可安装软件包，包括不同版本的 JDK、JRE（Java Runtime Environment）以及其他 Java 工具和库，方便你选择需要安装的 Java 版本。

3.安装 jdk：

根据上一步检索到的列表，选择合适的 JDK 版本进行安装。这里推荐安装 java-17-openjdk*，执行命令 yum install java-17-openjdk* -y。-y 选项表示在安装过程中自动回答 “yes”，无需手动确认安装提示。

安装完成后，使用命令 javac 验证 Java 编译器是否安装成功。如果系统能够识别 javac 命令并显示相关帮助信息，则说明 JDK 安装正确。

4.配置 Java 环境：

Java 默认安装路径通常为 /usr/lib/jvm，你可以进入该目录查看已安装的 Java 版本文件夹。
使用 vim /etc/profile 命令编辑系统环境变量配置文件，在文件末尾添加以下内容：

# java环境变量
JAVA_HOME=/usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
JRE_HOME=/usr/lib/jvm/jre-17-openjdk-17.0.1.0.12-2.el8_5.x86_64
PATH=$PATH:$JAVA_HOME/bin
CLASSPATH=.:$JAVA_HOME/lib/dt.jar:$JAVA_HOME/lib/tools.jar:$JRE_HOME/lib

注意：上述 JAVA_HOME 和 JRE_HOME 的路径应根据实际安装的 Java 版本进行调整，确保路径准确无误。
保存并退出 vim 编辑器后，执行命令 source /etc/profile，使新配置的环境变量立即生效。

5.查看 Java 环境变量：

分别执行以下命令查看 Java 环境变量的设置情况：
echo $JAVA_HOME：应显示你配置的 Java 安装路径，如 /usr/lib/jvm/java-17-openjdk-17.0.1.0.12-2.el8_5.x86_64。

echo $PATH：应包含 $JAVA_HOME/bin 路径，确保系统能够在任何目录下找到 Java 命令。

echo $CLASSPATH：应显示你配置的类路径信息，用于 Java 类的加载和查找。

4、安装 Jenkins

1.添加 Jenkins 仓库到 yum

执行命令 sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo，这会从 Jenkins 官方网站下载适用于 Red Hat 系（包括 CentOS）的 Jenkins 仓库配置文件，并保存到 /etc/yum.repos.d/ 目录下，命名为 jenkins.repo。

接着执行命令 sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key，导入 Jenkins 的 GPG 密钥，用于验证从 Jenkins 仓库下载的软件包的完整性和真实性，确保安装的软件来源可靠。

2.安装 Jenkins

在 CentOS 8 系统上，执行命令 sudo dnf install jenkins 进行 Jenkins 的安装。dnf 是 CentOS 8 中推荐的软件包管理器，它会自动解决安装过程中的依赖关系，并从配置好的 Jenkins 仓库中下载并安装 Jenkins 及其相关依赖包。

在安装过程中，系统会提示你确认安装信息，如软件包的名称、版本、大小以及依赖关系等。你可以查看这些信息，确保安装的内容符合预期，然后按 y 键继续安装。

3.启动 Jenkins 服务

安装完成后，执行命令 sudo systemctl start jenkins 启动 Jenkins 服务。这会启动 Jenkins 后台进程，使其开始监听来自客户端的请求。

4.查看 Jenkins 是否成功启动

执行命令 sudo systemctl status jenkins 查看 Jenkins 服务的运行状态。如果服务成功启动，输出信息中会显示 active (running) 状态，以及一些关于服务运行的详细信息，如进程 ID、启动时间等。

同时，Jenkins 在首次启动时会生成一个管理员密码，用于解锁和初始化 Jenkins 配置。你可以在文件 /var/lib/jenkins/secrets/initialAdminPassword 中找到该密码，使用 cat /var/lib/jenkins/secrets/initialAdminPassword 命令查看密码内容，并记录下来，在后续访问 Jenkins 网页界面时需要使用该密码进行解锁操作。

5.访问 Jenkins

在浏览器中输入 http://ip:8080（将 ip 替换为实际服务器的 IP 地址），即可访问 Jenkins 网页界面。如果无法访问，可能是由于服务器防火墙的限制。
若遇到访问问题，可以尝试关闭防火墙，执行命令 systemctl stop firewalld 停止防火墙服务，然后执行 systemctl disable firewalld.service 禁用防火墙开机自启。但关闭防火墙会使服务器暴露在潜在的安全风险中，因此更推荐的做法是开放 Jenkins 使用的 8080 端口，执行以下命令：
firewall-cmd --zone=public --add-port=8080/tcp --permanent：这会将 8080 端口添加到防火墙的公共区域，并设置为永久生效。
systemctl restart firewalld.service：重启防火墙服务，使端口开放设置生效。
首次访问 Jenkins 网页界面时，会要求输入管理员密码进行解锁。输入之前获取的初始密码后，点击 “继续” 按钮，进入 Jenkins 插件安装页面。在这里，你可以选择安装推荐的插件，这些插件会提供常见的持续集成和持续交付功能，如 Git 集成、构建工具集成等，也可以根据自己的需求自定义选择要安装的插件。

这里的管理员密码就是/var/lib/jenkins/secrets/initialAdminPassword路径文件里存储的代码

完成插件安装后，会进入创建管理员用户页面，设置用户名、密码和电子邮件地址等信息，这些信息将用于后续登录 Jenkins 管理界面。设置完成后，点击 “保存并继续” 按钮，进入 Jenkins 实例配置页面，在这里可以配置 Jenkins 的 URL 等信息，通常保持默认设置即可，点击 “保存并完成” 按钮，完成 Jenkins 的初始化配置，即可开始使用 Jenkins 进行项目的持续集成和持续交付配置。

5、安装完成

在整个安装过程中，需要注意以下几点：

硬件资源配置对 Jenkins 的运行有一定影响，建议为服务器分配足够的运行内存（如 2GB 或以上）和 CPU 核心（如 2 核或以上），以确保 Jenkins 能够稳定运行，尤其是在处理复杂的构建任务和大量的项目时。
确保安装的 JDK 版本为 17 以上，因为较新版本的 Jenkins 可能对 Java 版本有一定要求，低版本的 Java 可能会导致 Jenkins 启动失败或运行不稳定。

以上步骤详细地描述了在 CentOS 8 系统上安装 Jenkins 的全过程，希望对你有所帮助。如果你在安装过程中遇到任何问题，可以参考 Jenkins 官方文档、相关论坛或社区寻求进一步的支持和解决方案。