CI/CD / 系统课时
安装 Jenkins 并验证运行状态
安装 Jenkins 并验证运行状态
本节在 Linux 主机上安装 Jenkins,并用 systemd、端口和日志三层信号确认服务真正运行。完成后,你不仅能打开 Jenkins,还能在页面无法访问时快速判断问题出在服务启动、端口监听还是主机网络层。
学习目标
- 在基于 Debian 或 Ubuntu 的 Linux 主机上安装并启动 Jenkins
- 使用 systemd、端口和日志验证 Jenkins 运行状态
- 获取首次初始化密码并完成安装前的基本故障定位
安装前确认 Java
Jenkins 需要受支持的 Java 运行环境。不同 Jenkins 版本的 Java 要求会变化,因此正式环境应以当前 Jenkins 版本的官方要求为准。安装前先确认系统已经能够调用 Java。
java -version预期输出
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 官方仓库签名密钥、配置稳定版仓库并安装软件包。
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预期输出
...
Setting up jenkins (<VERSION>) ...软件包版本和 APT 的附加输出会随时间变化。如果仓库签名密钥或仓库地址发生调整,应使用 Jenkins 官方安装文档中的当前值,而不是绕过 APT 的签名验证。
启动并检查服务
安装完成后启用并启动 Jenkins,然后让 systemd 返回服务状态。--no-pager 可以避免命令进入分页器,更适合排障时直接读取结果。
sudo systemctl enable --now jenkins
sudo systemctl status jenkins --no-pager预期输出
● jenkins.service - Jenkins Continuous Integration Server
Loaded: loaded (...; enabled; ...)
Active: active (running) since <TIME>; ...最关键的是看到 Active: active (running)。如果状态是 failed,不要反复执行启动命令,应直接查看服务日志寻找 Java、权限、配置或端口相关错误。
验证端口与 HTTP 响应
服务处于 running 并不等于浏览器一定能访问。继续检查 Jenkins 是否正在监听端口。默认安装通常使用 8080,但实际端口可能因配置而不同。
sudo ss -lntp | grep ':8080'
curl -I http://127.0.0.1:8080/login预期输出
LISTEN ... :8080 ...
HTTP/1.1 <STATUS>
...ss 应能看到 Jenkins 对应端口处于 LISTEN。HTTP 状态码 <STATUS> 可能因 Jenkins 版本和初始化状态不同而变化,只要能够获得 Jenkins 的 HTTP 响应,就说明本机到 Web 服务的链路已经建立。
获取初始化密码并排查启动失败
首次安装时,Jenkins 会生成初始化管理员密码。确认服务正常后读取该文件,并在首次初始化页面中使用它。
sudo cat /var/lib/jenkins/secrets/initialAdminPassword预期输出
<INITIAL_ADMIN_PASSWORD><INITIAL_ADMIN_PASSWORD> 是每次安装生成的实际值,不应复制示例占位符。如果文件不存在或 Jenkins 页面仍不可用,先查看最近的服务日志。
sudo journalctl -u jenkins -n 100 --no-pager预期输出
<TIME> <HOST> jenkins[<ID>]: <JENKINS_LOG_MESSAGE>日志内容取决于实际故障,因此不能预设固定错误文本。排查时按照“systemctl 确认进程 → ss 确认监听 → curl 确认本机 HTTP → journalctl 查看根因”的顺序,可以把服务故障与外部网络故障快速分开。完成首次初始化后,还应按实际部署环境配置访问控制、反向代理和备份,而不是把默认安装直接视为生产就绪。