bitnami/mongodb-sharded

Bitnami 打包的 MongoDB® 分片集群

什么是 MongoDB® 分片集群?

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

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

核心功能和特性

• 分片支持：通过将数据分布到多个分片节点实现水平扩展，支持大规模数据集存储与查询
• 副本集集成：配置服务器和分片节点均支持副本集部署，提供高可用性和数据冗余能力
• 非根容器设计：以非 root 用户运行，减少***面，符合生产环境安全最佳实践
• 数据持久化：支持挂载卷存储数据，避免容器生命周期结束导致数据丢失
• 灵活配置：通过环境变量自定义数据库参数（认证、网络、日志、副本集等）
• 安全镜像特性：基于 Photon Linux 最小化操作系统，提供 SBOM、VEX/KEV 漏洞透明度，SLSA-3 合规构建流程

使用场景和适用范围

• 大型数据集应用：适用于数据量超过单节点处理能力，需要通过分片扩展存储和计算资源的场景
• 高可用性需求：关键业务系统需确保数据不丢失和服务持续可用，通过副本集实现故障自动转移
• 水平扩展场景：用户量或数据量增长迅速，需通过添加分片节点实现无缝扩展的业务
• 开发与生产环境：支持从开发测试到生产部署的全流程，提供一致的配置和部署体验

快速启动 (TL;DR)

console
docker run --name mongodb bitnami/mongodb-sharded:latest

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

自 2025 年 8 月 28 日起，Bitnami 将升级其公共镜像目录，通过新的 Bitnami 安全镜像计划 提供精选的强化、安全聚焦镜像。作为此次过渡的一部分：

• 首次向社区用户开放热门容器镜像的安全优化版本访问权限。
• Bitnami 将开始在免费层中弃用对非强化 Debian 基础软件镜像的支持，并逐步从公共目录中移除非最新标签。社区用户将只能访问数量减少的强化镜像，仅以“latest”标签发布，适用于开发目的。
• 自 8 月 28 日起，两周内所有现有容器镜像（包括旧版本标签，如 2.50.0、10.6）将从 docker.io/bitnami 迁移至 docker.io/bitnamilegacy 仓库，且不再接收更新。
• 生产环境和长期支持建议采用 Bitnami 安全镜像，包含强化容器、更小***面、CVE 透明度（VEX/KEV）、SBOM 和企业支持。

更多详情请访问 https://github.com/bitnami/containers/issues/83267%E3%80%82

为什么使用 Bitnami 安全镜像？

• 安全镜像和 Helm 图表旨在提升开源软件的安全性和企业适用性。
• 通过 VEX/KEV/EPSS 行业标准提供漏洞透明度，加速漏洞分类。
• 基于 Photon Linux 最小化操作系统，减少***面同时保持扩展性。
• 持续构建机制确保上游补丁发布后数小时内更新镜像。
• 容器、虚拟机和云镜像采用一致的组件和配置，便于跨格式切换。
• 提供 Notation 签名、SBOM、病毒扫描报告等 SLSA-3 合规元数据。

如何在 Kubernetes 中部署 MongoDB® 分片集群？

推荐使用 Helm 图表部署。详情请参阅 https://github.com/bitnami/charts/tree/master/bitnami/mongodb-sharded%E3%80%82

为什么使用非根容器？

非根容器通过限制权限增强安全性，推荐用于生产环境。但由于以非 root 用户运行，可能无法执行特权任务。详见 非根容器文档。

支持的标签及 Dockerfile 链接

了解 Bitnami 标签策略（滚动标签 vs 不可变标签）请参阅 文档。标签对应关系可查看分支文件夹中的 tags-info.yaml 文件。

通过关注 https://github.com/bitnami/containers 订阅项目更新。

获取本镜像

从 Docker Hub 拉取

推荐方式：

console
docker pull bitnami/mongodb-sharded:latest

拉取特定版本：

console
docker pull bitnami/mongodb-sharded:[标签]

https://hub.docker.com/r/bitnami/mongodb-sharded/tags/

手动构建

console
git clone https://github.com/bitnami/containers.git
cd bitnami/APP/VERSION/OPERATING-SYSTEM
docker build -t bitnami/APP:latest .

数据持久化

容器删除后数据会丢失，需挂载卷持久化存储。挂载目录需对 UID 1001 有读写权限。

基本持久化

console
docker run \
    -v /path/to/mongodb-persistence:/bitnami/mongodb \
    bitnami/mongodb-sharded:latest

Docker Compose 配置

修改 docker-compose.yml，为每个组件创建持久化目录并授权（chown 1001:1001 [目录] && chmod 777 [目录]）：

yaml
services:
  mongodb-sharded:
    volumes:
      - /path/to/mongos-persistence:/bitnami
  mongodb-shard0:
    volumes:
      - /path/to/mongoshard-persistence:/bitnami
  mongodb-cfg:
    volumes:
      - /path/to/mongocfg-persistence:/bitnami

配置

环境变量

可自定义环境变量

只读环境变量

部署分片集群

分片集群包含三个组件：

• Mongos：应用与分片集群的接口
• 配置服务器：存储元数据和配置
• 分片：存储数据子集

核心配置变量

部署步骤

1. 创建配置服务器副本集
   启动主配置服务器：

   console
   docker run -d \
     -e MONGODB_SHARDING_MODE=configsvr \
     -e MONGODB_REPLICA_SET_MODE=primary \
     -e MONGODB_REPLICA_SET_NAME=cfg-replicaset \
     -e MONGODB_REPLICA_SET_KEY=replicaset-key \
     -e MONGODB_ROOT_PASSWORD=root-password \
     --name mongodb-cfg-primary \
     bitnami/mongodb-sharded:latest
   

2. 添加配置服务器从节点（步骤略）

3. 部署分片副本集（步骤略）

4. 启动 Mongos 路由（步骤略）

完整部署指南请参阅 https://github.com/bitnami/containers/blob/main/bitnami/mongodb-sharded/README.md%E3%80%82

（注：完整文档超出长度限制，更多细节请访问上述链接）