Helm v2 如何从Tiller关联ConfigMap备份恢复Release与部署资源
基于备份的Tiller ConfigMap恢复Helm v2 Release的方案
核心结论
你备份的那份tf2.v1 ConfigMap完全可以用来恢复原始资源,但不能直接作为普通Helm Chart目录安装——之前的安装报错本质是目录结构不符合Helm的识别规则,和ConfigMap本身的备份有效性无关。
之前安装报错的根因
- Helm v2 识别本地Chart目录时,会强制校验目录根路径下必须存在
Chart.yaml元数据文件,你之前把导出的ConfigMap直接放到了mychart/template/路径下,既没有把文件移到正确位置,也没有补全Chart元数据,所以触发了no Chart.yaml exists in directory的报错。 - 你已经执行了
helm2 delete --purge tf2,集群内原有的tf2 release元数据已经被硬删除,无法通过helm rollback流程自动恢复,必须依赖这份备份的ConfigMap做全量还原。
备份ConfigMap的存储逻辑
Helm v2 的Tiller组件会把每个Release的全量信息以ConfigMap形式存在
kube-system命名空间下,命名规则为[release-name].v[revision序号],你导出的tf2.v1记录中,以base64编码、gzip压缩的方式存储了三类核心内容:
- 对应安装版本的tensorflow-notebook Chart完整元数据(包含缺失的Chart.yaml文件内容)
- 当时安装时传入的自定义values参数
- 经过模板渲染后的所有最终Kubernetes资源清单(Deployment、Service、ReplicaSet等)
*注意:这份ConfigMap是Tiller的内部状态存储对象,不是可直接应用的K8s资源清单,直接kubectl apply会造成Tiller元数据错乱。
可落地的恢复操作步骤
- 先从备份的ConfigMap中提取有效内容,不要直接使用原来的mychart目录
- 把你导出的
helm_release.yaml从mychart/template/路径移出,放到独立的临时工作目录,避免干扰后续Chart结构 - 解码ConfigMap中存储的序列化Release对象:ConfigMap的
data.release字段就是压缩编码的全量Release数据,执行以下命令解码:# 从ConfigMap提取编码内容,base64解码、gzip解压得到原始Release序列化对象 kubectl get configmap tf2.v1 -n kube-system -o jsonpath='{.data.release}' | base64 -d | gunzip > release_object.json
- 把你导出的
- 根据你的恢复需求选择对应操作路径
- 场景1:仅需要快速拉起原始K8s资源,不需要Helm的元数据管理能力
直接从解码后的Release对象中提取渲染完成的资源清单,通过kubectl创建即可:
这种方式生成的Pod、Service、Deployment和你最初安装的状态完全一致,但后续只能通过kubectl管理,Helm不会识别为自身纳管的Release。# 提取Release中存储的最终资源清单,直接部署到集群 kubectl apply -f <(jq -r '.manifest' release_object.json) - 场景2:需要完整恢复成Helm纳管的tf2 Release,后续可正常执行升级、回滚、删除操作
- 从解码后的Release对象中提取原始Chart文件和当初的安装参数:
这一步执行完成后,# 提取当初安装时的自定义values配置 jq -r '.config' release_object.json > original_values.yaml # 从Release对象中提取完整的原始Chart包,解压到本地chart路径 jq -r '.chart' release_object.json | base64 -d > original_chart.tar.gz tar -xzf original_chart.tar.gz -C ./mychartmychart目录根路径下会自动生成需要的Chart.yaml文件,解决之前的安装报错。 - 用原始参数安装同名Release,覆盖原有残留状态:
helm2 install --name tf2 ./mychart -f original_values.yaml --replace - 把你之前备份的
tf2.v1ConfigMap手动重新创建到kube-system命名空间,让Tiller重新识别到对应版本的Revision记录,后续的Helm操作就能和初始状态完全对齐。
- 从解码后的Release对象中提取原始Chart文件和当初的安装参数:
- 场景1:仅需要快速拉起原始K8s资源,不需要Helm的元数据管理能力
- 注意事项
- 如果之前执行
helm2 delete --purge tf2时,LoadBalancer类型的Service已经被删除,恢复后会自动分配新的外部IP,无法保留之前的固定IP地址 - 不要直接将导出的ConfigMap文件作为普通K8s资源apply到集群,否则会覆盖Tiller的现有状态,可能造成其他正常Release的元数据损坏
- 如果之前执行
内容的提问来源于stack exchange,提问作者navnath bagade
相关产品推荐
相关产品推荐

