无需推送至容器镜像仓库，部署本地镜像至Gcloud Kubectl可行吗？

这是个很常见的误解——GKE的集群节点和你的本地机器是完全独立的环境。你的本地Docker镜像只存在于你自己的电脑上，而GKE的节点是Google运行在云端的虚拟机，它们根本访问不到你本地的镜像仓库或本地镜像文件。当Kubernetes调度Pod到某个节点时，它会先检查该节点是否已经有指定的镜像，如果没有，就会默认尝试从公开或配置的私有镜像仓库拉取，这就是你看到报错的原因。

下面是两种可行的方案，适合不同的场景：

方案1：手动同步本地镜像到GKE节点（适合小规模测试） #

这个方法需要你把本地镜像复制到每个GKE节点上，然后告诉Kubernetes直接使用节点上的镜像：

• 第一步：把本地镜像导出为tar包

  docker save -o my-app-image.tar your-local-image:latest
  

• 第二步：获取GKE节点的SSH访问权限（在GCP控制台的GKE集群详情里，找到节点池，开启节点的SSH访问）
• 第三步：将tar包上传到每个节点

  # 替换成你的节点名称和项目ID
  gcloud compute scp my-app-image.tar gke-your-cluster-123-node-pool-abc:/tmp/ --project=your-gcp-project-id
  

• 第四步：登录节点并加载镜像

  gcloud compute ssh gke-your-cluster-123-node-pool-abc --project=your-gcp-project-id
  docker load -i /tmp/my-app-image.tar
  

• 第五步：部署时添加imagePullPolicy: Never
  编写Deployment YAML时，指定这个参数，告诉Kubernetes不要去仓库拉取镜像：

  apiVersion: apps/v1
  kind: Deployment
  metadata:
    name: my-app-deployment
  spec:
    replicas: 1
    selector:
      matchLabels:
        app: my-app
    template:
      metadata:
        labels:
          app: my-app
      spec:
        containers:
        - name: my-app-container
          image: your-local-image:latest
          imagePullPolicy: Never  # 关键配置，禁止拉取镜像
  

  注意：如果你的集群有多个节点，必须把镜像同步到所有可能调度Pod的节点上，否则Pod会因为找不到镜像而启动失败。

方案2：用Cloud Build直接从本地构建到GCR（无需手动推送） #

虽然你不想手动执行docker push，但这个方法可以让你跳过本地推送步骤，直接用Google Cloud Build工具把本地镜像（或Dockerfile）构建并上传到GCR，过程更自动化且稳定：

• 第一步：安装Cloud Build本地工具并配置Docker授权

  gcloud components install cloud-build-local
  gcloud auth configure-docker gcr.io
  

• 第二步：直接从本地构建并推送
  如果你的镜像基于本地Dockerfile：

  # 替换成你的项目ID和镜像标签
  cloud-build-local --push -t gcr.io/your-gcp-project-id/my-app-image:latest .
  

  如果已经有本地镜像，先给它打GCR标签再推送：

  docker tag your-local-image:latest gcr.io/your-gcp-project-id/my-app-image:latest
  cloud-build-local --push -t gcr.io/your-gcp-project-id/my-app-image:latest .
  

• 第三步：用GCR镜像部署到GKE
  现在你可以直接使用GCR的镜像地址部署，这也是GKE官方推荐的方式，避免了手动同步节点的繁琐。

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