如何在Terraform Kubernetes中引用Docker Desktop本地镜像

核心原因 #

你的Pod卡顿是因为Kubernetes默认会尝试从Docker Hub拉取backendnodejs:0.0.1镜像，即使本地已经存在，这是因为没有设置正确的镜像拉取策略。

具体修复步骤 #

1. 设置镜像拉取策略 #

在kubernetes_pod的container块中添加image_pull_policy参数，值设为IfNotPresent（本地存在则直接使用，不存在才去远程拉取）或者Never（完全只使用本地镜像，不从远程拉取）。推荐使用IfNotPresent，兼顾灵活性和本地开发需求。

修改后的Pod资源代码：

resource "kubernetes_pod" "test" {
  metadata {
    name = "backend-api"
    labels = {
      app = "MyNodeJsApp"
    }
  }
  spec {
    container {
      image = "backendnodejs:0.0.1"
      name = "backendnodejs-container"
      # 添加镜像拉取策略
      image_pull_policy = "IfNotPresent"
      port {
        container_port = 5000
      }
    }
  }
}

2. 确认本地镜像可被K8s节点访问 #

Docker Desktop内置的K8s是单节点集群，本地构建的镜像默认会被节点直接识别，无需额外导入操作。如果不放心，可以用以下命令验证：

# 查看本地是否存在目标镜像
docker images | grep backendnodejs

3. 重新应用Terraform配置 #

执行命令更新K8s资源：

terraform apply

额外说明 #

• 若使用image_pull_policy = "Never"，K8s会完全依赖本地镜像，本地不存在时会直接启动失败，适合纯离线开发场景。
• 后续若要将镜像推送到私有仓库或Docker Hub，只需把image字段改为仓库完整地址（比如your-docker-username/backendnodejs:0.0.1），保留IfNotPresent策略即可。

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