CI/CD / 系统课时

安装 Jenkins 并验证运行状态

安装 Jenkins 并验证运行状态

本节在 Linux 主机上安装 Jenkins,并用 systemd、端口和日志三层信号确认服务真正运行。完成后,你不仅能打开 Jenkins,还能在页面无法访问时快速判断问题出在服务启动、端口监听还是主机网络层。

学习目标

  • 在基于 Debian 或 Ubuntu 的 Linux 主机上安装并启动 Jenkins
  • 使用 systemd、端口和日志验证 Jenkins 运行状态
  • 获取首次初始化密码并完成安装前的基本故障定位

安装前确认 Java

Jenkins 需要受支持的 Java 运行环境。不同 Jenkins 版本的 Java 要求会变化,因此正式环境应以当前 Jenkins 版本的官方要求为准。安装前先确认系统已经能够调用 Java。

bash
java -version

预期输出

text
openjdk version "<VERSION>" <DATE>
OpenJDK Runtime Environment <DETAILS>
OpenJDK 64-Bit Server VM <DETAILS>

<VERSION>、<DATE> 和具体构建信息会随安装版本变化。如果提示 command not found,应先安装 Jenkins 当前版本支持的 Java,再继续安装 Jenkins。

添加 Jenkins 软件源并安装

以下示例适用于使用 APT 的 Debian 或 Ubuntu 系统。先安装必要工具,再导入 Jenkins 官方仓库签名密钥、配置稳定版仓库并安装软件包。

bash
sudo apt-get update
sudo apt-get install -y wget ca-certificates
sudo mkdir -p /etc/apt/keyrings
sudo wget -O /etc/apt/keyrings/jenkins-keyring.asc https://pkg.jenkins.io/debian-stable/jenkins.io-2026.key
echo "deb [signed-by=/etc/apt/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 -y jenkins

预期输出

text
...
Setting up jenkins (<VERSION>) ...

软件包版本和 APT 的附加输出会随时间变化。如果仓库签名密钥或仓库地址发生调整,应使用 Jenkins 官方安装文档中的当前值,而不是绕过 APT 的签名验证。

启动并检查服务

安装完成后启用并启动 Jenkins,然后让 systemd 返回服务状态。--no-pager 可以避免命令进入分页器,更适合排障时直接读取结果。

bash
sudo systemctl enable --now jenkins
sudo systemctl status jenkins --no-pager

预期输出

text
● jenkins.service - Jenkins Continuous Integration Server
     Loaded: loaded (...; enabled; ...)
     Active: active (running) since <TIME>; ...

最关键的是看到 Active: active (running)。如果状态是 failed,不要反复执行启动命令,应直接查看服务日志寻找 Java、权限、配置或端口相关错误。

验证端口与 HTTP 响应

服务处于 running 并不等于浏览器一定能访问。继续检查 Jenkins 是否正在监听端口。默认安装通常使用 8080,但实际端口可能因配置而不同。

bash
sudo ss -lntp | grep ':8080'
curl -I http://127.0.0.1:8080/login

预期输出

text
LISTEN ... :8080 ...
HTTP/1.1 <STATUS>
...

ss 应能看到 Jenkins 对应端口处于 LISTEN。HTTP 状态码 <STATUS> 可能因 Jenkins 版本和初始化状态不同而变化,只要能够获得 Jenkins 的 HTTP 响应,就说明本机到 Web 服务的链路已经建立。

获取初始化密码并排查启动失败

首次安装时,Jenkins 会生成初始化管理员密码。确认服务正常后读取该文件,并在首次初始化页面中使用它。

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

预期输出

text
<INITIAL_ADMIN_PASSWORD>

<INITIAL_ADMIN_PASSWORD> 是每次安装生成的实际值,不应复制示例占位符。如果文件不存在或 Jenkins 页面仍不可用,先查看最近的服务日志。

bash
sudo journalctl -u jenkins -n 100 --no-pager

预期输出

text
<TIME> <HOST> jenkins[<ID>]: <JENKINS_LOG_MESSAGE>

日志内容取决于实际故障,因此不能预设固定错误文本。排查时按照“systemctl 确认进程 → ss 确认监听 → curl 确认本机 HTTP → journalctl 查看根因”的顺序,可以把服务故障与外部网络故障快速分开。完成首次初始化后,还应按实际部署环境配置访问控制、反向代理和备份,而不是把默认安装直接视为生产就绪。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

安装 Jenkins 并验证运行状态

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通