在Ubuntu 16.04上安装Jenkins时遇到系列报错该如何解决

报错说明 #

• release file not available
• data from the repository cant be authenticated
• server certification failed
• some index files failed to download

排查解决步骤 #

1. 替换Ubuntu 16.04过期软件源 #

Ubuntu 16.04已于2021年停止官方支持，默认官方源已被归档，首先替换为国内可用的归档源解决release文件不存在、索引文件下载失败问题：

• 备份原有源配置

sudo cp /etc/apt/sources.list /etc/apt/sources.list.bak

• 编辑源配置文件/etc/apt/sources.list，清空原有内容替换为以下内容：

deb http://mirrors.aliyun.com/ubuntu-old-releases/ubuntu/ xenial main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu-old-releases/ubuntu/ xenial-security main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu-old-releases/ubuntu/ xenial-updates main restricted universe multiverse
deb http://mirrors.aliyun.com/ubuntu-old-releases/ubuntu/ xenial-backports main restricted universe multiverse

• 执行源缓存更新测试

sudo apt update

2. 导入Jenkins官方GPG密钥 #

仓库数据无法认证的报错是因为系统未导入Jenkins源的可信GPG密钥，执行以下命令导入：

curl -fsSL https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key | sudo apt-key add -

3. 配置Jenkins官方软件源 #

sudo sh -c 'echo deb http://pkg.jenkins.io/debian-stable binary/ > /etc/apt/sources.list.d/jenkins.list'

4. 修复服务器证书校验失败问题 #

证书报错是因为系统根证书包过期，先更新根证书：

sudo apt install --reinstall ca-certificates
sudo update-ca-certificates

如果仍有证书报错，可临时使用忽略证书校验参数更新缓存（仅临时排查使用，不建议长期开启）：

sudo apt -o Acquire::https::Verify-Peer=false update

5. 正式安装Jenkins #

所有配置完成后重新执行安装操作：

sudo apt update
sudo apt install jenkins

安装验证 #

启动服务并查看运行状态确认安装成功：

sudo systemctl start jenkins
sudo systemctl status jenkins

内容的提问来源于stack exchange，提问作者mohan pbz