使用Kubernetes Kustomization无法覆盖端口值的问题求助

问题重现 #

尝试通过Kustomization的JSON Patch修改Service端口值时，出现报错：

replace operation does not apply: doc is missing key: /spec/ports/port: missing value.

使用的Patch配置：

patches:
  - target:
      kind: Service
      name: cdq-ui-service
    patch: |
      - op: replace
        path: /spec/ports/0/port
        value: 8080

错误原因 #

报错提示/spec/ports/port路径不存在，结合你的Patch路径/spec/ports/0/port，核心原因有两种：

1. 目标Service的spec.ports数组为空，或者数组第一个元素（索引0）没有port字段，导致replace操作找不到修改目标；
2. Kustomize对JSON Patch的路径解析出现匹配偏差，或原资源的ports结构不符合预期。

解决方案 #

1. 先确认原Service的结构 #

执行命令查看目标Service的完整YAML，重点检查spec.ports部分：

kubectl get service cdq-ui-service -o yaml

根据输出结果调整后续操作。

2. 针对空ports数组（添加端口） #

如果原Service未定义任何端口，改用add操作向数组添加端口：

patches:
  - target:
      kind: Service
      name: cdq-ui-service
    patch: |
      - op: add
        path: /spec/ports/-
        value:
          port: 8080
          targetPort: 8080  # 对应后端容器端口，按需填写
          protocol: TCP

3. 使用Strategic Merge Patch（更推荐） #

相比JSON Patch，Kubernetes的Strategic Merge Patch更适配资源修改，写法简洁直观：

patches:
  - target:
      kind: Service
      name: cdq-ui-service
    patch: |
      spec:
        ports:
        - port: 8080

该写法会自动合并原ports数组的第一个元素，覆盖port字段值。若需完全替换整个ports数组，添加$patch: replace标识：

patches:
  - target:
      kind: Service
      name: cdq-ui-service
    patch: |
      $patch: replace
      spec:
        ports:
        - port: 8080
          targetPort: 8080
          protocol: TCP

4. 修正JSON Patch的适配问题 #

若坚持使用JSON Patch，需确保原Service的spec.ports[0].port确实存在。比如原结构为：

spec:
  ports:
  - port: 80
    targetPort: 8080

此时你的原始Patch写法是正确的，若仍报错，建议升级Kustomize到较新版本，规避版本兼容问题。

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