Jenkins部署(Ubuntu 24.04)

步骤一:安装Java环境

Jenkins需要Java 17或Java 11作为运行环境。Ubuntu 24.04仓库通常包含较新版本的OpenJDK,建议安装Java 17:

1
2
sudo apt update
sudo apt install openjdk-17-jdk -y

安装后,可以通过 java -version 验证。

步骤二:添加Jenkins仓库(新方法)

因为原来的wegt拉取密钥方法已经被遗弃,所以采用新方法:

这是替换旧方法的核心步骤,请按顺序执行:

  1. 下载仓库密钥,并使用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.gpg
    • curl -fsSL:安全地下载密钥文件。
    • gpg --dearmor:将密钥转换为APT可以识别的格式。
    • -o /usr/share/keyrings/jenkins.gpg:输出到指定的密钥环目录,这是现在推荐的位置。
  2. 添加软件源列表。注意,源地址现在需要指向 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
2
sudo apt update
sudo apt install jenkins -y

安装完成后,启动服务并设置开机自启:

1
2
sudo systemctl start jenkins
sudo systemctl enable jenkins

你可以使用 sudo systemctl status jenkins 来确认服务是否正常运行。

Q/A

  1. 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部分加上即可。

  2. 端口冲突

    默认情况下,Jenkins使用8080端口。检查是否有其他程序(如其他Java应用、某些Docker容器)占用了该端口:

可以使用以下两条命令查看错误信息

1
2
systemctl status jenkins.service
journalctl -xeu jenkins.service --no-pager | tail -30

一般是因为8080端口冲突了

1
2
# 查看8080是谁在占用
ss -tlnp | grep :8080
如果端口被占用,你可以在 `/etc/default/jenkins` 中修改 `HTTP_PORT` 为其他值(如8081)。
  1. 权限问题
    确保Jenkins对其工作目录有正确的访问权限:
1
2
sudo chown -R jenkins:jenkins /var/lib/jenkins
sudo chmod -R 755 /var/lib/jenkins

Jenkins部署(Ubuntu 24.04)
http://bote798.github.io/2025/12/23/Jenkins部署(Ubuntu-24-04)/
作者
bote798
发布于
2025年12月23日
更新于
2025年12月24日
许可协议