在 Ubuntu 22.04 服务器上安装 Jenkins 及报错解决,图文教程!
本文介绍了在 Ubuntu 服务器上安装 Jenkins 的详细步骤。首先,更新系统软件包并安装 OpenJDK 17,接着,添加 Jenkins 官方仓库并更新包索引,然后安装 Jenkins。安装完成后,启动并启用 Jenkins 服务,打开防火墙端口 8080 并访问 Jenkins 解锁页面。
在 Ubuntu 服务器上安装 Jenkins 可以通过以下步骤完成:
更新系统软件包
首先,更新你的软件包索引。
sudo apt update
安装 JDK
Jenkins 需要 Java 环境才能运行,你可以安装 OpenJDK,目前官方推荐使用 17 版本。
sudo apt install fontconfig openjdk-17-jre
安装完成后查看版本号:
java -version
添加 Jenkins 仓库
添加 Jenkins 的官方仓库到你的包管理器。
第一条命令:
curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo tee /usr/share/keyrings/jenkins-keyring.asc > /dev/null
第二条命令:
echo deb [signed-by=/usr/share/keyrings/jenkins-keyring.asc] https://pkg.jenkins.io/debian-stable binary/ | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null
不推荐使用其它签名密钥和包管理库(被其他教程坑惨了),因为更新包索引时会报E: The repository 'https://pkg.jenkins.io/debian-stable binary/ Release' is not signed
这样的错误。
安装 Jenkins 时也会提示E: Package 'jenkins' has no installation candidate
这样的错误。
具体解释可参考:https://www.jenkins.io/blog/2023/03/27/repository-signing-keys-changing/
安装 Jenkins
首先再次更新包索引:
sudo apt update
然后安装 Jenkins:
sudo apt install jenkins
查看是否安装成功:
sudo systemctl status jenkins
启动和启用 Jenkins 服务
启动 Jenkins 服务并设置为开机自启动。
sudo systemctl start jenkins
sudo systemctl enable jenkins
打开防火墙端口
Jenkins 默认运行在 8080 端口,你需要确保防火墙允许通过该端口。
sudo ufw allow 8080
sudo ufw status
也可以在服务器实例上放行端口:
访问 Jenkins
打开浏览器并访问 http://你的公网IP:8080
,你将看到一个 Jenkins 解锁页面。
解锁 Jenkins
初次访问 Jenkins 时,你需要提供一个解锁密码。这个密码可以通过以下命令找到:
sudo cat /var/lib/jenkins/secrets/initialAdminPassword
将显示的密码复制并粘贴到浏览器中的 Jenkins 解锁页面。
完成安装
按照 Jenkins 安装向导完成剩余的安装步骤,这包括安装推荐的插件以及创建初始管理员用户。这样,你就成功在 Ubuntu 服务器上安装并运行了 Jenkins。可以通过 Jenkins 的 Web 界面进一步配置和管理你的 Jenkins 实例。
删除 Jenkins
使用 apt
或 yum
(根据你的系统)删除 Jenkins 软件包:
sudo apt-get remove --purge jenkins
# 或者(如果使用 yum)
# sudo yum remove jenkins
删除 Jenkins 配置和数据文件
删除 Jenkins 配置文件和数据文件夹(一般位于 /var/lib/jenkins
和 /etc/jenkins
,不同系统可能路径不同):
sudo rm -rf /var/lib/jenkins
sudo rm -rf /etc/jenkins
sudo rm -rf /var/log/jenkins
sudo rm -rf /usr/share/jenkins
删除 JDK
列出已安装的 JDK 版本:
sudo update-alternatives --config java
查看安装的OpenJDK 软件包:
dpkg --list | grep openjdk
删除 OpenJDK 软件包,例如:
sudo apt-get remove --purge openjdk-11-jdk-headless
sudo apt-get remove --purge openjdk-11-jre-headless
总结
本文介绍了在 Ubuntu 服务器上安装 Jenkins 的详细步骤。首先,更新系统软件包并安装 OpenJDK 17,接着,添加 Jenkins 官方仓库并更新包索引,然后安装 Jenkins。安装完成后,启动并启用 Jenkins 服务,打开防火墙端口 8080 并访问 Jenkins 解锁页面。按照安装向导完成插件安装和管理员创建即可。最后,还介绍了如何卸载 Jenkins 及其相关配置和数据文件。