如何通过GitHub应用程序从Jenkins克隆GitHub代码仓库

1. 配置GitHub应用权限与密钥 #

• 登录GitHub，进入「Settings」→「Developer settings」→「GitHub Apps」，点击「New GitHub App」创建应用
• 填写应用基本信息，重点在「Repository permissions」里开启「Contents」的「Read only」权限（若需写入可设为Read and write）
• 拉到页面底部点击「Create GitHub App」，在应用详情页的「Private keys」区域点击「Generate a private key」，下载生成的.pem私钥文件并妥善保存

2. 在Jenkins中添加GitHub应用凭据 #

• 确保Jenkins已安装「GitHub Integration Plugin」（未安装的话，去「Manage Jenkins」→「Plugins」搜索安装）
• 进入「Manage Jenkins」→「Manage Credentials」，选择目标凭据域（比如「Global credentials」），点击「Add Credentials」
• 凭据类型选「GitHub App」，填入以下信息：
  • GitHub App ID：可在GitHub应用详情页的「About」区域找到
  • Private Key：打开下载的.pem文件，复制全部内容粘贴进去
  • 点击「OK」保存凭据

3. 配置Jenkins任务的源码管理 #

• 新建或编辑Jenkins任务，找到「Source Code Management」模块，选择「Git」
• 在「Repository URL」处填入你的GitHub仓库地址（示例：git@github.com:your-username/your-repo.git 或 HTTPS格式地址）
• 在「Credentials」下拉菜单中选择刚创建的GitHub应用凭据
• 按需指定要克隆的分支（比如*/main），其他克隆参数可根据需求调整

4. 验证克隆功能 #

• 保存任务配置，点击「Build Now」触发构建
• 查看控制台输出，若出现Cloning the remote Git repository、Checking out Revision xxx类日志，说明克隆成功

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