如何仅通过GitLab API Token配置Jenkins构建任务对接GitLab？

完全可以用GitLab API Token替代用户名密码来配置Jenkins任务，既能解决员工离职后批量修改流水线的隐患，也能更安全地控制权限。下面是具体操作步骤和问题排查：

1. 确认GitLab API Token的权限 #

先确保你的GitLab API Token拥有对应仓库的必要权限：

• 仅拉取代码的话，需要read_repository权限
• 如果涉及推送代码、触发GitLab流水线等操作，需额外添加write_repository或对应权限
  （创建Token时在GitLab的「个人访问令牌」或「项目访问令牌」里勾选对应权限即可）

2. 在Jenkins中正确添加GitLab API Token凭据 #

• 进入Jenkins后台，依次点击「系统管理」→「凭据」→「系统」→「全局凭据」（或按项目分组添加到对应文件夹）
• 点击「添加凭据」，类型选择GitLab API Token（找不到这个选项的话，检查GitLab插件是否安装正确、版本是否兼容Jenkins）
• 输入Token值，设置一个好记的凭据ID（比如proj-x-gitlab-read-token），填写描述后保存

3. 配置Jenkins任务使用Token凭据 #

自由风格任务 #

在「源码管理」的Git模块中：

• 点击「添加」→「Jenkins」，在弹出的凭据列表里选择你刚创建的GitLab API Token
• 替换掉原来默认的测试用用户名密码凭据，确认后保存任务

流水线任务（Jenkinsfile） #

直接在脚本中指定凭据ID，示例：

pipeline {
    agent any
    stages {
        stage('拉取代码') {
            steps {
                git url: 'https://gitlab.example.com/your/project.git',
                    credentialsId: 'proj-x-gitlab-read-token',
                    branch: 'main'
            }
        }
    }
}

4. 解决「添加新凭据无法保存」的问题 #

• 检查GitLab插件版本：旧版本可能存在兼容性bug，升级到最新稳定版再试
• 核对Token输入：确保没有多余空格或字符，复制粘贴时不要带换行
• 排查任务配置错误：如果是任务中替换凭据后无法保存，往下翻页面看是否有隐藏的必填项未填写，导致保存失败

批量优化建议 #

可以将通用的GitLab Token凭据设置为全局默认，或者按项目分组使用「凭据文件夹」，后续如果需要更新Token，只修改对应凭据即可，无需逐个调整流水线。

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