移除Helm模板硬编码namespace后用-n参数部署报错如何解决

问题根因 #

此前部署时未指定-n参数，Helm默认将Release记录存放在default命名空间，同时因为模板中硬编码了namespace: {{ .Release.Name }}，业务资源被创建到了myproject123命名空间下，该命名空间的所有权注解被标记为归default命名空间下的myproject123 Release所有。
本次操作指定-n myproject123后，Helm会优先在myproject123命名空间下查找对应Release，找不到就尝试新建，但发现myproject123命名空间已经被default命名空间下的Release管理，所有权注解不匹配，因此触发报错。

解决方案（零业务停机） #

前置备份（必做）

先导出原有Release的所有信息做备份，防止误操作：

helm get all myproject123 -n default > myproject123-backup.yaml

可执行helm list -n default | grep myproject123确认Release确实存在于default命名空间。

步骤1：删除原有Release记录，保留所有业务资源

执行卸载命令时添加--cascade=orphan参数，仅删除Helm的Release记录，不会删除任何运行中的业务资源（Pod、Service、ConfigMap等均不受影响）：

helm uninstall myproject123 -n default --cascade=orphan

步骤2：清除命名空间的旧所有权标记

删除myproject123命名空间上原有的Helm管理注解和标签：

kubectl annotate namespace myproject123 meta.helm.sh/release-name- meta.helm.sh/release-namespace-
kubectl label namespace myproject123 app.kubernetes.io/managed-by-

命令末尾的减号代表删除对应字段。

步骤3：重新安装Release到正确命名空间

执行原有的升级安装命令即可，可先加--dry-run参数验证无问题后再执行实际操作：

# 先测试执行效果
helm upgrade --install --dry-run --debug -n myproject123 -f helm/configs/myproject123.yaml myproject123 helm
# 测试无误后执行实际安装
helm upgrade --install --debug -n myproject123 -f helm/configs/myproject123.yaml myproject123 helm

这一步Helm只会比对现有资源和模板的差异更新字段，不会重建运行中的Pod，业务完全无感知。

批量处理说明 #

如果有多个项目需要调整，按照上述步骤逐个处理即可，每个项目的迁移操作都不会影响业务可用性。

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