本教程适用于以下操作系统版本

  • 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 继续。

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

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

java -version

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

添加 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

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

最后,通过以下 dnf 命令验证系统上已启用的仓库列表。

sudo dnf repolist

你将收到输出,表明 Jenkins 仓库已在你的系统上可用,此时便可以安装 Jenkins 了。

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

安装 Jenkins

仓库添加完成后,你将在 Rocky Linux 服务器上安装 Jenkins。

运行以下 dnf 命令来安装 Jenkins。

sudo dnf install jenkins

出现提示时,输入 y 确认并按 ENTER 继续。Jenkins 安装将随之开始。在下面的输出中,你将安装 Jenkins v2.361,这是 Jenkins 的最新稳定版本(撰写本文时)。

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

然后,在 Jenkins 安装完成后,运行以下 systemctl 命令重新加载 systemd 管理器。安装完成后,将创建 'jenkins' 服务,该命令会将新服务应用到你的系统。

sudo systemctl daemon-reload

接下来,通过 systemctl 命令启动并启用 'jenkins' 服务。Jenkins 现在应该已在你的系统上运行,并将在系统启动或开机时自动运行。

sudo systemctl start jenkins
sudo systemctl enable jenkins

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

最后,通过以下 systemctl 命令验证 Jenkins。

sudo systemctl status jenkins

你将收到类似以下截图的输出——Jenkins 服务正在运行。

在 Rocky Linux 9 上安装并配置 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

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

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

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

通过以下 systemctl 命令启动并启用 httpd 服务。

sudo systemctl start httpd
sudo systemctl enable httpd

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

sudo systemctl status httpd

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

在此步骤中,你安装了 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。

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

HTTP 和 HTTPS 端口开放后,你便可以通过网页浏览器开始 Jenkins 的初始安装与配置。

Jenkins 初始配置

在开始 Jenkins 初始配置之前,运行以下命令获取 Jenkins 的初始密码。首次配置 Jenkins 时需要该初始管理员密码。

sudo cat /var/lib/jenkins/secrets/initialAdminPassword

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

现在打开网页浏览器,访问你 Jenkins 安装的域名(即:https://jenkins.example.local/)。

在首页,系统会要求你输入 Jenkins 初始管理员密码。粘贴你的 Jenkins 初始密码,然后点击 ' Continue '(继续)。

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

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

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

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

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

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

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

接下来,在实例配置中输入 Jenkins URL。在本示例中,Jenkins 通过 httpd 反向代理运行在域名 'https://jenkins.example.local/' 上。

点击 ' Save and Finish '(保存并完成)以完成 Jenkins 的初始配置。

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

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

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

你现在已经完成了 Jenkins 的初始配置。有了这个基础,你就可以创建并搭建一个新的 Jenkins 构建了。请继续阅读以了解 Jenkins 构建。

创建第一个 Jenkins 构建

在 Jenkins 仪表盘上,点击菜单 New Item(新建任务)以创建一个新的 Jenkins 构建。

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

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

点击 OK 继续。

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

在 " General "(通用)部分,输入项目描述。然后,移动到 " Build Steps "(构建步骤)部分。

选择构建步骤为 "Execute shell"(执行 shell),并输入以下简单的 bash 命令。

echo "This is First build on jenkins"

现在点击 Save(保存)以确认并创建 Jenkins 构建。

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

你现在将被重定向到项目 " First Build "(首次构建)的 Jenkins 构建页面。

点击 " Build Now "(立即构建)以启动并运行 Jenkins 构建。项目运行后,你应该在 " Build History "(构建历史)部分看到构建历史。

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

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

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

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

在 Rocky Linux 9 上安装并配置 Jenkins 持续集成服务

你现在已经学会了如何创建并运行 Jenkins 构建。

结语

在本文中,你在 Rocky Linux 9 服务器上安装了 Jenkins。你还安装并配置了 Apache2/httpd 网页服务器作为 Jenkins 的反向代理,并通过 SSL 证书和 firewalld 对 Jenkins 安装进行了安全加固。

除此之外,你还学习了 Jenkins 的基本初始配置,以及如何通过 Jenkins 管理网页界面创建并运行 Jenkins 构建。

既然你已经拥有了完全可运行的 Jenkins 部署,你就可以添加自己的项目并为你的应用搭建 Jenkins 构建了。此外,你还可以通过添加适合你环境的插件来扩展 Jenkins 的功能。