同一包含集群级资源的Helm Chart多命名空间安装报错如何解决

方案1：拆分集群资源与命名空间资源为独立Chart #

这是最推荐的生产级方案，彻底规避集群资源重复安装冲突问题：

• 将CRD、ClusterRole等所有集群作用域资源单独打包为一个独立的集群级Chart，该Chart支持完整的Helm模板渲染，可正常使用values变量，仅需在集群中安装一次。
• 原业务工作负载、Role、ConfigMap等命名空间级资源单独打包为业务Chart，不包含任何集群级资源，可重复安装到任意命名空间无冲突。
• 若需要简化安装流程，可在业务Chart中配置条件依赖：新增参数installClusterResources默认值为false，首次安装业务Chart时指定--set installClusterResources=true即可自动关联安装集群资源Chart，后续安装其他实例无需指定该参数。

方案2：保留原有lookup逻辑，新增资源保留注解 #

你之前遇到的资源交替消失问题，根源是首次安装生成的集群资源被纳入当前Release的管理范围，第二次安装时模板未输出该资源，Helm默认会将其判定为待删除资源，仅需添加注解即可解决。
另外你原有的lookup参数存在错误，CustomResourceDefinition是集群级资源，不属于任何命名空间，因此第三个参数应该传空字符串而非.Release.Namespace，否则会无法正确查询到集群中已存在的CRD。

在CRD、ClusterRole等集群资源的metadata.annotations中添加helm.sh/resource-policy: keep，该注解会告知Helm在升级、卸载Release时，永远不会操作该资源。调整后的模板示例如下：

{{- $crds := lookup "apiextensions.k8s.io/v1" "CustomResourceDefinition" "" "path.to.new.crd" -}}
{{- if not $crds -}}
apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  name: path.to.new.crd
  annotations:
    helm.sh/resource-policy: keep
spec:
  # 你的CRD配置，支持values变量渲染
{{- end }}

注意：lookup函数默认在helm template、helm install --dry-run（客户端模式）下不会访问集群API，无法正确判断资源是否存在，需要使用--dry-run=server参数触发服务端渲染才能正常生效。

方案3：给集群级资源增加唯一标识（仅适用于多实例需要不同CRD的场景） #

如果你的业务场景要求每个Chart实例部署独立的CRD定义，可将Release名称作为后缀加入CRD、ClusterRole的名称中，确保每个实例的集群资源全局唯一，不会冲突：

apiVersion: apiextensions.k8s.io/v1
kind: CustomResourceDefinition
metadata:
  name: {{ .Release.Name }}.path.to.new.crd

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