Jenkins 安装实践：在 Ubuntu 24.04上搭建 CI／CD 自动化平台

Jenkins 是一款强大的开源自动化服务器，广泛应用于软件开发中的持续集成与持续部署（CI/CD）。通过其直观的用户界面，开发者可以轻松创建自动化任务和流水线，显著提升代码构建、测试及部署的效率。本文将手把手教你在 Ubuntu 系统上完成 Jenkins 的安装与初始配置，并针对国内网络环境提供优化方案。

环境准备

在开始安装前，请确保你的系统满足以下条件：

• 操作系统：Ubuntu 24.04 如何逐步安装Ubuntu 24.04 服务器(Server)版
• 用户权限：具备 sudo 权限的非 root 用户 一天一个Linux命令：5分钟搞懂sudo权限管理！
• 硬件资源：至少 2GB 内存与 40GB 磁盘空间
• 网络连接：稳定的互联网接入5种方法！Ubuntu Server 24.04 命令行改IP指南

安装流程

1. 安装 Java 运行环境

由于 Jenkins 基于 Java 开发，首先需要安装 Java 运行环境。我们推荐安装 OpenJDK 17，这是目前最新且稳定的版本。

打开终端，执行以下命令：

sudo apt update
sudo apt install fontconfig openjdk-17-jre -y

安装完成后，通过以下命令验证 Java 是否成功安装：

java --version

正常情况下，终端将显示已安装的 Java 版本信息，表明安装成功。

2. 添加 Jenkins 软件源并安装

Ubuntu 24.04 的默认软件源不包含 Jenkins 包，需要手动添加 Jenkins 官方源。

依次执行以下命令：

sudo wget -O /usr/share/keyrings/jenkins-keyring.asc https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key
echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc]" https://pkg.jenkins.io/debian-stable binary/ | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
sudo apt-get update
sudo apt-get install jenkins

Jenkins 安装过程

安装完成后，启动 Jenkins 服务并设置为开机自启：

# 查看 Jenkins 运行状态
systemctl status jenkins

# 设置开机自启
systemctl enable jenkins

Jenkins 服务状态

3. Jenkins 初始配置

现在可以通过浏览器访问 Jenkins Web 界面完成初始配置。

在浏览器地址栏输入：http://<你的服务器IP>:8080

如果需要查询服务器 IP 地址，可在终端使用 ip命令查看。

获取管理员密码

首次访问 Jenkins 会要求输入管理员密码，该密码存储在系统文件中：

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

复制输出的密码内容，粘贴到 Web 界面中的密码框，点击"继续"。

插件安装优化（国内用户特别关注）

接下来会提示安装插件。对于国内用户，这是最关键的一步，直接安装可能会因网络问题失败。

推荐做法：

1. 暂时保持当前页面不动，新开一个浏览器标签页
2. 访问 http://<你的服务器IP>:8080/manage/pluginManager/advanced
3. 找到"Update Site"项，将 URL 替换为国内镜像源： https://mirrors.huaweicloud.com/jenkins/update-center.json

1. 提交更改并返回初始页面

回到初始页面，选择"安装推荐的插件"。系统会开始下载并安装常用插件集。

注意：可能会有个别插件安装失败，这是正常现象。等待其他插件安装完成后，可以点击"重试"再次尝试安装失败插件，或后续手动安装。

创建管理员账户

插件安装完成后，需要创建一个管理员账户：

• 填写用户名、密码、电子邮件等必要信息
• 点击"保存并完成"按钮

实例配置

保持默认 URL 设置不变，直接点击"保存并完成"。

至此，Jenkins 已准备就绪！点击"开始使用 Jenkins"进入主控制面板。

4. 验证 Jenkins 安装

为了验证 Jenkins 是否正常工作，我们可以创建一个简单的测试任务：

1. 点击"新建任务"创建一个自由风格软件项目
2. 输入项目名称（例如"demo-test"）
3. 在构建环境中添加一个简单的执行 shell 步骤
4. 输入测试命令，例如 echo "Hello Jenkins!"
5. 保存并点击"立即构建"

查看构建结果，如果控制台输出显示成功执行并打印了"this is a jenkins demo job!"，说明 Jenkins 已正确安装并运行。

结语

通过本文的步骤，你已经成功在 Ubuntu 系统上安装并配置了 Jenkins 自动化服务器。针对国内网络环境的特殊优化确保了安装过程的顺畅。现在，你可以开始探索 Jenkins 的强大功能，构建自己的 CI/CD 流水线，提升软件开发效率。

Jenkins 的插件生态系统极为丰富，几乎可以满足任何自动化需求。接下来，你可以尝试安装 Git、Docker、Kubernetes 等常用插件，逐步构建适合自己项目的自动化流程。