在VPS服务器Ubuntu 20.04上部署Jenkins完整流程
想在VPS服务器的Ubuntu 20.04系统上高效部署Jenkins?本文详细拆解环境准备、依赖安装、服务配置等全流程,助你快速搭建持续集成/持续交付(CI/CD)核心工具。
一、环境初始化:确保系统状态稳定
部署前首要任务是让VPS服务器的Ubuntu 20.04保持最新状态。通过两条基础命令完成系统更新:
sudo apt update # 更新软件包索引
sudo apt upgrade -y # 升级所有可更新的软件包
执行完毕后建议重启服务器(`sudo reboot`),避免因内核或关键组件更新导致后续操作异常。实测中发现,部分用户因未及时重启,曾出现Java服务启动失败的情况,这点需特别注意。
二、安装Java:Jenkins运行的核心依赖
Jenkins基于Java开发,Ubuntu 20.04推荐安装LTS版本的OpenJDK 11(长期支持更稳定)。执行安装命令:
sudo apt install openjdk-11-jdk -y
安装完成后验证版本:
java -version
正常输出应包含类似"openjdk version "11.0.20""的信息。若提示命令不存在,可能是安装过程中断,建议重新执行安装命令。
三、添加Jenkins源:获取官方最新版本
为安装最新稳定版Jenkins,需先添加官方软件源。分两步操作:
1. 导入GPG密钥(确保下载的包未被篡改):
wget -q -O - https://pkg.jenkins.io/debian-stable/jenkins.io.key | sudo apt-key add -
2. 添加源列表到系统仓库:
sudo sh -c 'echo deb https://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'
这一步若提示"apt-key is deprecated",可改用`sudo gpg --dearmor --yes --output /usr/share/keyrings/jenkins-keyring.gpg`替代,适配新版Ubuntu的安全策略。
四、安装与启动:让Jenkins跑起来
更新仓库并安装服务:
sudo apt update
sudo apt install jenkins -y
安装完成后启动服务并设置开机自启:
sudo systemctl start jenkins # 启动服务
sudo systemctl enable jenkins # 开机自动启动
可通过`sudo systemctl status jenkins`检查服务状态,若显示"active (running)"则表示启动成功。
五、网络配置:开放外部访问端口
Jenkins默认通过8080端口提供Web服务,需开放防火墙端口(以Ubuntu自带的ufw为例):
sudo ufw allow 8080 # 允许8080端口访问
sudo ufw enable # 启用防火墙(若未启用)
注意:若VPS服务器部署在云平台(如AWS、DigitalOcean),还需在控制台的安全组规则中添加8080端口的入站规则,避免被云厂商的网络防火墙拦截。
六、解锁与初始化:完成首次配置
在浏览器输入`http://VPS公网IP:8080`访问Jenkins界面,首次登录需输入初始管理员密码。通过以下命令获取:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
复制输出的32位字符串到页面输入框,进入插件安装环节。建议选择"安装推荐插件"(包含Git、Maven等常用工具),节省后续手动配置时间。
最后根据提示创建管理员账号(记录好用户名密码,后续登录使用),完成所有步骤后即可进入Jenkins主界面。此时VPS服务器上的Jenkins已具备基础CI/CD能力,可根据需求进一步配置Slave节点、Webhook触发等高级功能。
整个部署过程约需15-20分钟(取决于VPS服务器的网络和硬件性能),关键是确保每一步命令执行成功。遇到报错时,优先检查网络连接(如添加源时是否能访问pkg.jenkins.io)和权限问题(是否遗漏sudo),多数问题通过日志命令`sudo journalctl -u jenkins`可快速定位。