bitnamicharts/mongodb-sharded

MongoDB® Sharded packaged by Bitnami

MongoDB®是一个开源NoSQL数据库，使用JSON格式存储数据。MongoDB™分片版通过将数据分布到多台机器上，为大型数据集提高了可扩展性和可靠性。

MongoDB® Sharded概述

免责声明：所提及的相关商标归各自公司所有。我们不提供任何这些产品的商业许可。本列表采用开源许可。MongoDB®由MongoDB运营和维护，与Bitnami是完全独立的项目。

TL;DR

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/mongodb-sharded

希望在生产环境中使用MongoDB® Sharded？请尝试VMware Tanzu Application Catalog，即Bitnami目录的商业版。

⚠️ 重要通知：Bitnami目录即将变更

自2025年8月28日起，Bitnami将改进其公共目录，在新的Bitnami Secure Images计划下提供精选的强化、安全聚焦镜像集。作为此过渡的一部分：

• 首次向社区用户提供流行容器镜像的安全优化版本访问权限。
• Bitnami将开始在其免费层级中弃用对非强化、基于Debian的软件镜像的支持，并将逐步从公共目录中移除非最新标签。因此，社区用户将只能访问数量减少的强化镜像。这些镜像仅以“latest”标签发布，适用于开发目的。
• 从8月28日开始，在两周内，所有现有容器镜像（包括旧版本或特定版本标签，如2.50.0、10.6）将从公共目录（docker.io/bitnami）迁移到“Bitnami Legacy”仓库（docker.io/bitnamilegacy），且不再接收更新。
• 对于生产工作负载和长期支持，建议用户采用Bitnami Secure Images，包括强化容器、更小的***面、CVE透明度（通过VEX/KEV）、SBOM以及企业支持。

这些变更旨在通过推广软件供应链完整性和最新部署的最佳实践，提高所有Bitnami用户的安全态势。更多详情，请访问https://github.com/bitnami/containers/issues/83267%E3%80%82

简介

此Chart使用Helm包管理器在Kubernetes集群上引导部署https://github.com/bitnami/containers/tree/main/bitnami/mongodb-sharded%E3%80%82

MongoDB®作为NoSQL数据库，摒弃了传统的基于表的关系数据库结构，转而使用类似JSON的文档和动态模式，使某些类型应用的数据集成更轻松、更快速。

此Chart使用分片方法在多台机器间分布数据，适用于具有非常大的数据集和高吞吐量操作的部署。

前提条件

• Kubernetes 1.23+
• Helm 3.8.0+
• 底层基础设施支持PV供应器
• ReadWriteMany卷用于部署扩展

安装Chart

要使用发布名称my-release安装Chart：

console
helm install my-release oci://REGISTRY_NAME/REPOSITORY_NAME/mongodb-sharded

注意：您需要将占位符REGISTRY_NAME和REPOSITORY_NAME替换为Helm Chart仓库和存储库的引用。例如，对于Bitnami，需使用REGISTRY_NAME=registry-1.docker.io和REPOSITORY_NAME=bitnamicharts。

该命令使用默认配置在Kubernetes集群上部署MongoDB®。参数部分列出了可在安装期间配置的参数。

提示：使用helm list列出所有发布。

配置和安装详情

资源请求和限制

Bitnami Charts允许为Chart部署中的所有容器设置资源请求和限制。这些在resources值中配置（参见参数表）。为生产工作负载设置请求至关重要，应根据您的具体用例进行调整。

为简化此过程，Chart包含resourcesPreset值，可根据不同预设自动设置resources部分。在https://github.com/bitnami/charts/blob/main/bitnami/common/templates/_resources.tpl#L15%E4%B8%AD%E6%9F%A5%E7%9C%8B%E8%BF%99%E4%BA%9B%E9%A2%84%E8%AE%BE%E3%80%82%E4%BD%86%E5%9C%A8%E7%94%9F%E4%BA%A7%E5%B7%A5%E4%BD%9C%E8%B4%9F%E8%BD%BD%E4%B8%AD%EF%BC%8C%E4%B8%8D%E5%BB%BA%E8%AE%AE%E4%BD%BF%E7%94%A8%60resourcesPreset%60%EF%BC%8C%E5%9B%A0%E4%B8%BA%E5%AE%83%E5%8F%AF%E8%83%BD%E6%97%A0%E6%B3%95%E5%AE%8C%E5%85%A8%E9%80%82%E5%BA%94%E6%82%A8%E7%9A%84%E7%89%B9%E5%AE%9A%E9%9C%80%E6%B1%82%E3%80%82%E6%9C%89%E5%85%B3%E5%AE%B9%E5%99%A8%E8%B5%84%E6%BA%90%E7%AE%A1%E7%90%86%E7%9A%84%E6%9B%B4%E5%A4%9A%E4%BF%A1%E6%81%AF%EF%BC%8C%E8%AF%B7%E5%8F%82%E9%98%85Kubernetes%E5%AE%98%E6%96%B9%E6%96%87%E6%A1%A3%E3%80%82

