无原始配置文件时安全更新Kubernetes集群及配置修改方案咨询

作为经常和无原始配置的K8s集群打交道的人，我来分享几个安全可行的方案，帮你搞定nginx ingress的prometheus metrics配置，同时避免破坏现有环境：

一、导出现有配置并修改后重新应用 #

你提到的kubectl get -o yaml方法是可行的，但确实会带出K8s自动生成的字段（比如creationTimestamp、uid、resourceVersion这些），处理方式有两种：

1. 手动清理自动生成字段
   导出资源yaml后，删除metadata下的这些自动生成字段，只保留name、namespace、labels、annotations等你自己设置的内容，以及spec部分的配置。比如导出nginx ingress的deployment：

   kubectl get deployment nginx-ingress-controller -n nginx -o yaml > nginx-ingress-deployment.yaml
   

   编辑文件时，去掉metadata里的creationTimestamp、uid、resourceVersion、selfLink这些字段，然后修改你需要的部分（比如添加metrics端口、prometheus注解）。

2. 用工具自动清理（推荐）
   可以安装kubectl-neat插件，它能自动帮你去掉这些无用的自动生成字段，命令更简洁：

   kubectl get deployment nginx-ingress-controller -n nginx -o yaml | kubectl neat > nginx-ingress-deployment-clean.yaml
   

修改完成后，先预览变化确认没问题：

kubectl diff -f nginx-ingress-deployment-clean.yaml -n nginx

如果预览的变化符合预期，再执行应用：

kubectl apply -f nginx-ingress-deployment-clean.yaml -n nginx

K8s的apply是声明式操作，会对比现有资源状态和你的yaml配置，只更新差异部分，不会破坏原有正确的配置，所以是安全的。

二、用kubectl patch做增量更新（无需全量yaml） #

如果只是修改个别配置项（比如只加metrics端口或注解），用kubectl patch更高效，不用处理全量yaml，风险更低。

方式1：JSON Patch #

比如给nginx ingress容器添加metrics端口：

kubectl patch deployment nginx-ingress-controller -n nginx --type='json' -p='[{"op": "add", "path": "/spec/template/spec/containers/0/ports/-", "value": {"containerPort": 10254, "name": "metrics", "protocol": "TCP"}}]'

方式2：Strategic Merge Patch（更易读） #

写一个小的yaml补丁文件metrics-patch.yaml：

spec:
  template:
    spec:
      containers:
      - name: nginx-ingress-controller
        ports:
        - containerPort: 10254
          name: metrics
          protocol: TCP
    metadata:
      annotations:
        prometheus.io/scrape: "true"
        prometheus.io/port: "10254"

然后执行补丁：

kubectl patch deployment nginx-ingress-controller -n nginx --patch-file=metrics-patch.yaml

同样，执行前可以用kubectl patch --dry-run=client预览变化。

三、关于配置版本控制的建议 #

强烈建议把清理后的配置文件存入Git仓库，这是K8s运维的最佳实践：

• 可以跟踪每一次配置修改的历史，出问题时能快速回滚到之前的稳定版本
• 方便团队协作，其他人能清楚看到集群的配置状态
• 就算集群出故障，也有备份的配置可以快速重建资源

哪怕是小集群，版本控制也能帮你避免“改了什么记不清”的尴尬，长期来看绝对值得做。

备注：内容来源于stack exchange，提问作者Supernat