Jenkins在Linux上如何安装 - 问答

Jenkins在Linux上的安装指南

Jenkins是一款开源持续集成/持续交付（CI/CD）工具，广泛用于自动化构建、测试和部署流程。在Linux系统上安装Jenkins，主要有包管理器安装（推荐，适用于生产环境）和Docker容器安装（轻量灵活，适用于测试/快速部署）两种方式，以下是详细步骤：

一、前置准备

1. 系统要求

操作系统：支持Ubuntu（18.04及以上）、Debian（9及以上）、CentOS（7及以上）、Fedora等主流Linux发行版；
硬件要求：至少256MB内存（建议512MB以上），磁盘空间10GB以上（用于存储构建产物和Jenkins数据）；
网络要求：服务器需联网（用于下载Jenkins及插件）。

2. 安装Java环境（必需）

Jenkins基于Java开发，需提前安装Java 8或Java 11（推荐OpenJDK，兼容性好）。

检查Java是否已安装：
运行命令java -version，若输出类似openjdk version "11.0.xx"则表示已安装，否则继续下一步。

Ubuntu/Debian安装OpenJDK 11：

sudo apt update
sudo apt install openjdk-11-jdk -y

CentOS/RHEL安装OpenJDK 11：

sudo yum install java-11-openjdk-devel -y

验证Java安装：再次运行java -version，确认输出包含Java版本信息。

二、通过包管理器安装（推荐）

包管理器安装是最常用的方式，操作简单且便于后续升级维护。

1. Ubuntu/Debian系统

（1）添加Jenkins官方仓库

# 导入Jenkins GPG密钥（用于验证软件包完整性）
curl -fsSL https://pkg.jenkins.io/debian/jenkins.io.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null

# 添加Jenkins仓库到系统源列表
echo "deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null

# 更新软件包索引
sudo apt update

（2）安装Jenkins

sudo apt install jenkins -y

2. CentOS/RHEL系统

（1）添加Jenkins官方仓库

# 下载并安装Jenkins仓库文件
sudo wget -O /etc/yum.repos.d/jenkins.repo https://pkg.jenkins.io/redhat-stable/jenkins.repo

# 导入Jenkins GPG密钥
sudo rpm --import https://pkg.jenkins.io/redhat-stable/jenkins.io.key

（2）安装Jenkins

sudo yum install jenkins -y

3. 启动Jenkins服务

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

# 启动Jenkins服务
sudo systemctl start jenkins

# 设置开机自启
sudo systemctl enable jenkins

# 检查服务状态（若显示"active (running)"则表示成功）
sudo systemctl status jenkins

4. 配置防火墙

若系统启用了防火墙（如Ubuntu的ufw或CentOS的firewalld），需允许Jenkins默认端口（8080）通过：

# Ubuntu/Debian（ufw）
sudo ufw allow 8080
sudo ufw enable

# CentOS/RHEL（firewalld）
sudo firewall-cmd --permanent --add-port=8080/tcp
sudo firewall-cmd --reload

5. 访问Jenkins管理页面

在浏览器中输入http://<服务器IP>:8080，首次访问需输入初始管理员密码（通过以下命令获取）：

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

输入密码后，按照提示完成插件安装（建议选择“安装推荐插件”）和管理员账户创建。

三、通过Docker安装（可选）

Docker容器化安装适合快速部署，无需关心系统依赖，且便于迁移。

1. 安装Docker

若未安装Docker，可通过以下命令快速安装（以Ubuntu为例）：

sudo apt update
sudo apt install docker.io -y
sudo systemctl start docker
sudo systemctl enable docker

2. 拉取Jenkins镜像

使用官方镜像（推荐lts版本，长期支持）：

docker pull jenkins/jenkins:lts

3. 运行Jenkins容器

docker run -d \
  --name jenkins \          # 容器名称
  -p 8080:8080 \            # 映射Web UI端口
  -p 50000:50000 \          # 映射代理端口（用于与Jenkins agent通信）
  -v jenkins_home:/var/jenkins_home \  # 持久化数据（挂载到主机卷）
  jenkins/jenkins:lts

参数说明：
-v jenkins_home:/var/jenkins_home：将容器内的/var/jenkins_home目录挂载到主机的jenkins_home卷，确保数据不会因容器删除而丢失。

4. 访问Jenkins管理页面

与包管理器安装相同，在浏览器输入http://<服务器IP>:8080，通过docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword获取初始密码完成初始化。

四、常见问题解决

Java版本不符：若系统安装了多个Java版本，可通过update-alternatives切换默认版本（如sudo update-alternatives --config java）；
无法访问8080端口：检查防火墙设置或Jenkins服务是否启动（sudo systemctl status jenkins）；
初始密码无法获取：确认/var/lib/jenkins/secrets/initialAdminPassword文件是否存在（权限为644），或尝试重启Jenkins服务。

通过以上步骤，即可在Linux系统上成功安装Jenkins。安装完成后，即可开始配置项目、添加插件，实现自动化构建与部署流程。

0 赞

0 踩