更新凭据

Bitnami Charts在首次启动时配置凭据。后续对密钥或凭据的任何更改都需要手动干预。请按照以下说明操作：

• 按照上游文档更新用户密码
• 使用新值更新密码密钥（替换SECRET_NAME、ROOT_PASSWORD和REPLICA_SET_KEY占位符）

shell
kubectl create secret generic SECRET_NAME --from-literal=mongodb-root-password=ROOT_PASSWORD --from-literal=mongodb-replica-set-key=REPLICA_SET_KEY --dry-run -o yaml | kubectl apply -f -

Prometheus指标

通过将metrics.enabled设置为true，此Chart可与Prometheus集成。这将在所有Pod中部署带有https://github.com/percona/mongodb_exporter%E7%9A%84Sidecar%E5%AE%B9%E5%99%A8%E3%80%82Pod%E5%B0%86%E5%85%B7%E6%9C%89%E5%BF%85%E8%A6%81%E7%9A%84%E6%B3%A8%E8%A7%A3%EF%BC%8C%E4%BB%A5%E4%BE%BF%E8%A2%ABPrometheus%E8%87%AA%E5%8A%A8%E6%8A%93%E5%8F%96%E3%80%82

Prometheus要求

要使集成工作，需要安装Prometheus或Prometheus Operator。安装https://github.com/bitnami/charts/tree/main/bitnami/prometheus%E6%88%96https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%EF%BC%8C%E5%8F%AF%E5%9C%A8%E9%9B%86%E7%BE%A4%E4%B8%AD%E8%BD%BB%E6%9D%BE%E8%8E%B7%E5%BE%97%E5%8F%AF%E7%94%A8%E7%9A%84Prometheus%E3%80%82

与Prometheus Operator集成

通过设置metrics.podMonitor.enabled=true，Chart可部署PodMonitor对象以与Prometheus Operator集成。确保集群中安装了Prometheus OperatorCustomResourceDefinitions，否则将失败并显示以下错误：

text
no matches for kind "PodMonitor" in version "monitoring.coreos.com/v1"

安装https://github.com/bitnami/charts/tree/main/bitnami/kube-prometheus%E4%BB%A5%E8%8E%B7%E5%8F%96%E5%BF%85%E8%A6%81%E7%9A%84CRD%E5%92%8CPrometheus Operator。

滚动标签与不可变标签

强烈建议在生产环境中使用不可变标签。这可确保如果相同标签使用不同镜像更新，您的部署不会自动更改。

如果主容器有新版本、重大变更或严重漏洞，Bitnami将发布新Chart以更新其容器。

更改MongoDB®版本

要修改此Chart中使用的MongoDB®版本，可使用image.tag参数指定https://hub.docker.com/r/bitnami/mongodb-sharded/tags/%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%8C%60image.tag=X.Y.Z%60%E3%80%82%E6%AD%A4%E6%96%B9%E6%B3%95%E4%B9%9F%E9%80%82%E7%94%A8%E4%BA%8E%E5%85%B6%E4%BB%96%E9%95%9C%E5%83%8F%EF%BC%88%E5%A6%82exporter%EF%BC%89%E3%80%82

分片

此Chart默认部署分片集群。该Chart的一些特点包括：

• 通过在分片和配置服务器上启用复制来支持高可用。mongos实例也可水平扩展。
• 次要节点和仲裁节点的数量可独立扩展。

初始化新实例

