在 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 及其相关配置和数据文件。

