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。安装完成后，即可开始配置项目、添加插件，实现自动化构建与部署流程。