如何使用单个kubectl命令批量Patch多种Kubernetes资源？

问题回顾 #

尝试批量Patch Deployment和ReplicaSet资源，编写了patch_list_changes.yaml，但执行以下命令均失败：

错误命令1 #

kubectl patch -f patch_list_changes.yaml --patch-file patch_list_changes.yaml

输出错误：

deployment.apps/custom-metric-sd patched
Error from server (BadRequest): the name of the object (custom-metric-sd) does not match the name on the URL (frontend)

错误命令2 #

kubectl apply -f patch_list_changes.yaml

输出错误：

error: error validating "patch_list_changes.yaml": error validating data: [ValidationError(Deployment.spec.template.spec): unknown field "resources" in io.k8s.api.core.v1.PodSpec, ValidationError(Deployment.spec): missing required field "selector" in io.k8s.api.apps.v1.DeploymentSpec]; if you choose to ignore these errors, turn validation off with --validate=false

错误原因分析 #

1. kubectl patch用法错误：
   -f参数用来指定目标资源清单，但同时用--patch-file传入同一个文件时，kubectl处理多资源YAML会复用第一个资源的元数据（如名称）到后续请求，导致第二个ReplicaSet的名称匹配失败。

2. kubectl apply不适用Patch场景：
   apply要求YAML是完整的资源定义，你的文件存在两个问题：

   • resources字段缩进错误：它属于容器级配置，应放在containers条目下，而非PodSpec层级
   • Deployment缺少必填的spec.selector字段，不符合完整资源定义的验证规则

正确批量Patch方法 #

方法1：Shell循环+kubectl patch #

步骤1：修复Patch文件格式

先修正patch_list_changes.yaml的缩进问题，确保resources在容器条目下：

apiVersion: apps/v1
kind: Deployment
metadata:
  name: custom-metric-sd
  namespace: default
spec:
  template:
    spec:
      containers:
      - name: sd-dummy-exporter
        resources:
          requests:
            cpu: 90m
---
apiVersion: apps/v1
kind: ReplicaSet
metadata:
  name: frontend
  namespace: default
spec:
  template:
    spec:
      containers:
      - name: php-redis
        resources:
          requests:
            cpu: 200m

步骤2：Shell循环逐个Patch

执行以下命令，遍历YAML中的每个资源并单独执行Patch：

kubectl get -f patch_list_changes.yaml -o name | while read resource; do
  # 提取当前资源对应的Patch内容
  patch_content=$(kubectl get -f patch_list_changes.yaml -o yaml \
    --selector "metadata.name=$(echo $resource | cut -d/ -f2)")
  # 执行Patch操作
  kubectl patch "$resource" --patch "$patch_content"
done

方法2：使用Kustomize #

Kustomize是Kubernetes官方配置管理工具，可轻松批量管理资源补丁：

步骤1：创建kustomization.yaml

apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
# 引用目标资源
resources:
- patch_list_changes.yaml
# 定义每个资源的补丁规则
patches:
- target:
    kind: Deployment
    name: custom-metric-sd
    namespace: default
  patch: |-
    - op: replace
      path: /spec/template/spec/containers/0/resources/requests/cpu
      value: "90m"
- target:
    kind: ReplicaSet
    name: frontend
    namespace: default
  patch: |-
    - op: replace
      path: /spec/template/spec/containers/0/resources/requests/cpu
      value: "200m"

步骤2：执行批量更新

kubectl apply -k .

方法3：使用yq拆分YAML后批量Patch #

若安装了yq（v4版本），可更简洁地拆分多资源YAML并处理：

yq eval-all 'select(fileIndex == 0) or (fileIndex > 0 and input != "")' patch_list_changes.yaml | \
yq eval-split '---' - | while read -r patch; do
  kind=$(echo "$patch" | yq eval '.kind' -)
  name=$(echo "$patch" | yq eval '.metadata.name' -)
  kubectl patch "$kind/$name" -n default --patch "$patch"
done

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