本教程适用于以下操作系统版本
- Rocky Linux 9
- Rocky Linux 8.4
本页内容
- 先决条件
- 安装 Java OpenJDK
- 添加 Jenkins 仓库
- 安装 Jenkins
- 安装并配置 httpd 作为反向代理
- 配置 Firewalld
- Jenkins 初始配置
- 创建第一个 Jenkins 构建
- 结语
Jenkins 是一款用于持续集成/持续交付(CI/CD)的开源自动化工具。它完全使用 Java 编写,并支持 1000 多个插件,用于构建、部署和自动化你的项目。Jenkins 已成为领先的自动化工具之一,能够通过自动化加速你的开发流程。Jenkins 集成了构建、文档、测试、打包、预演(stage)、部署、静态分析等众多开发生命周期流程。
Jenkins 支持多种版本控制工具,如 Git、Subversion、Mercurial、CVS、Perforce 和 RTC。此外,它还能执行 Apache Ant、Apache Maven、shell 脚本以及 Windows 批处理命令。Jenkins 拥有强大的社区支持,并配有详尽的文档和 wiki,这使它成为使用最广泛的自动化 CI/CD 工具之一。同时,它还提供了多种不同的工具、语言和自动化任务,以自动化你的开发与部署流程。
在本教程中,你将在 Rocky Linux 9 服务器上安装并搭建 Jenkins,并使用 Apache/httpd 反向代理。你还将通过 SSL 和 firewalld 对 Jenkins 进行安全加固。最后,你将创建一个简单的 Jenkins 构建。
先决条件
开始之前,你需要满足以下要求才能完成本教程:
- 一台 Rocky Linux 服务器——本教程使用最新的 Rocky Linux 9。
- 一个具有 sudo/root 管理员权限的非 root 用户。
- 一个指向服务器 IP 地址的域名——本示例使用域名 'jenkins.example.local'。
- SELinux 配置为 'permissive'(宽松)模式。
安装 Java OpenJDK
Jenkins 完全使用 Java 编写。在此步骤中,你将安装 Java OpenJDK 11。
Rocky Linux 默认仓库提供了多个版本的 Java OpenJDK。要安装 Jenkins,你可以使用 Java OpenJDK 11 或 17。本示例使用 Java OpenJDK 11,运行以下 dnf 命令进行安装。
sudo dnf install java-11-openjdk
出现提示时输入 y 并按 ENTER 继续。

Java 安装完成后,使用以下命令验证 Java 版本。你应该会看到 Rocky Linux 上已安装 Java OpenJDK 11。
java -version

添加 Jenkins 仓库
Jenkins 可部署在多种环境中,包括独立部署在虚拟机上,或使用 Docker 和 Kubernetes 等容器技术。对于 Linux 发行版,你可以通过 Jenkins 仓库提供的二进制包来安装 Jenkins。
在添加 Jenkins 仓库之前,运行以下 dnf 命令安装相关软件包。
sudo dnf install wget curl
然后,通过以下 wget 命令为基于 RHEL 的操作系统下载 Jenkins 仓库。该仓库将存储在 ' /etc/yum.repos.d/jenkins.repo '。
sudo wget -O /etc/yum.repos.d/jenkins.repo \
https://pkg.jenkins.io/redhat-stable/jenkins.repo
接下来,使用以下 rpm 命令将 Jenkins 仓库的 GPG 密钥导入到你的系统。
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

最后,通过以下 dnf 命令验证系统上已启用的仓库列表。
sudo dnf repolist
你将收到输出,表明 Jenkins 仓库已在你的系统上可用,此时便可以安装 Jenkins 了。

安装 Jenkins
仓库添加完成后,你将在 Rocky Linux 服务器上安装 Jenkins。
运行以下 dnf 命令来安装 Jenkins。
sudo dnf install jenkins
出现提示时,输入 y 确认并按 ENTER 继续。Jenkins 安装将随之开始。在下面的输出中,你将安装 Jenkins v2.361,这是 Jenkins 的最新稳定版本(撰写本文时)。

