Jenkins在Debian上的部署教程

Jenkins在Debian上的部署教程

1. 准备工作：更新系统包

在开始部署前，确保Debian系统已更新至最新版本，避免因包依赖问题导致安装失败：

sudo apt update && sudo apt upgrade -y 

2. 安装Java环境（Jenkins核心依赖）

Jenkins是基于Java开发的持续集成工具，需先安装Java运行环境（推荐OpenJDK 11，兼容性最佳）：

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

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

3. 添加Jenkins官方APT仓库

为确保安装最新稳定版Jenkins，需添加Jenkins官方Debian仓库：

# 导入Jenkins官方GPG密钥（用于验证软件包完整性） wget -q -O - https://pkg.jenkins.io/debian/jenkins.io.key | sudo apt-key add - # 添加Jenkins仓库到APT源列表 echo "deb http://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list # 更新APT包列表，使新仓库生效 sudo apt update 

4. 安装Jenkins

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

sudo apt install jenkins -y 

5. 启动Jenkins服务并设置开机自启

安装完成后，立即启动Jenkins服务，并配置为系统开机自动启动：

sudo systemctl start jenkins # 启动Jenkins服务 sudo systemctl enable jenkins # 设置开机自启 # 检查服务运行状态（确认状态为"active (running)"） sudo systemctl status jenkins 

6. 解锁Jenkins：获取初始管理员密码

首次访问Jenkins时，需通过初始管理员密码解锁：

# 查看初始管理员密码（位于/var/lib/jenkins目录下） sudo cat /var/lib/jenkins/secrets/initialAdminPassword 

复制输出的密码，在浏览器访问http://<your_server_ip>:8080时输入（若未修改默认端口）。

7. 配置Jenkins：安装插件与创建管理员

7.1 安装推荐插件

解锁后，Jenkins会提示安装“建议的插件”（包含常用功能如Git、Pipeline、SSH等），点击“安装建议的插件”即可自动完成安装（约需5-10分钟）。

7.2 创建管理员用户

为保障系统安全，建议创建专用管理员账户（避免使用默认的admin账号）：

• 点击“管理Jenkins”→“管理用户”→“创建用户”；
• 填写用户名、全名、密码（如JenkinsAdmin@2025），确认后点击“保存”。

8. 可选配置：优化Jenkins体验

8.1 更换国内插件镜像源（加速插件下载）

若插件安装缓慢，可将插件源更换为清华大学镜像站：

• 进入“Manage Jenkins”→“Plugin Manager”→“Advanced”；
• 将“Update Site”修改为https://mirrors.tuna.tsinghua.edu.cn/jenkins/updates/update-center.json，点击“Submit”。

8.2 配置防火墙（允许外部访问）

若系统启用了UFW防火墙，需开放Jenkins默认端口（8080）：

sudo ufw allow 8080/tcp # 允许TCP协议的8080端口 sudo ufw reload # 重新加载防火墙规则 

9. 验证部署：访问Jenkins界面

完成上述步骤后，在浏览器输入http://<your_server_ip>:8080，使用创建的管理员账户登录，即可进入Jenkins主界面，开始配置CI/CD任务（如创建Pipeline、绑定Git仓库等）。