GitLab CI/CD启用2FA后如何使用PAT构建流水线？

1. 生成GitLab个人访问令牌（PAT） #

• 登录GitLab，点击右上角头像 → 设置 → 访问令牌（Access Tokens）
• 填写令牌名称、有效期，权限勾选read_repository（仅需下载仓库的话），如需其他操作可按需添加权限
• 点击创建个人访问令牌，生成后立即复制保存，页面刷新后无法再次查看令牌内容

2. 在项目中配置CI/CD变量 #

• 进入目标GitLab项目 → 设置 → CI/CD → 变量（Variables）
• 点击添加变量，键名设为GITLAB_PAT，值粘贴刚才生成的PAT
• 勾选保护变量和掩码变量，防止令牌泄露，完成后保存

3. 修改流水线配置文件（.gitlab-ci.yml） #

根据你的下载需求，修改为以下配置（以克隆仓库为例）：

download_repo:
  script:
    # 配置Git全局凭据，后续操作自动使用PAT
    - git config --global credential.helper store
    - echo "https://oauth2:${GITLAB_PAT}@gitlab.com" > ~/.git-credentials
    # 替换为你的实际仓库地址
    - git clone https://gitlab.com/your-username/your-repo.git

替代方案（直接在克隆命令中嵌入令牌） #

如果不想配置全局凭据，也可以直接在克隆命令中使用令牌：

download_repo:
  script:
    # 替换为你的实际仓库地址
    - git clone https://oauth2:${GITLAB_PAT}@gitlab.com/your-username/your-repo.git

关键说明 #

启用2FA后，GitLab会拒绝使用账号密码进行HTTPS方式的Git操作，必须使用PAT或SSH密钥。PAT是CI/CD场景下更便捷的选择，因为可以通过变量管理，无需在流水线中硬编码敏感信息。

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