然后,在 Jenkins 安装完成后,运行以下 systemctl 命令重新加载 systemd 管理器。安装完成后,将创建 'jenkins' 服务,该命令会将新服务应用到你的系统。
sudo systemctl daemon-reload
接下来,通过 systemctl 命令启动并启用 'jenkins' 服务。Jenkins 现在应该已在你的系统上运行,并将在系统启动或开机时自动运行。
sudo systemctl start jenkins
sudo systemctl enable jenkins

最后,通过以下 systemctl 命令验证 Jenkins。
sudo systemctl status jenkins
你将收到类似以下截图的输出——Jenkins 服务正在运行。

Jenkins 现已运行,你可以开始 Jenkins 的初始配置了。不过,你将使用 Apache/httpd 作为反向代理来搭建并运行 Jenkins。
安装并配置 httpd 作为反向代理
此时,Jenkins 可通过 TCP 端口 8080 访问。为了让 Jenkins 更友好且更安全,你将安装并配置 Apache/httpd 网页服务器作为 Jenkins 的反向代理。
在开始之前,请确保你的域名已指向 Rocky Linux 的 IP 地址,并且你已生成 SSL 证书。你可以使用自签名证书,也可以使用 Let'sencrypt 提供的免费 SSL。
首先,通过以下 dnf 命令安装 httpd 网页服务器和 mod_ssl 软件包。出现提示时输入 y,然后按 ENTER 继续。
sudo dnf install httpd mod_ssl

mod_ssl 软件包要求你为 localhost 设置证书。因此,运行以下命令仅为 localhost 生成自签名证书。
在此过程中,系统会要求你输入 SSL 证书的详细信息。你可以输入自己的信息,或直接按 ENTER 跳过。
openssl req -newkey rsa:2048 -nodes -keyout /etc/pki/tls/private/localhost.key -x509 -days 365 -out /etc/pki/tls/certs/localhost.crt
httpd 网页服务器安装完成后,使用以下 nano 编辑器命令创建新的虚拟主机配置文件 '/etc/httpd/conf.d/jenkins.conf '。
sudo nano /etc/httpd/conf.d/jenkins.conf
将以下配置添加到文件中。本示例使用域名 'jenkins.example.local',并采用来自 Letsencrypt 的 SSL 证书。因此,请务必修改域名和 SSL 证书的路径。
<VirtualHost *:80> ServerAdmin webmaster@localhost Redirect permanent / https://jenkins.example.local/ </VirtualHost> <VirtualHost *:443> SSLEngine On SSLCertificateFile /etc/letsencrypt/live/jenkins.example.local/fullchain.pem SSLCertificateKeyFile /etc/letsencrypt/live/jenkins.example.local/privkey.pem ServerAdmin webmaster@localhost ProxyRequests Off ProxyPreserveHost On AllowEncodedSlashes NoDecode <Proxy *> Order deny,allow Allow from all </Proxy> ProxyPass / http://localhost:8080/ nocanon ProxyPassReverse / http://localhost:8080/ ProxyPassReverse / http://jenkins.example.local/ RequestHeader set X-Forwarded-Proto "https" RequestHeader set X-Forwarded-Port "443" </VirtualHost>
完成后保存文件并关闭编辑器。
接下来,运行以下命令验证 httpd 配置。如果得到类似 ' Syntax O K' 的输出,说明你的 httpd 配置正确,可以启动 httpd 服务了。
sudo apachectl configtest

通过以下 systemctl 命令启动并启用 httpd 服务。
sudo systemctl start httpd
sudo systemctl enable httpd
使用以下命令验证 httpd 服务状态。你应该会看到 httpd 服务正在运行且已启用,这意味着 httpd 将在开机时自动启动。
sudo systemctl status httpd

