温馨提示×

Debian Jenkins密钥如何配

小樊
40
2026-10-13 21:02:15
栏目: 智能运维

在 Debian 上配置 Jenkins 的密钥,常见有几种场景。下面我按最常见需求给你讲清楚,你可以对照自己的情况选:


一、Jenkins 官方仓库 GPG 密钥(APT 安装 Jenkins 用)

如果你是用 apt 安装 Jenkins,需要先导入 Jenkins 的 GPG 密钥。

1. 下载并导入密钥(推荐方式)

sudo wget -O /usr/share/keyrings/jenkins-keyring.asc \
  https://pkg.jenkins.io/debian-stable/jenkins.io-2023.key

2. 添加 Jenkins 软件源

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

3. 更新并安装

sudo apt update
sudo apt install jenkins

✅ 这样就完成了 Jenkins 仓库密钥配置


二、Jenkins 凭据(Credentials)中的 SSH 密钥

如果你是说 Jenkins 怎么用 SSH 密钥拉代码 / 登录服务器:

1. 生成 SSH 密钥(如果没有)

ssh-keygen -t rsa -b 4096 -C "jenkins@server"

默认生成:

  • ~/.ssh/id_rsa(私钥)
  • ~/.ssh/id_rsa.pub(公钥)

2. 把公钥放到目标机器

ssh-copy-id user@target-host

3. 在 Jenkins 中添加私钥

  1. 打开 Jenkins
  2. Manage Jenkins → Credentials → System → Global credentials
  3. 点击 Add Credentials
  4. 类型选择:SSH Username with private key
  5. 填写:
    • Username:目标服务器用户名
    • Private Key:粘贴 id_rsa 内容
  6. 保存

三、Jenkins 管理员 API Token(不是密钥但常用)

如果是调用 Jenkins API:

Manage Jenkins → Users → 你的用户 → API Token

用 token 替代密码访问 API。


四、常见错误排查

❌ NO_PUBKEY / GPG 错误
→ 检查 /etc/apt/sources.list.d/jenkins.list 里的 signed-by 路径是否正确

❌ Jenkins 无法 SSH 到服务器
→ 确认:

  • 私钥无密码(或有 Jenkins 凭据密码)
  • 目标机器 ~/.ssh/authorized_keys 已添加

如果你说的“密钥”是某一种具体场景(比如:

  • GitHub 拉代码
  • Docker 登录
  • Kubernetes 部署
  • Jenkins 主从节点

可以直接告诉我,我给你更精确的配置步骤。

0 踩