使用Kustomize替换Deployment中RAILS_ENV变量时路径缺失报错

你遇到的doc is missing path错误，核心是Kustomize无法通过你写的名称匹配路径找到对应的环境变量节点，常见的路径写法问题有这几个：

1. 未正确处理容器数组的遍历 #

Deployment里的containers是数组类型，直接写/spec/template/spec/containers/env[name="RAILS_ENV"]/value的话，Kustomize不知道要定位数组里的哪个容器，必须加上遍历符号或指定容器名称：

• 错误写法：/spec/template/spec/containers/env[name="RAILS_ENV"]/value
• 正确写法（匹配所有容器内的RAILS_ENV）：/spec/template/spec/containers[*]/env[name="RAILS_ENV"]/value
• 正确写法（仅匹配指定名称的容器）：/spec/template/spec/containers[name="你的容器名"]/env[name="RAILS_ENV"]/value

2. 环境变量的匹配语法错误 #

Kustomize的JSON路径中，匹配数组元素的属性必须用[key="value"]的格式，双引号不能省略，也不能用点直接访问数组元素的属性：

• 错误写法：/spec/template/spec/containers[*]/env[name=RAILS_ENV]/value（缺少双引号）
• 错误写法：/spec/template/spec/containers[*]/env/RAILS_ENV/value（用点访问数组元素属性的错误方式）
• 正确写法：/spec/template/spec/containers[*]/env[name="RAILS_ENV"]/value

3. 路径层级拼写或结构错误 #

仔细核对Deployment的实际YAML结构，比如是否把template误写为templates，或是多写/漏写了spec层级。比如Deployment的标准结构中，containers位于spec.template.spec之下，要是路径写成/spec/spec/containers[*]/env[name="RAILS_ENV"]/value，就必然找不到节点。

正确的补丁示例 #

假设你的Deployment名为my-rails-app，容器名称是rails-container，kustomization.yaml里的补丁可按如下写法配置：

patches:
- target:
    kind: Deployment
    name: my-rails-app
  patch: |-
    - op: replace
      path: /spec/template/spec/containers[name="rails-container"]/env[name="RAILS_ENV"]/value
      value: staging

如果想批量替换所有容器内的RAILS_ENV，把容器匹配规则改成[*]即可：

patches:
- target:
    kind: Deployment
    name: my-rails-app
  patch: |-
    - op: replace
      path: /spec/template/spec/containers[*]/env[name="RAILS_ENV"]/value
      value: staging

快速验证方法 #

用kubectl kustomize . --dry-run=client预览补丁效果，确认是否能正确替换；或是用kubectl get deploy <你的Deployment名称> -o yaml导出实际结构，和你的路径逐一对照。

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