怎么集成Git到Jenkins

将 Git 集成到 Jenkins 是 CI/CD 里最基础也是最常见的操作。下面我按 从零到可用 的方式给你讲清楚，适合新手，也适合复习。

一、前置条件

1️⃣ 已安装 Jenkins

• 本地或服务器已运行 Jenkins
• 能访问 Jenkins Web 页面（默认：http://localhost:8080）

2️⃣ 已安装 Git

在 Jenkins 所在机器上确认：

git --version

如果没有：

# Ubuntu / Debian
sudo apt install git

# CentOS / RHEL
sudo yum install git

二、在 Jenkins 中安装 Git 插件（99% 情况需要）

1. 登录 Jenkins
2. 进入：

   Manage Jenkins → Plugins → Available plugins
   

3. 搜索 Git
4. 安装：
   • ✅ Git Plugin
   • ✅ Git Client Plugin
5. 安装完成后 重启 Jenkins

三、配置 Git 路径（非常重要）

1. 进入：

   Manage Jenkins → Tools
   

2. 找到 Git installations
3. 配置 Git 路径：
   • Name：Default
   • Path to Git executable：
     • Linux：/usr/bin/git
     • Windows：C:\Program Files\Git\bin\git.exe
4. 保存

✅ 可以点击 “Test Git” 验证是否成功

四、创建 Jenkins Job 并集成 Git

方式一：Freestyle Project（适合新手）

1️⃣ 新建 Job

• New Item
• 选择 Freestyle project
• 输入项目名称 → OK

2️⃣ 配置 Git 仓库

在 Source Code Management 区域：

✅ 选择 Git

填写：

• Repository URL

  https://github.com/yourname/yourrepo.git
  

  或

  git@github.com:yourname/yourrepo.git
  

• Credentials

  • 如果是 HTTPS：填写 GitHub 用户名 + Token
  • 如果是 SSH：添加 SSH Private Key

• Branch

  */main
  

  或

  */master
  

五、配置 Git 认证（重点）

✅ HTTPS 方式（推荐新手）

1. GitHub → Settings → Developer settings → Personal access tokens
2. 生成 Token（勾选 repo）
3. Jenkins：

   Manage Jenkins → Credentials → System → Global credentials
   

4. 添加：
   • Kind：Username with password
   • Username：GitHub 用户名
   • Password：Token

✅ SSH 方式（企业常用）

1. Jenkins 服务器生成密钥：

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

2. 把 公钥 加到：
   • GitHub → SSH Keys
3. Jenkins 添加私钥：
   • Kind：SSH Private Key

六、触发 Git 构建（可选）

方式一：手动构建

• 点击 Build Now

方式二：Webhook（自动触发）

1️⃣ Jenkins 安装插件

• ✅ GitHub Integration Plugin
• ✅ Generic Webhook Trigger

2️⃣ Jenkins 配置

• Build Triggers → ✅ GitHub hook trigger

3️⃣ GitHub 配置 Webhook

https://<jenkins-url>/github-webhook/

七、验证是否成功

1. 点击 Build Now
2. 查看 Console Output
3. 看到类似内容说明成功：

Cloning the remote Git repository
Checking out Revision xxxxx

八、常见问题排查

❌ Jenkins 找不到 git

git: command not found

✅ 检查 Git 安装路径 + Jenkins 的 Git 配置

❌ Permission denied (publickey)

✅ SSH key 没配对
✅ Jenkins 用户没有访问权限

❌ Could not read from remote repository

✅ Token 权限不足
✅ Repo 是私有的但没配置认证

九、进阶（推荐）

• ✅ Pipeline + Jenkinsfile（工业级）
• ✅ GitLab / Gitee / Bitbucket 集成
• ✅ 多分支流水线（Multibranch Pipeline）
• ✅ CI：自动编译 → 测试 → 部署

如果你愿意，我可以：

• ✅ 帮你写 Jenkinsfile
• ✅ 给你一个 完整 Pipeline 示例
• ✅ 针对 GitHub / GitLab / Gitee 单独讲

你现在用的是 GitHub、GitLab 还是 Gitee？