Terraform Cloud执行gcloud命令提示not found的原因及解决方法

问题背景 #

本地执行以下Terraform配置时正常，但在Terraform Cloud中执行报错/bin/sh: 1: gcloud: not found：

resource "null_resource" "test_gcloud" {
  provisioner "local-exec" {
    command = <<EOT
      gcloud version
    EOT
  }
}

已尝试的无效方法：

• 添加terraform-google-modules/gcloud/google模块
• 单独创建null_resource执行gcloud安装步骤（环境变量无法跨资源共享）

问题解答 #

1. 为何本地可用但Terraform Cloud中不可用？ #

• 本地环境提前安装了Google Cloud SDK，gcloud命令所在路径已加入系统PATH，因此能直接调用。
• Terraform Cloud默认使用官方提供的runner镜像，该镜像未预装Google Cloud SDK，所以找不到gcloud命令。
• 每个null_resource的local-exec在独立的Shell会话中执行，不同资源的环境变量（如PATH）不共享，因此单独安装gcloud的资源无法为后续资源提供可用环境。

2. 如何让gcloud在Terraform Cloud中可用？ #

提供三种可行方案：

方案1：使用自定义执行环境（推荐）

构建包含Google Cloud SDK的Docker镜像，替换Terraform Cloud默认的runner环境，避免每次运行临时安装：

1. 编写Dockerfile：

FROM hashicorp/terraform:latest
RUN apt-get update && apt-get install -y curl python3
RUN curl -o google-cloud-sdk.tar.gz https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-409.0.0-linux-x86_64.tar.gz && \
    tar -xvzf google-cloud-sdk.tar.gz && \
    ./google-cloud-sdk/install.sh -q && \
    rm google-cloud-sdk.tar.gz
ENV PATH="$PATH:/google-cloud-sdk/bin"

2. 构建镜像并推送到Docker Hub/GCR等容器仓库
3. 在Terraform Cloud工作区配置中，将执行模式设为Remote，并指定自定义镜像地址

方案2：在同一个null_resource中完成安装与执行

将gcloud安装命令和业务命令放在同一个local-exec中，确保环境变量在同一会话生效：

resource "null_resource" "test_gcloud" {
  provisioner "local-exec" {
    command = <<EOT
      if ! command -v gcloud &> /dev/null; then
        echo "Installing gcloud SDK..."
        curl -o google-cloud-sdk.tar.gz https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-sdk-409.0.0-linux-x86_64.tar.gz
        tar -xvzf google-cloud-sdk.tar.gz
        ./google-cloud-sdk/install.sh -q
        export PATH=\$PATH:$(pwd)/google-cloud-sdk/bin
      fi
      gcloud version
    EOT
  }
}

注意：需转义$PATH中的$符号，避免Terraform插值解析。

方案3：正确使用terraform-google-modules/gcloud模块

确保模块配置正确，并通过depends_on保证安装完成后再执行命令：

module "gcloud" {
  source  = "terraform-google-modules/gcloud/google"
  version = "~> 5.0"

  install_sdk = true
  project_id  = "你的项目ID"
}

resource "null_resource" "test_gcloud" {
  depends_on = [module.gcloud]

  provisioner "local-exec" {
    command = "gcloud version"
  }
}

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