Debian系统如何快速部署Jenkins

Debian系统快速部署Jenkins指南

一、基础环境准备

1. 更新系统软件包

首先确保系统软件包为最新版本，避免兼容性问题：

sudo apt update && sudo apt upgrade -y

2. 安装Java运行环境

Jenkins依赖Java环境，推荐安装OpenJDK 11（LTS版本，稳定性高）：

sudo apt install openjdk-11-jdk -y
# 验证Java安装是否成功
java -version

输出应包含openjdk version "11.x.x"，确认Java环境正常。

二、添加Jenkins官方仓库

1. 导入Jenkins GPG密钥

Jenkins官方仓库的软件包需通过GPG密钥验证，确保安全性：

wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add -

若提示apt-key已弃用，可忽略（Debian 11及以上版本仍支持）。

2. 添加Jenkins APT源

将Jenkins稳定版仓库添加到系统源列表：

echo "deb http://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list

3. 更新APT包列表

同步系统包列表，获取Jenkins仓库中的软件包信息：

sudo apt update

三、安装与启动Jenkins

1. 安装Jenkins

通过APT包管理器安装Jenkins（自动解决依赖关系）：

sudo apt install jenkins -y

2. 启动Jenkins服务

启动Jenkins服务并设置为开机自启，确保系统重启后自动运行：

sudo systemctl start jenkins
sudo systemctl enable jenkins

3. 验证服务状态

检查Jenkins服务是否运行正常：

sudo systemctl status jenkins

输出应显示active (running)，表示服务已启动。

四、初始配置Jenkins

1. 获取初始管理员密码

首次访问Jenkins需输入初始管理员密码，通过以下命令获取：

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

复制输出的密码（共32位），用于后续解锁。

2. 访问Jenkins Web界面

在浏览器中输入服务器IP地址及默认端口8080（如http://your_server_ip:8080），进入Jenkins解锁页面，粘贴上述密码完成解锁。

3. 安装推荐插件

解锁后，Jenkins会提示安装“建议插件”（包含常用功能如Git、Pipeline、SSH等），勾选“安装建议的插件”并等待安装完成（约5-10分钟）。插件安装完成后，系统会自动跳转至管理员账户创建页面。

4. 创建管理员账户

填写管理员账户信息（用户名、密码、全名、邮箱），点击“保存并完成”。此后可通过该账户登录Jenkins进行管理。

5. 完成初始设置

最后一步确认Jenkins URL（默认为http://your_server_ip:8080），点击“开始使用Jenkins”即可进入主界面。

五、可选优化步骤

1. 配置防火墙（若启用）

若系统启用了UFW防火墙，需开放Jenkins默认端口8080，允许外部访问：

sudo ufw allow 8080
sudo ufw reload

2. 更换国内镜像源（加速插件安装）

Jenkins默认插件源位于国外，下载速度较慢。可通过以下步骤更换为清华大学镜像源：

进入Manage Jenkins → Plugin Manager → Advanced；
将“Update Site”输入框中的URL替换为：https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json；
保存设置后，后续插件安装将从国内镜像源下载。

3. 使用Docker快速部署（可选）

若系统已安装Docker，可通过Docker Compose快速部署Jenkins（更轻量、易管理）：

创建docker-compose.yml文件：

version: "3"
services:
  jenkins:
    image: jenkins/jenkins:lts
    restart: on-failure
    ports:
      - "7080:8080"
      - "50000:50000"
    volumes:
      - jenkins-data:/var/jenkins_home
volumes:
  jenkins-data:

启动容器：
```
docker-compose up -d
```
访问http://your_server_ip:7080，通过docker exec jenkins cat /var/jenkins_home/secrets/initialAdminPassword获取初始密码，后续步骤与普通部署一致。

通过以上步骤，即可在Debian系统上快速完成Jenkins的部署与初始配置，满足持续集成/持续交付（CI/CD）的基本需求。