GitLab存储Terraform状态时无法创建Terraform工作区

问题本质 #

你当前通过在STATE_ADDR中拼接${WORKSPACE}_${PROJECT}来区分不同环境的状态，这种模式下，GitLab的HTTP后端并不支持Terraform原生的Workspace命令。原因是Terraform Workspace要求后端实现命名状态的管理接口（创建、列表、切换），而GitLab的HTTP状态存储仅提供单状态文件的读写/锁操作，没有实现Workspace所需的多状态管理API，因此会报错Failed to get configured named states: workspaces not supported。

解决方案 #

方案1：继续使用现有HTTP后端，改用环境变量切换环境（无需Workspace命令） #

你的初始化脚本已经通过WORKSPACE变量实现了多环境状态隔离，不需要依赖Terraform原生Workspace命令。操作步骤：

1. 创建新环境时，直接设置WORKSPACE变量并重新初始化：

   export WORKSPACE=my-new-env
   ./terraform_init.sh
   

2. 切换环境时，同样设置对应WORKSPACE变量后重新执行初始化脚本即可。

这种方式的核心是：每个环境对应GitLab上一个独立的state文件（通过地址中的${WORKSPACE}区分），Terraform会将状态存储到对应路径，实现环境隔离。

方案2：改用GitLab原生Terraform后端，支持Workspace命令 #

GitLab EE 15.7.5已经支持gitlab类型的Terraform后端，该后端原生集成GitLab的Workspace管理，可直接使用Terraform Workspace命令。

步骤1：修改backend.tf配置

替换原有的http后端为gitlab后端：

terraform {
  backend "gitlab" {
    project        = "my-project-name"  # 你的GitLab项目名称或ID
    id             = "${terraform.workspace}"  # 用Terraform workspace名称作为state标识
    base_url       = "https://my.gitlab.local"  # 你的GitLab实例地址
    lock_method    = "POST"
    unlock_method  = "DELETE"
    retry_wait_min = 5
  }
}

步骤2：初始化后端

通过环境变量或-backend-config传递GitLab访问令牌：

terraform init \
  -backend-config="token=$GIT_ACCESS_TOKEN"

步骤3：使用Workspace命令

现在可以正常执行Workspace操作：

terraform workspace new my-env
terraform workspace select my-env

注意事项 #

• 使用gitlab后端时，确保你的GitLab用户拥有项目维护者或所有者权限，以管理Terraform状态。
• 方案1无需修改后端配置，适合保持现有工作流；方案2更贴合Terraform原生Workspace体验，适合统一管理多环境状态。

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