https://github.com/bitnami/containers/tree/main/bitnami/mongodb-sharded%E9%95%9C%E5%83%8F%E5%85%81%E8%AE%B8%E4%BD%BF%E7%94%A8%E8%87%AA%E5%AE%9A%E4%B9%89%E8%84%9A%E6%9C%AC%E5%88%9D%E5%A7%8B%E5%8C%96%E6%96%B0%E5%AE%9E%E4%BE%8B%E3%80%82%E6%82%A8%E5%8F%AF%E4%BB%A5%E5%88%9B%E5%BB%BA%E8%87%AA%E5%AE%9A%E4%B9%89ConfigMap%EF%BC%8C%E5%B9%B6%E9%80%9A%E8%BF%87%60initScriptsCM%60%E6%8F%90%E4%BE%9B%EF%BC%88%E6%9F%A5%E7%9C%8B%E9%80%89%E9%A1%B9%E4%BA%86%E8%A7%A3%E6%9B%B4%E5%A4%9A%E8%AF%A6%E6%83%85%EF%BC%89%E3%80%82

允许的扩展名为.sh和.js。

Sidecar和Init容器

如果需要在与Kibana相同的Pod中运行额外容器（例如，额外的指标或日志exporter），可通过sidecars配置参数（在mongos、shardsvr.dataNode、shardsvr.arbiter、configsvr和common部分可用）实现。只需根据Kubernetes容器规范定义您的容器。

yaml
sidecars:
- name: your-image-name
  image: your-image
  imagePullPolicy: Always
  ports:
  - name: portname
    containerPort: 1234

类似地，可使用initContainers参数添加额外的init容器。

yaml
initContainers:
- name: your-image-name
  image: your-image
  imagePullPolicy: Always
  ports:
  - name: portname
    containerPort: 1234

添加额外环境变量

如果需要添加额外环境变量（用于高级操作，如自定义初始化脚本），可使用extraEnvVars属性（在mongos、shardsvr.dataNode、shardsvr.arbiter、configsvr和common部分可用）。

yaml
extraEnvVars:
  - name: MONGODB_VERSION
    value: 4.0

或者，可使用包含环境变量的ConfigMap或Secret。为此，使用extraEnvVarsCM或extraEnvVarsSecret值。

使用外部配置服务器

可以不部署分片或配置服务器。例如，可以仅部署指向外部MongoDB®分片数据库的mongos实例。如果是这种情况，设置configsvr.external.host和configsvr.external.replicasetName以使mongos实例连接。对于身份验证，设置configsvr.external.rootPassword和configsvr.external.replicasetKey值。

设置Pod亲和性

此Chart允许使用XXX.affinity参数设置自定义亲和性。有关Pod亲和性的更多信息，请参阅kubernetes文档。

作为替代方案，可使用https://github.com/bitnami/charts/tree/main/bitnami/common#affinities Chart中提供的Pod亲和性、Pod反亲和性和节点亲和性预设配置。为此，设置XXX.podAffinityPreset、XXX.podAntiAffinityPreset或XXX.nodeAffinityPreset参数。

备份和恢复

要在Kubernetes上备份和恢复Helm Chart部署，需要从源部署备份持久卷，并使用Velero（Kubernetes备份/恢复工具）将其附加到新部署。在本指南中查找使用Velero的说明。

持久化

https://github.com/bitnami/containers/tree/main/bitnami/mongodb-sharded%E9%95%9C%E5%83%8F%E5%B0%86MongoDB%C2%AE%E6%95%B0%E6%8D%AE%E5%92%8C%E9%85%8D%E7%BD%AE%E5%AD%98%E5%82%A8%E5%9C%A8%E5%AE%B9%E5%99%A8%E7%9A%84%60/bitnami/mongodb%60%E8%B7%AF%E5%BE%84%E4%B8%AD%E3%80%82

Chart在此位置挂载持久卷。卷使用动态卷供应创建。

调整持久卷挂载点的权限

由于镜像默认以非root用户运行，需要调整持久卷的所有权，以便容器可以写入数据。

默认情况下，Chart配置为使用Kubernetes安全上下文自动更改卷的所有权。但此功能并非在所有Kubernetes发行版中都有效。

作为替代方案，此Chart支持使用initContainer在将卷挂载到最终目标之前更改其所有权。

可通过将volumePermissions.enabled设置为true来启用此initContainer。

添加额外卷

Bitnami Kibana Chart支持通过使用extraVolumes和extraVolumeMounts属性（在mongos、shardsvr.dataNode、shardsvr.arbiter、configsvr和common部分可用）挂载额外卷（PVC、密钥或ConfigMap）。这可与高级操作（如添加额外的init容器和sidecar）结合使用。

参数

全局参数

通用参数

MongoDB(®) Sharded参数

注意：此Chart的README超出DockerHub的25000字符限制，已被截断。完整README可在https://github.com/bitnami/charts/blob/main/bitnami/mongodb-sharded/README.md%E6%89%BE%E5%88%B0%E3%80%82