Azure DevOps Pipeline中Terraform工作区创建与使用问题咨询

场景与问题 #

已为Azure云环境构建Terraform IaC模块，正在配置Azure Pipelines发布流程，Dev环境的terraform init/validate/plan/apply任务已配置完成。需要基于Terraform工作区实现dev、test、prod多环境部署，但通过经典编辑器创建的工作区任务未达预期效果，尝试用流水线变量结合TF_WORKSPACE环境变量配置，需明确正确的YAML实现方式。

正确的YAML配置步骤 #

1. 定义工作区变量 #

在流水线中定义对应环境的工作区名称变量，可通过YAML直接定义或在Azure DevOps流水线变量面板配置：

variables:
  # 可根据不同环境（dev/test/prod）替换该值，或通过流水线变量组动态传入
  TF_WORKSPACE: 'Development'

2. 创建工作区（若不存在） #

使用TerraformCLI任务执行workspace new命令，开启skipExistingWorkspace避免已存在时报错：

steps:
- task: charleszipp.azure-pipelines-tasks-terraform.azure-pipelines-tasks-terraform-cli.TerraformCLI@0
  displayName: '创建Terraform工作区'
  inputs:
    command: workspace
    workingDirectory: '$(System.DefaultWorkingDirectory)/Project-Name/drop/Terraform'
    workspaceSubCommand: new
    workspaceName: '$(TF_WORKSPACE)'
    skipExistingWorkspace: true

3. 选择目标工作区 #

执行workspace select命令切换到指定工作区，确保后续Terraform操作基于该工作区执行：

- task: charleszipp.azure-pipelines-tasks-terraform.azure-pipelines-tasks-terraform-cli.TerraformCLI@0
  displayName: '选择Terraform工作区'
  inputs:
    command: workspace
    workingDirectory: '$(System.DefaultWorkingDirectory)/Project-Name/drop/Terraform'
    workspaceSubCommand: select
    workspaceName: '$(TF_WORKSPACE)'

4. 后续Terraform任务 #

完成工作区选择后，后续的init/validate/plan/apply任务会自动使用当前选中的工作区，无需额外配置：

- task: charleszipp.azure-pipelines-tasks-terraform.azure-pipelines-tasks-terraform-cli.TerraformCLI@0
  displayName: 'Terraform Init'
  inputs:
    command: init
    workingDirectory: '$(System.DefaultWorkingDirectory)/Project-Name/drop/Terraform'

- task: charleszipp.azure-pipelines-tasks-terraform.azure-pipelines-tasks-terraform-cli.TerraformCLI@0
  displayName: 'Terraform Validate'
  inputs:
    command: validate
    workingDirectory: '$(System.DefaultWorkingDirectory)/Project-Name/drop/Terraform'

- task: charleszipp.azure-pipelines-tasks-terraform.azure-pipelines-tasks-terraform-cli.TerraformCLI@0
  displayName: 'Terraform Plan'
  inputs:
    command: plan
    workingDirectory: '$(System.DefaultWorkingDirectory)/Project-Name/drop/Terraform'

- task: charleszipp.azure-pipelines-tasks-terraform.azure-pipelines-tasks-terraform-cli.TerraformCLI@0
  displayName: 'Terraform Apply'
  inputs:
    command: apply
    workingDirectory: '$(System.DefaultWorkingDirectory)/Project-Name/drop/Terraform'
    autoApprove: true

关键注意事项 #

• 原示例中workspaceName参数错误使用'-TF_WORKSPACE $(TF_WORKSPACE)'，需直接传入工作区名称变量$(TF_WORKSPACE)即可。
• 多环境部署时，可通过Azure DevOps的**阶段（Stage）**配合变量组，为每个环境传入对应的TF_WORKSPACE值，实现一套流水线适配多环境。
• 确保Terraform状态文件存储配置（如Azure Blob Storage）已正确设置，不同工作区会自动隔离状态文件。

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