在 CentOS 上使用 Jenkins 集成 Git,通常分为 安装配置 和 任务配置 两部分。下面给你一个实战可落地的步骤指南。
一、前置条件
- 已安装 CentOS 7 / 8
- 已安装 JDK(推荐 JDK 8 或 11)
- 已安装 Jenkins
- 已安装 Git
二、安装 Git(CentOS)
yum install -y git
验证:
git --version
三、Jenkins 安装 Git 插件
- 登录 Jenkins
- 进入
Manage Jenkins → Manage Plugins → Available
- 搜索 Git
- 安装以下插件(通常默认已装):
- Git plugin
- Git client plugin
- 安装完成后重启 Jenkins
四、配置 Jenkins 全局 Git
1. 配置 Git 路径
Manage Jenkins → Global Tool Configuration
- 找到 Git
- 勾选 Add Git
- Name:
Default
- Path to Git executable:
/usr/bin/git
可通过 which git 查看路径
2.(可选)配置 Git 凭据
如果是 私有仓库,需要配置账号或 SSH Key。
方式一:用户名 + 密码(HTTPS)
- Manage Jenkins → Manage Credentials
- 添加:
- 类型:Username with password
- 用户名:git 用户名
- 密码:git 密码
方式二:SSH Key(推荐)
ssh-keygen -t rsa -C "jenkins@centos"
- 将
~/.ssh/id_rsa.pub 添加到 Git 仓库(GitHub / GitLab)
- Jenkins 中添加:
- 类型:SSH Username with private key
- Private Key:粘贴
id_rsa
五、创建 Jenkins 任务并集成 Git
1. 新建任务
- 点击 New Item
- 输入名称
- 选择 Freestyle project
2. 配置源码管理(Git)
在任务配置页面:
Source Code Management
3. 构建触发器(可选)
常见方式:
- Poll SCM
H/5 * * * *
- 或 GitLab / GitHub Webhook(推荐)
4. 构建步骤(示例)
echo "Pull code success"
ls
或执行脚本:
sh build.sh
六、测试运行
- 点击 Build Now
- 查看 Console Output
- 成功拉取 Git 代码即集成完成
七、常见问题
1. git not found
which git
并在 Jenkins 中正确配置 Git 路径
2. Permission denied (publickey)
- 确认 Jenkins 用户有 SSH Key
- 或直接用 HTTPS + 账号密码
3. Jenkins 用户无权限
chown -R jenkins:jenkins /var/lib/jenkins
八、典型使用场景
✅ 自动拉取代码
✅ 结合 Maven / Node 构建
✅ 配合 Webhook 自动部署
✅ CI/CD 流水线
如果你需要:
- Jenkins + GitLab Webhook
- Pipeline 方式集成 Git
- 多分支构建
可以告诉我你的具体场景,我可以直接给你 可用配置示例。