Linux 系统上安装 Jenkins 全流程指南
本文详细介绍了在主流Linux系统上安装Jenkins的完整流程。首先说明安装前的环境准备要求,包括操作系统、Java环境和权限网络条件。然后分别针对Ubuntu/Debian和CentOS/Rocky Linux系统提供具体的安装步骤,包括添加官方仓库和安装命令。安装完成后需启动Jenkins服务并设置开机自启,通过8080端口访问进行初始化配置。最后总结了防火墙设置、端口冲突等常见问题及解决方
在构建持续集成与持续交付(CI/CD)体系时,Jenkins 是最常用的自动化工具之一。相比 Windows,Linux 系统在服务器和生产环境中应用更为广泛,因此在 Linux 上安装 Jenkins 是 DevOps 实践中的重要一步。本文将以主流 Linux 发行版为例,系统介绍 Jenkins 的安装流程及关键注意事项。
一、在 Linux 上安装 Jenkins 前的环境准备
在开始安装 Jenkins 之前,需要确保系统环境满足以下基本条件:
-
操作系统要求
- Ubuntu / Debian
- CentOS / Rocky Linux / AlmaLinux
- 其他主流 Linux 发行版
-
Java 运行环境
Jenkins 基于 Java 运行,推荐使用:
- OpenJDK 8 或 OpenJDK 11(LTS)
可通过以下命令验证 Java 是否已安装:
java -version -
系统权限与网络
- 需要具备
root或sudo权限 - 服务器可正常访问外网以下载依赖与插件
- 需要具备
二、在 Ubuntu / Debian 系统上安装 Jenkins
在基于 Debian 的系统中,官方仓库方式是最稳定、最推荐的安装方案。
-
安装 Java
sudo apt update sudo apt install -y openjdk-11-jdk -
添加 Jenkins 官方仓库
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo tee \ /usr/share/keyrings/jenkins-keyring.asc > /dev/nullecho 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 -
安装 Jenkins
sudo apt update sudo apt install -y jenkins
三、在 CentOS / Rocky Linux 系统上安装 Jenkins
对于基于 Red Hat 的发行版,可通过 YUM 或 DNF 安装 Jenkins。
-
安装 Java
sudo dnf install -y java-11-openjdk -
添加 Jenkins 官方仓库
sudo wget -O /etc/yum.repos.d/jenkins.repo \ https://pkg.jenkins.io/redhat-stable/jenkins.reposudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key -
安装 Jenkins
sudo dnf install -y jenkins
四、启动 Jenkins 服务并设置开机自启
无论使用哪种 Linux 发行版,Jenkins 安装完成后均以系统服务方式运行。
sudo systemctl start jenkins
sudo systemctl enable jenkins
可通过以下命令查看运行状态:
sudo systemctl status jenkins
五、访问 Jenkins 并完成首次初始化配置
默认情况下,Jenkins 使用 8080 端口。在浏览器中访问:
http://服务器IP:8080
首次访问需要进行解锁操作:
-
获取初始管理员密码:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword -
将密码粘贴到解锁页面中
-
选择安装 推荐插件(Recommended Plugins)
-
创建管理员用户并完成初始化设置
六、Linux 上安装 Jenkins 的常见问题与注意事项
-
防火墙未放行端口
sudo firewall-cmd --permanent --add-port=8080/tcp sudo firewall-cmd --reload -
端口冲突问题
可修改
/etc/default/jenkins或/etc/sysconfig/jenkins中的端口配置。 -
Java 版本不兼容
避免使用过高版本的 JDK,优先选择 LTS 版本。
-
权限问题
Jenkins 默认用户为
jenkins,涉及文件操作时需注意权限分配。
结语
在 Linux 系统上成功安装 Jenkins,是构建自动化 CI/CD 流水线的重要基础。通过官方仓库方式安装,不仅稳定可靠,也便于后续升级和维护。随着 Jenkins 与 Git、Docker、Kubernetes 等工具的深度结合,Linux 环境下的 Jenkins 将在 DevOps 体系中发挥更大的价值。
更多推荐
所有评论(0)