ArgoCD部署应用出现metadata.annotations过大问题

ArgoCD部署应用出现metadata.annotations过大问题

💡 原文中文,约600字,阅读约需2分钟。
📝

内容提要

在使用 Argo CD 部署 kube-prometheus-stack 时,可能会遇到 metadata.annotations 超过 262144 字节的错误。解决方法是使用 replace 替代 apply,但需谨慎,因为 replace 会完全替换资源。

🎯

关键要点

  • 使用 Argo CD 部署 kube-prometheus-stack 时可能遇到 metadata.annotations 超过 262144 字节的错误。
  • Kubernetes 对 metadata.annotations 字段总长度有限制,通常不能超过 262144 字节。
  • 执行 kubectl apply 时会在 annotation 中加入 last-applied-configuration,导致 annotation 过大无法 apply。
  • 解决方法是使用 replace 代替 apply,但需谨慎,因为 replace 会完全替换资源。
  • 在 ArgoCD 中点击 Sync 时可以勾选 Replace。
  • replace 操作会导致资源被硬替换,需小心判断资源对象。
  • create、apply、replace 操作类型的区别:create 仅创建,apply 智能合并,replace 全量覆盖。
  • 首次部署推荐使用 create,日常维护推荐使用 apply,紧急或特殊配置场景推荐使用 replace。
  • 需注意使用 replace 时可能导致字段丢失风险。
➡️

继续阅读