helm 官方 mongodb/mongodb-kubernetes operator chart 不支持分片集群自动编排，仅支持副本集和单节点部署；需改用 bitnami/mongodb-sharded chart 或手写多组件 yaml，并手动执行 sh.addshard 等初始化操作。
直接说结论：Helm 本身不提供开箱即用的 MongoDB 分片集群 chart，官方 mongodb/mongodb-kubernetes Operator chart 只支持副本集（ReplicaSet）和单节点部署，**不支持分片集群（Sharded Cluster）的自动编排**。你要部署分片集群，必须绕过 Operator，改用社区 chart 或手写多组件资源 —— 这是绝大多数用户踩坑前没意识到的关键点。
为什么 mongodb-kubernetes-operator 不支持分片集群
Operator 的设计目标是管理「单个 MongoDB 部署单元」，即一个 MongoDB 自定义资源（CR）对应一个副本集或 standalone 实例。分片集群涉及至少 3 类独立组件：shard（分片副本集）、config server（配置服务器副本集）、mongos（查询路由器），它们需跨命名空间/集群协调、有严格启动顺序、且彼此间需预置连接字符串和密钥。Operator 当前 CRD 模型无法表达这种拓扑关系。
-
MongoDBCR 只能声明一个 replicaSet，不能声明多个 shard 或 config server 组 - 没有
Mongos对应的 CR 类型，无法声明 mongos Deployment + Service - Operator 不处理
sh.addShard()初始化逻辑，也不注入分片元数据到 config server - 所有 Helm
--set参数（如database.version、agent.name）都只作用于单个部署单元，对分片拓扑无效
可行方案：用 bitnami/mongodb-sharded chart
Bitnami 提供了专为分片设计的 bitnami/mongodb-sharded chart（v4.x+），它通过 Helm 模板生成全部必需组件，并内置初始化逻辑。这是目前最接近「一键部署」的方案，但仍有约束：
- 要求 Kubernetes 1.20+，且必须提前准备好 StorageClass（NFS/Ceph/OpenEBS 均可，但不能用 hostPath）
- 所有 shard 和 config server 必须使用相同版本镜像，
image.tag全局统一设置，不支持混用版本 - 默认启用 TLS，若要禁用，必须显式设
auth.tls.enabled=false，否则 mongos 启动失败并报错SSL handshake failed - 密码通过
auth.password设置，但该密码会同时用于 root、clusterAdmin、backup 用户 —— 无法为不同角色设不同密码 - 示例命令：
helm install my-sharded-cluster bitnami/mongodb-sharded \ --namespace mongodb \ --create-namespace \ --set auth.password=secret123 \ --set global.storageClass=nfs \ --set shard.replicaCount=3 \ --set configServer.replicaCount=3
必须手动处理的三个关键点
即使用了 bitnami chart，以下三项仍需人工介入，否则集群不可用：
-
初始化分片拓扑：chart 部署后，需 exec 进入任一 mongos Pod 手动运行
sh.addShard("shard-0/shard-0-0.shard-0-headless.mongodb.svc.cluster.local:27017")—— Helm 不执行此步骤 -
Service 导出方式：mongos 默认只暴露 ClusterIP，若需外部访问，必须 patch Service 或改用 Ingress +
mongos的service.type=LoadBalancer，但后者需云厂商支持 -
备份与监控适配：Prometheus 的
ServiceMonitor需单独为 mongos、shard、config server 分别定义 endpoint；mongodb-prometheus-sample.yaml中的指标采集路径仅适用于单副本集，对分片集群无效
分片集群不是「部署完就跑起来」的东西，Operator 的抽象层在这里彻底失效。你得接受：要么用 bitnami chart + 手动初始化，要么放弃 Helm，直接用 kubectl apply 多个 YAML 文件（shard.yaml / configsvr.yaml / mongos.yaml）—— 后者反而更容易调试和定制。
