安装calio遇到 The CustomResourceDefinition "installations.operator.tigera.io" is invalid: metadata.annotations: Too long: must have at most 262144 bytes

今天看着笔记重建k8s的时候遇到

kubectl apply -f tigera-operator.yaml 运行后

The CustomResourceDefinition "installations.operator.tigera.io" is invalid: metadata.annotations: Too long: must have at most 262144 bytes

对于大多数资源来说,这不是问题,但有些对象超过了 256kb 的限制,例如 kube-prometheus-stack Helm 图表中的 Prometheus CRD,其大小为 500kb。
在 Argo CD 中同步 Prometheus CRD 将运行 kubectl apply 并尝试添加它的 500kb JSON 表示作为注释。这将导致“Too long: must have at most 262144 bytes”错误,因为它超过了 256kb(或 262144 字节)的 Kubernetes 注释大小限制
解决方案是停止使用 Client Side Apply(运行 kubectl apply 时的当前默认设置),而是使用 Server Side Apply,它不会将 last-applied-configuration 注释添加到对象。
Server Side Apply 计划成为未来 Kubernetes 和 Argo CD 版本中的默认应用方法,但现在我们必须明确启用它。
在 Argo CD v2.5 中添加了对服务器端应用的支持,可以通过在应用程序资源的同步选项中设置它来启用:

解决办法
如果你想完全避免 last-applied-configuration 注释,可以采用以下工作流程:

创建资源时使用服务器端应用:

bash
kubectl apply --server-side -f resource.yaml

更新资源时同样使用服务器端应用:

bash
kubectl apply --server-side -f updated-resource.yaml

对于已有资源迁移到服务器端应用:
bash

先删除last-applied-configuration注释

kubectl annotate --overwrite deployment/my-app kubectl.kubernetes.io/last-applied-configuration-

然后使用服务器端应用

kubectl apply --server-side --force-conflicts -f resource.yaml

posted on 2025-05-14 17:12  小二jerry  阅读(230)  评论(0)    收藏  举报