Terraform构建Docker镜像遇403错误，求优于降级的修复方案

问题背景 #

在MacOS 15.0.1、Terraform 1.7.3、Docker Desktop 4.35.1、Docker Engine 24.0.2环境下，使用kreuzwerker/docker Provider 3.0.2构建Docker镜像时触发以下错误：

Error: failed to read downloaded context: failed to load cache key: invalid response status 403

极简复现配置如下：

providers.tf：

terraform {
  required_providers {
    docker = {
      source  = "kreuzwerker/docker"
      version = "3.0.2"
    }
    google = {
      source  = "hashicorp/google"
      version = "5.40.0"
    }
     google-beta = {
      source  = "hashicorp/google-beta"
      version = "5.19.0"
    }
  }
}

main.tf：

resource "docker_image" "my_image" {
  name         = "my_docker_image:latest"
  build {
    context    = "./app"
    dockerfile = "Dockerfile"
  }
}

./app/Dockerfile：

# syntax=docker/dockerfile:1.10
FROM nginx:latest
COPY index.html /usr/share/nginx/html/index.html

./app/index.html：

<!DOCTYPE html>
<html>
<body>
    <h1>Hello from Terraform-built Docker container!</h1>
</body>
</html>

现有临时方案 #

通过降级Docker Desktop到4.31.0、Docker Engine到26.1.4可规避问题，但这并非长期最优解。

更优修复方案 #

方案1：使用local-exec直接调用Docker CLI（推荐） #

绕过Terraform Docker Provider的兼容性限制，直接使用本地Docker命令构建镜像，同时通过触发器保证文件变更时自动重建：

修改main.tf为：

resource "null_resource" "build_docker_image" {
  # 监听Dockerfile和index.html的内容变化，触发重建
  triggers = {
    dockerfile_hash = filemd5("./app/Dockerfile")
    index_html_hash = filemd5("./app/index.html")
  }

  provisioner "local-exec" {
    command = "docker build -t my_docker_image:latest ./app"
  }
}

该方案完全依赖本地Docker CLI，兼容性与Docker版本同步，不受Terraform Provider维护状态影响。

方案2：升级kreuzwerker/docker Provider到最新兼容版本 #

若kreuzwerker/docker Provider仍有更新，尝试升级到最新版本，部分新版本可能修复了与Docker新API的兼容性问题：

修改providers.tf中的Docker Provider版本：

terraform {
  required_providers {
    docker = {
      source  = "kreuzwerker/docker"
      version = "3.0.3" # 替换为最新可用版本
    }
    # 其他Provider配置保持不变
  }
}

执行terraform init -upgrade升级Provider后重新尝试构建。

总结 #

降级Docker版本是临时 workaround，长期来看推荐使用local-exec直接调用Docker CLI，避免Provider维护停滞带来的兼容性风险；若项目依赖官方教程的Provider使用方式，可优先尝试升级Provider到最新版本验证修复效果。

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