如何从另一个GitLab项目引入Terraform变量配置？

针对你多个应用共用GCP项目、想集中管理config/{env}.tfvars的需求，以下是几种落地性强的方案，同时也会对你提出的两个方案做优化分析：

一、直接拉取集中仓库的tfvars文件（最直观的方案） #

在应用仓库的GitLab CI流程中，直接克隆存放变量文件的config仓库到CI环境，然后通过Terraform的-var-file参数引用这些集中管理的文件。

实现步骤： #

1. 在应用仓库的.gitlab-ci.yml中添加前置步骤，拉取config仓库：

before_script:
  # 用CI_JOB_TOKEN克隆config仓库，确保该token有读取权限
  - git clone https://gitlab-ci-token:${CI_JOB_TOKEN}@gitlab.com/your-group/central-config.git ./central-config

2. 在Terraform执行命令中直接引用变量文件：

terraform plan -var-file="./central-config/config/${ENV}.tfvars"
terraform apply -var-file="./central-config/config/${ENV}.tfvars"

注意事项： #

• 要给CI_JOB_TOKEN配置config仓库的读取权限，或者使用部署密钥替代；
• 如果需要固定变量文件版本，可以在clone时指定分支或tag：git clone ... -b v1.0.0。

二、优化你的方案1：GitLab组级变量+文件类型变量 #

你提到的用组级变量管理key=val内容的思路可以优化，利用GitLab的文件类型变量直接存储tfvars内容，避免手动维护环境文件。

实现步骤： #

1. 在GitLab组（而非单个项目）中创建文件类型变量：
   • 变量名：DEV_TFVARS，变量内容填写dev环境的tfvars内容，类型选择「File」；
   • 同理创建STAGE_TFVARS、PROD_TFVARS。
2. 在应用仓库的CI脚本中，根据环境选择对应的变量文件：

script:
  - case $ENV in
      dev) TFVARS_FILE=$DEV_TFVARS ;;
      stage) TFVARS_FILE=$STAGE_TFVARS ;;
      prod) TFVARS_FILE=$PROD_TFVARS ;;
    esac
  - terraform plan -var-file="$TFVARS_FILE"

优势： #

• 变量集中在组级别管理，所有子项目都能继承；
• 无需维护额外的变量文件仓库，权限由GitLab统一管控。

三、落地你的方案2：Terraform模块实现变量映射 #

用Terraform模块集中管理变量逻辑是合理的，适合需要动态生成变量或有复杂环境关联规则的场景。

实现步骤： #

1. 在config仓库中创建变量模块，比如modules/env-vars：

variable "environment" {
  type        = string
  description = "目标环境（dev/stage/prod）"
}

output "project_id" {
  type  = string
  value = {
    dev   = "gcp-dev-project-123"
    stage = "gcp-stage-project-456"
    prod  = "gcp-prod-project-789"
  }[var.environment]
}

# 其他需要集中管理的变量（如项目编号）同理添加output

2. 在应用仓库的Terraform代码中引用该模块：

module "central_env_vars" {
  # 方式1：CI中拉取config仓库后，用本地路径引用
  source = "../central-config/modules/env-vars"
  # 方式2：直接通过GitLab仓库地址引用（需确保权限）
  # source = "git::https://gitlab.com/your-group/central-config.git//modules/env-vars?ref=main"

  environment = terraform.workspace # 或通过输入参数传入环境值
}

# 使用模块输出的变量
resource "google_project" "app" {
  project_id = module.central_env_vars.project_id
  # 其他资源配置...
}

优势： #

• 变量逻辑集中维护，应用仓库无需关心具体变量值；
• 支持通过Terraform工作区（TF_WORKSPACE）或输入参数动态切换环境。

四、GitLab Managed Terraform变量集（进阶方案） #

如果你们使用GitLab的内置Terraform集成（GitLab Managed Terraform），可以用变量集功能：

1. 在GitLab中创建环境专属的变量集，添加项目ID、编号等变量；
2. 将变量集关联到各个应用的Terraform工作区；
3. Terraform在执行时会自动加载变量集中的变量，无需额外配置。

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