Debian Jenkins怎么连Git

在 Debian 上运行的 Jenkins 连接 Git，通常分为 安装 Git、配置 Jenkins、创建任务并连接仓库 几个步骤。下面按最常见场景说明（以 GitLab / GitHub / 普通 Git 仓库 为例）。

一、Debian 上准备 Git

1. 安装 Git

sudo apt update
sudo apt install -y git

2. 验证

git --version

二、Jenkins 安装 Git 插件

1. 打开 Jenkins
   http://<jenkins-ip>:8080
2. Manage Jenkins → Plugins → Available plugins
3. 搜索并安装：
   • ✅ Git
   • ✅ Git client
4. 安装完成后重启 Jenkins

三、配置 Jenkins 全局 Git

1. Manage Jenkins → Tools
2. 找到 Git installations
3. 点击 Add Git
   • Name: Default
   • Path to Git executable:

     /usr/bin/git
     

4. 保存

四、凭据配置（重要）

1. 使用用户名 + 密码（HTTPS）

Manage Jenkins → Credentials → System → Global credentials

• 类型：Username with password
• 用户名：Git 用户名
• 密码：Git 密码 / Token
• ID：git-cred

2. 使用 SSH（推荐）

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

• 将 公钥 添加到 Git 仓库（GitHub / GitLab）
• Jenkins 中添加：
  • 类型：SSH Username with private key
  • Username：git
  • Private Key：粘贴私钥

五、创建 Jenkins 任务连接 Git

1. 新建任务

• New Item → Freestyle project

2. 配置源码管理

• 选择 Git
• Repository URL：

  https://github.com/user/repo.git
  或
  git@github.com:user/repo.git
  

• Credentials：选择前面创建的
• Branch：

  */main
  

六、测试连接

在 Build Steps 中添加：

git log -1

点击 Build Now
✅ 成功拉取代码即配置完成

七、常见问题

❌ Permission denied (publickey)

• 私钥未正确配置
• Jenkins 用户无权限访问 /var/lib/jenkins/.ssh

❌ Host key verification failed

在 Debian 上执行：

sudo -u jenkins ssh git@github.com

选择 yes 接受 host key

❌ git not found

确保 Jenkins 中 Git 路径正确

如果你是想连 GitLab / GitHub / 内网 Git / 多分支 Pipeline，可以告诉我具体场景，我可以给你对应配置示例。