Jenkins与GitLab集成实战：HTTP与SSH凭证配置详解

1. 为什么你的Jenkins总是拉不到GitLab的代码？

我见过太多团队在搭建CI/CD流水线时，卡在第一步——让Jenkins从GitLab上拉取代码。要么是报“Permission denied”，要么是“Authentication failed”，折腾半天，项目还没开始构建，热情就先被浇灭了。其实，问题的核心九成九都出在凭证（Credentials） 配置上。Jenkins和GitLab就像两个需要握手的伙伴，凭证就是他们确认彼此身份的“暗号”。用错了暗号，或者暗号没传到位，合作自然就黄了。

简单来说，集成Jenkins和GitLab，主流就两条路：HTTP/HTTPS 和 SSH。你可以把HTTP方式想象成去一个需要门禁卡的大楼，每次进门（拉取代码）都需要刷一下你的工牌（用户名和密码）。而SSH方式则像是你拥有了一把独一无二的物理钥匙（密钥对），把钥匙复制一份给大楼物业（GitLab），以后你每次来，用钥匙开门就行，不用再掏工牌。

这篇文章，我就以自己踩过无数次坑的经验，带你手把手搞定这两种方式的配置。我们不谈空洞的理论，直接上实战操作，目标是让你看完就能在自己的环境里配通，让代码自动跑起来。

2. 环境准备：装好“翻译官”和“通信员”

在开始配置凭证之前，我们得确保Jenkins具备和GitLab“对话”的基本能力。这主要靠两个东西：Git命令行工具 和 Jenkins的Git插件。

2.1 安装Git：让Jenkins会说“Git语言”

Jenkins本身不会操作Git仓库，它需要调用外部的Git客户端。所以，第一步就是在运行Jenkins的服务器（无论是物理机、虚拟机还是容器）上安装Git。

对于Linux系统（如Ubuntu/CentOS），安装非常简单，一行命令搞定：

# Ubuntu/Debian
sudo apt-get update
sudo apt-get install git -y

# CentOS/RHEL
sudo yum install git -y

安装完成后，在终端输入 git --version 验证一下。记住Git的安装路径，通常执行文件在 /usr/bin/git，这个路径稍后需要在Jenkins中配置。

对于Windows系统，你需要去Git官网下载安装包。安装时有个关键点：在“Adjusting your PATH environment”这一步，建议选择“Git from the command line and also from 3rd-party software”。这个选项会把Git添加到系统PATH，并且允许像Jenkins这样的第三方软件调用它。安装完成后，同样在CMD里用 git --version 检查。安装路径通常是 C:\Program Files\Git\bin\git.exe，这个路径我们后面会用到。

2.2 安装Jenkins插件：安装“GitLab沟通模块”

光有Git还不够，Jenkins需要专门的插件来理解GitLab的协议和功能。登录你的Jenkins后台，点击 “系统管理” -> “插件管理”。

在“可选插件”标签页中，搜索并安装以下两个核心插件：

1. Git plugin：这是Jenkins支持Git操作的基础插件，没有它，任何Git相关配置都无法进行。
2. GitLab Plugin（可选但强烈推荐）：这个插件提供了更强大的GitLab集成功能，比如触发构建（GitLab Webhook）、在Jenkins中显示GitLab的合并请求状态等。对于简单的拉取代码，基础Git插件已足够，但为了后续扩展，我建议一并安装。

安装插件后，务必重启Jenkins服务，让插件生效。重启方法取决于你的安装方式，如果是War包运行，直接关闭再启动进程；如果是系统服务，可以执行 sudo systemctl restart jenkins（Linux）或在服务管理器中重启（Windows）。

3. HTTP/HTTPS凭证配置：使用用户名和密码

HTTP方式是最直观的，它使用你在GitLab网页上登录的账号和密码。这种方式配置简单，适合个人项目或初期快速搭建。但请注意，如果你的G