在此步骤中,你安装了 httpd 网页服务器,将 httpd 配置为反向代理,并启用了安全的 HTTPS。但要访问你的 Jenkins 安装,你仍需要在 Rocky Linux 服务器上配置 firewalld。
配置 Firewalld
Firewalld 是基于 RHEL 的操作系统(包括 Rocky Linux)上的默认防火墙软件。它在 Rocky Linux 上默认安装并运行。你现在将配置 firewalld,并开放 HTTP 和 HTTPS 服务以允许访问 Jenkins。
运行以下 firewall-cmd 命令,将 HTTP 和 HTTPS 服务添加到 firewalld。
sudo firewall-cmd --add-service=http --permanent
sudo firewall-cmd --add-service=https --permanent
之后,重新加载 firewalld 以应用新的更改,并验证 firewalld 上已启用的服务列表。
sudo firewall-cmd --reload
sudo firewall-cmd --list-services
这将给出如下输出——HTTP 和 HTTPS 服务均已添加到 firewalld。

HTTP 和 HTTPS 端口开放后,你便可以通过网页浏览器开始 Jenkins 的初始安装与配置。
Jenkins 初始配置
在开始 Jenkins 初始配置之前,运行以下命令获取 Jenkins 的初始密码。首次配置 Jenkins 时需要该初始管理员密码。
sudo cat /var/lib/jenkins/secrets/initialAdminPassword

现在打开网页浏览器,访问你 Jenkins 安装的域名(即:https://jenkins.example.local/)。
在首页,系统会要求你输入 Jenkins 初始管理员密码。粘贴你的 Jenkins 初始密码,然后点击 ' Continue '(继续)。

现在通过安装一些插件来自定义 Jenkins 安装。你可以手动选择插件(适合高级用户),也可以选择 ' install suggested plugins '(安装推荐插件)选项来安装 Jenkins 推荐的插件。

Jenkins 插件安装现在将开始。所有这些插件都将被安装到你的 Jenkins 上。

当插件安装完成后,你将设置 Jenkins 的管理员用户。输入你的详细信息、用户名、邮箱和密码,然后点击 ' Save and continue '(保存并继续)。

接下来,在实例配置中输入 Jenkins URL。在本示例中,Jenkins 通过 httpd 反向代理运行在域名 'https://jenkins.example.local/' 上。
点击 ' Save and Finish '(保存并完成)以完成 Jenkins 的初始配置。

Jenkins 的初始配置完成后,你将被重定向到 Jenkins 仪表盘。

你现在已经完成了 Jenkins 的初始配置。有了这个基础,你就可以创建并搭建一个新的 Jenkins 构建了。请继续阅读以了解 Jenkins 构建。
创建第一个 Jenkins 构建
在 Jenkins 仪表盘上,点击菜单 New Item(新建任务)以创建一个新的 Jenkins 构建。

输入该新构建的项目名称,并选择项目类型。在本示例中,你将创建一个名为 " First Build "(首次构建)的新 Jenkins 构建,类型为 " Freestyle project '(自由风格项目)。
点击 OK 继续。

在 " General "(通用)部分,输入项目描述。然后,移动到 " Build Steps "(构建步骤)部分。
选择构建步骤为 "Execute shell"(执行 shell),并输入以下简单的 bash 命令。
echo "This is First build on jenkins"
现在点击 Save(保存)以确认并创建 Jenkins 构建。

你现在将被重定向到项目 " First Build "(首次构建)的 Jenkins 构建页面。
点击 " Build Now "(立即构建)以启动并运行 Jenkins 构建。项目运行后,你应该在 " Build History "(构建历史)部分看到构建历史。

在下面的截图中,只有一个 Jenkins 构建历史。

点击构建历史编号 1,以获取 Jenkins 构建的更详细输出。现在点击 " Console Output "(控制台输出)以获取 Jenkins 构建生成的详细输出。

你现在已经学会了如何创建并运行 Jenkins 构建。
结语
在本文中,你在 Rocky Linux 9 服务器上安装了 Jenkins。你还安装并配置了 Apache2/httpd 网页服务器作为 Jenkins 的反向代理,并通过 SSL 证书和 firewalld 对 Jenkins 安装进行了安全加固。
除此之外,你还学习了 Jenkins 的基本初始配置,以及如何通过 Jenkins 管理网页界面创建并运行 Jenkins 构建。
既然你已经拥有了完全可运行的 Jenkins 部署,你就可以添加自己的项目并为你的应用搭建 Jenkins 构建了。此外,你还可以通过添加适合你环境的插件来扩展 Jenkins 的功能。