使用Helm Charts升级MongoDB副本集版本失败问题咨询

当前使用的MongoDB Helm Chart版本较旧（9.3.1），已部署3实例的MongoDB 4.x（4.4.1）副本集，尝试通过以下步骤升级至5.x（5.0.15-debian-11-r4），但升级后Pod内MongoDB版本仍为4.4.1，且helm list显示的版本标签未更新：

操作步骤 #

• 0. 下载Chart：

  wget --no-check-certificate https://charts.bitnami.com/bitnami/mongodb-9.3.1.tgz
  

• 1. 安装3实例副本集：

  helm install mongodb mongodb-9.3.1.tgz \
                          --version 9.3.1 \
                          --namespace namespace \
                          --set architecture=replicaset \
  

• 2. 尝试通过更新镜像Tag升级：

  helm upgrade --debug mongodb mongodb-9.3.1.tgz \
                          --version 9.3.1 \
                          --namespace namespace \
                          --set image.tag=5.0.15-debian-11-r4 \
                          --set architecture=replicaset \
  

• 3. helm list -A输出：

  mongodb   namespace  2   "Today"   +0000 UTC   deployed   mongodb-9.3.1   4.4.1
  

• 4. helm status mongodb -n namespace输出：

  LAST DEPLOYED: "Today"
  NAMESPACE: flux-prod
  STATUS: deployed
  REVISION: 2
  

• 5. 查看Pod内MongoDB版本：db.version() ->4.4.1，Pod日志及事件无异常

请问是否可以通过此方式升级MongoDB副本集？

这种直接修改镜像Tag的方式不可行，原因及正确升级路径如下：

1. 当前操作失效的核心原因 #

Bitnami的MongoDB Helm Chart是按版本绑定MongoDB主版本设计的，旧版本Chart（如9.3.1）仅适配特定范围的MongoDB版本（通常是4.4.x系列）。即使手动指定5.x的镜像Tag，Chart内置的模板逻辑、初始化脚本、健康检查等环节会与高版本MongoDB不兼容，导致Pod不会实际拉取新镜像，或启动后自动回退到原版本。

另外，helm list中显示的4.4.1是Chart内置的MongoDB版本元数据，不会随手动修改的镜像Tag自动更新，这也说明Chart并未识别到你的版本变更请求。

2. 正确的跨主版本升级流程 #

步骤1：先升级到4.4系列最新小版本 #

跨主版本升级前，必须先将当前集群升级到同主版本的最新小版本，确保数据兼容性：

helm upgrade mongodb mongodb-9.3.1.tgz \
  --version 9.3.1 \
  --namespace namespace \
  --set image.tag=4.4.27-debian-11-rXX \ # 替换为4.4系列最新镜像Tag
  --set architecture=replicaset

等待所有Pod重启并同步完成，确认db.version()显示为最新4.4版本。

步骤2：升级到支持MongoDB 5.x的Helm Chart版本 #

Bitnami中支持MongoDB 5.x的Chart通常为10.x及以上系列，先更新Chart仓库：

helm repo update bitnami

然后升级Chart到对应版本，同时指定MongoDB 5.x镜像：

helm upgrade mongodb bitnami/mongodb \
  --version 10.23.0 \ # 替换为支持5.x的稳定Chart版本
  --namespace namespace \
  --set image.tag=5.0.23-debian-11-rXX \ # 5.x系列最新镜像Tag
  --set architecture=replicaset \
  --reuse-values # 保留原有自定义配置

步骤3：完成MongoDB内部版本升级 #

升级Chart后，需要手动触发MongoDB副本集的内部版本同步：

1. 连接到主节点：

   kubectl exec -it mongodb-0 -n namespace -- mongosh
   

2. 检查副本集状态，确保所有节点健康：

   rs.status()
   

3. 设置Feature Compatibility Version（FCV）为4.4，确认集群兼容：

   db.adminCommand({ setFeatureCompatibilityVersion: "4.4" })
   

4. 等待所有节点同步完成后，升级FCV到5.0：

   db.adminCommand({ setFeatureCompatibilityVersion: "5.0" })
   

5. 再次检查所有节点的db.version()和FCV，确认升级完成。

3. 关键注意事项 #

• 升级前务必备份数据：使用mongodump或Kubernetes卷快照工具备份全量数据。
• 保证集群资源充足：升级过程中节点会重启，需预留足够的CPU、内存资源避免服务中断。
• 禁止跨多主版本跳跃：不要直接从4.4升级到6.0，必须按主版本顺序逐步升级。

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