GitLab CI/CD变量无法传入Terraform的问题求助

问题概述 #

按照Terraform规则，为环境变量添加TF_VAR_前缀即可作为输入变量使用，但在GitLab CI/CD中配置TF_VAR_ibm_api_key后，执行terraform plan时仍报错提示变量未设置，且在CI任务中echo该变量无输出。

已执行的操作：

• 在GitLab项目UI中设置TF_VAR_ibm_api_key并启用掩码
• 在main.tf/variables.tf中定义ibm_api_key变量
• 在Provider配置中引用该变量
• 尝试字符串插值、指定变量类型等方法均无效

错误信息：

$ terraform plan
var.ibm_api_key
  Enter a value: ╷
│ Error: No value for required variable
│ 
│   on main.tf line 1:
│    1: variable ibm_api_key {
│ 
│ The root module input variable "ibm_api_key" is not set, and has no default
│ value. Use a -var or -var-file command line argument to provide a value for
│ this variable.
╵

排查方向与解决方案 #

1. 检查GitLab变量的作用域 #

GitLab变量的作用域决定了哪些分支、环境或项目能访问该变量：

• 若变量设置为仅受保护分支可用，但当前CI任务运行在非受保护分支上，变量不会被注入
• 若变量绑定了特定环境，需确保CI任务中指定了对应的environment字段
• 进入GitLab项目「设置」→「CI/CD」→「变量」，确认变量的作用域覆盖当前任务的运行场景

2. 验证变量是否被注入CI任务 #

由于echo ${TF_VAR_ibm_api_key}和${output_check}均无输出，说明变量未进入任务上下文：

• 在CI脚本中添加printenv命令，查看所有环境变量，确认TF_VAR_ibm_api_key是否存在
• 检查.gitlab-ci.yml中是否有覆盖变量的配置，比如variables块中重新定义了同名变量导致覆盖

3. 确认变量名称的大小写一致性 #

Terraform变量名和GitLab环境变量名均区分大小写：

• 确保GitLab中的变量名是TF_VAR_ibm_api_key（与Terraform变量ibm_api_key严格对应），没有大小写错误
• 注意：GitLab runner通常使用Linux环境，环境变量大小写敏感，需完全匹配

4. 检查GitLab CI配置的完整性 #

确保.gitlab-ci.yml中的任务配置正确：

• 任务需包含terraform plan的执行步骤，且没有额外的变量屏蔽设置
• 若使用了before_script，确保没有重置环境变量的操作

5. 临时测试：手动传递变量验证 #

在CI脚本中手动传递变量，确认Terraform本身逻辑无问题：

terraform:
  script:
    - export TF_VAR_ibm_api_key="your-test-key"
    - terraform plan

若此方法有效，说明问题出在GitLab变量的传递环节，而非Terraform代码逻辑

总结 #

核心问题是GitLab的环境变量未成功注入CI任务上下文，优先排查变量作用域、名称匹配和CI配置这三个方向。

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