如何在GitLab CI任务中使用GitHub PAT实现TFLint认证

核心原理 #

TFLint拉取插件时，会自动读取环境变量GITHUB_TOKEN或GITHUB_ACCESS_TOKEN作为GitHub API的认证凭据，以此提升速率限制额度，不需要在命令行直接传递令牌参数。

配置步骤 #

1. 在GitLab项目中添加CI/CD变量

   • 进入项目的「Settings」>「CI/CD」>「Variables」页面
   • 新建变量：
     • 键名填GITHUB_TOKEN
     • 值填入你的GitHub个人访问令牌（PAT）
     • 勾选「Mask variable」隐藏敏感内容，按需勾选「Protect variable」限制仅在受保护分支运行时可用

2. 修改GitLab CI Job配置
   无需修改tflint --init命令，只需确保环境变量能被注入到Job中，修改后的配置示例：

lint:
  stage: Code Quality
  needs: []
  image:
    name: ghcr.io/terraform-linters/tflint:latest # 替换为你实际使用的TFLint镜像
  variables:
    GITHUB_TOKEN: $GITHUB_TOKEN # 自动继承GitLab项目中配置的同名变量
  script:
    - tflint --init -c .tflint.hcl

注意事项 #

• GitHub PAT仅需授予public_repo权限即可拉取公开插件仓库，若使用私有插件则需对应权限
• 确保使用的TFLint镜像版本为v0.30.0及以上（该版本开始支持通过环境变量读取GitHub令牌）

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