Jenkins部署(Ubuntu 24.04)
步骤一:安装Java环境
Jenkins需要Java 17或Java 11作为运行环境。Ubuntu 24.04仓库通常包含较新版本的OpenJDK,建议安装Java 17:
1 | |
安装后,可以通过 java -version 验证。
步骤二:添加Jenkins仓库(新方法)
因为原来的wegt拉取密钥方法已经被遗弃,所以采用新方法:
这是替换旧方法的核心步骤,请按顺序执行:
下载仓库密钥,并使用
gpg工具进行解码,然后将其存放在系统信任的密钥目录中:1
2
3
4# 没有就创建,有的就不用了
sudo mkdir -p /usr/share/keyrings
#
curl -fsSL https://pkg.jenkins.io/debian/jenkins.io-2023.key | sudo gpg --dearmor -o /usr/share/keyrings/jenkins.gpgcurl -fsSL:安全地下载密钥文件。gpg --dearmor:将密钥转换为APT可以识别的格式。-o /usr/share/keyrings/jenkins.gpg:输出到指定的密钥环目录,这是现在推荐的位置。
添加软件源列表。注意,源地址现在需要指向
https,并且要在行尾明确指定已导入的密钥环文件:1
echo "deb [signed-by=/usr/share/keyrings/jenkins.gpg] https://pkg.jenkins.io/debian-stable binary/" | sudo tee /etc/apt/sources.list.d/jenkins.list > /dev/null[signed-by=...]:指明这个仓库使用我们刚才导入的特定密钥文件进行验证。
步骤三:安装并启动Jenkins
更新包列表并安装Jenkins的LTS(长期支持)版本,这是生产环境的推荐选择。
1 | |
安装完成后,启动服务并设置开机自启:
1 | |
你可以使用 sudo systemctl status jenkins 来确认服务是否正常运行。
Q/A
Java环境问题(最常见)
Jenkins需要正确版本的Java。请确认已安装Java 11或17,并且
JAVA_HOME已设置。1
2
3
4# 检查Java版本
java -version
# 检查JAVA_HOME(通常安装JDK后会自动设置,但有时需要手动)
echo $JAVA_HOME如果没有输出,可能需要手动设置。首先找到Java安装路径:
1
sudo update-alternatives --config java然后编辑Jenkins配置文件:
1
sudo vi /etc/default/jenkins找到
JAVA_HOME=这一行,取消注释并设置为上一步得到的路径(例如/usr/lib/jvm/java-17-openjdk-amd64)。若没有则在JAVA部分加上即可。
端口冲突
默认情况下,Jenkins使用8080端口。检查是否有其他程序(如其他Java应用、某些Docker容器)占用了该端口:
可以使用以下两条命令查看错误信息
1 | |
一般是因为8080端口冲突了
1 | |
如果端口被占用,你可以在 `/etc/default/jenkins` 中修改 `HTTP_PORT` 为其他值(如8081)。
1 | |
Jenkins部署(Ubuntu 24.04)
http://bote798.github.io/2025/12/23/Jenkins部署(Ubuntu-24-04)/