Google Cloud Deploy的images参数未生效，镜像标签未替换求助

1. 本地验证Skaffold镜像替换是否生效 #

先绕开Cloud Deploy，在本地执行Skaffold渲染命令，测试镜像替换逻辑是否正常：

skaffold render --images "nginx-base=us-central1-docker.pkg.dev/registry/nginx/base:<实际TAG值>" --skaffold-file path/to/skaffold.yaml

如果本地渲染后的Deployment镜像标签仍未更新，说明问题出在Skaffold配置上，与Cloud Deploy无关。

2. 检查Skaffold配置关键项 #

（1）匹配Artifact与替换参数 #

你的Skaffold.yaml中必须定义对应nginx-base的artifact，示例配置：

apiVersion: skaffold/v4beta6
kind: Config
build:
  artifacts:
  - image: nginx-base  # 此处名称需与--images参数中的容器名/镜像名完全一致
    context: .
deploy:
  kubectl:
    manifests:
    - path/to/your/deployment.yaml

如果Skaffold中用完整镜像路径作为artifact名称，那么--images参数需使用完整旧镜像地址：

--images "us-central1-docker.pkg.dev/registry/nginx/base:latest=us-central1-docker.pkg.dev/registry/nginx/base:<实际TAG值>"

（2）确保渲染器支持镜像替换 #

若使用Kustomize作为渲染器，需在kustomization.yaml中声明镜像字段，允许Skaffold替换：

images:
- name: us-central1-docker.pkg.dev/registry/nginx/base
  newTag: latest  # 该值会被Cloud Deploy传入的参数覆盖

若使用Helm，需在values.yaml中将镜像标签设为可替换变量：

nginx:
  image:
    repository: us-central1-docker.pkg.dev/registry/nginx/base
    tag: latest

再通过Skaffold.yaml配置Helm的values映射，确保Cloud Deploy的--images参数能覆盖该变量。

3. 检查Cloud Deploy命令参数正确性 #

• 确认<IMAGE TAG>已替换为实际标签值（如v1.0.0），而非保留占位符；若通过脚本变量传入，需确保变量已正确赋值。
• 使用old-image=new-image格式时，旧镜像地址必须与Deployment中完全一致，包括latest标签，不能省略。

4. 查看Cloud Deploy发布日志 #

在Cloud Deploy控制台查看该发布的渲染阶段日志，搜索镜像替换相关输出，确认是否存在“找不到对应artifact”“替换规则不匹配”等错误提示。

内容的提问来源于stack exchange，提问作者Bob G Ruffenhouser