Azure DevOps发布流水线Terraform plan/apply架构加载失败求助

问题分析 #

构建流水线可正常执行terraform plan，但发布流水线中执行时出现插件架构加载错误，且命令似乎从/usr/local/bin而非指定工作目录执行，核心原因大概率是发布流水线的工件路径配置、目录结构完整性或Terraform插件初始化逻辑存在问题。

修复步骤 #

1. 动态配置工作目录，避免硬编码路径 #

放弃手动指定绝对路径，改用发布流水线内置变量$(System.ArtifactsDirectory)动态获取工件根目录，确保路径适配不同代理环境：

steps:
- task: ms-devlabs.custom-terraform-tasks.custom-terraform-release-task.TerraformTaskV3@3
  displayName: 'terraform plan'
  inputs:
    provider: aws
    command: plan
    workingDirectory: '$(System.ArtifactsDirectory)/_terraform/TerraformModule/Projects/Potentium/Prod'
    environmentServiceNameAWS: 'AWS-Terraform-Build'

2. 验证工件目录结构完整性 #

在terraform plan步骤前添加目录检查命令，确认所有Terraform配置文件和初始化后的插件目录存在：

ls -la $(System.ArtifactsDirectory)/_terraform/TerraformModule/Projects/Potentium/Prod
ls -la $(System.ArtifactsDirectory)/_terraform/TerraformModule/Projects/Potentium/Prod/.terraform

3. 确保init与plan步骤使用相同工作目录 #

发布流水线中terraform init必须和后续plan/apply使用完全一致的工作目录，保证插件下载到正确路径：

steps:
- task: ms-devlabs.custom-terraform-tasks.custom-terraform-release-task.TerraformTaskV3@3
  displayName: 'terraform init'
  inputs:
    provider: aws
    command: init
    workingDirectory: '$(System.ArtifactsDirectory)/_terraform/TerraformModule/Projects/Potentium/Prod'
    environmentServiceNameAWS: 'AWS-Terraform-Build'

- task: ms-devlabs.custom-terraform-tasks.custom-terraform-release-task.TerraformTaskV3@3
  displayName: 'terraform plan'
  inputs:
    provider: aws
    command: plan
    workingDirectory: '$(System.ArtifactsDirectory)/_terraform/TerraformModule/Projects/Potentium/Prod'
    environmentServiceNameAWS: 'AWS-Terraform-Build'

4. 检查工件下载任务配置 #

确认发布流水线的DownloadBuildArtifacts任务完整下载所有文件，未遗漏.terraform或其他隐藏目录（若构建时包含了这些目录）：

steps:
- task: DownloadBuildArtifacts@0
  displayName: 'Download Build Artifacts'
  inputs:
    buildType: 'current'
    downloadType: 'single'
    artifactName: 'TerraformModule'
    downloadPath: '$(System.ArtifactsDirectory)/_terraform'

5. 强制Terraform使用工作目录内的插件 #

在Terraform配置文件或任务中指定plugin_cache_dir，确保插件从工作目录的缓存加载：

# 在terraform plan步骤中添加额外参数
- task: ms-devlabs.custom-terraform-tasks.custom-terraform-release-task.TerraformTaskV3@3
  displayName: 'terraform plan'
  inputs:
    provider: aws
    command: plan
    workingDirectory: '$(System.ArtifactsDirectory)/_terraform/TerraformModule/Projects/Potentium/Prod'
    environmentServiceNameAWS: 'AWS-Terraform-Build'
    commandOptions: '-plugin-cache-dir=$(System.ArtifactsDirectory)/_terraform/TerraformModule/Projects/Potentium/Prod/.terraform/plugin-cache'

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