bitnamicharts/mongodb

MongoDB® (由Bitnami打包)

镜像概述和主要用途

MongoDB® 是一个开源的关系型NoSQL数据库，采用类JSON文档格式存储数据，易于使用且具备自动扩展能力和高性能，是开发云原生应用的理想选择。Bitnami提供的MongoDB® Helm Chart可快速在Kubernetes集群上部署和管理MongoDB®，支持独立模式（standalone）和副本集（replicaset）两种架构，满足不同场景下的可用性和扩展性需求。

免责声明：本产品中提及的商标归各自公司所有。Bitnami不提供任何商业许可，本清单基于开源许可。MongoDB® 由MongoDB公司独立运营和维护，与Bitnami是完全独立的项目。

核心功能和特性

架构灵活性

• 独立模式（Standalone）：单节点部署，适用于开发或测试环境，不可横向扩展。
• 副本集模式（ReplicaSet）：支持多节点集群（1主N从），可选配仲裁节点（Arbiter），提升可用性和数据冗余。

高可用性与可靠性

• 副本集自动故障转移：主节点故障时，从节点自动晋升为主节点。
• 仲裁节点支持：在资源受限场景（如仅2个可用区），通过轻量级仲裁节点维持副本集投票机制。

安全性增强

• 内置认证机制：支持root用户和普通用户认证，可通过现有Secret或自动生成密码。
• TLS加密：支持节点间及客户端-节点间的TLS加密，可使用自签名证书或自定义CA。

可观测性集成

• Prometheus监控：内置mongodb_exporter，支持Prometheus指标采集，可配置ServiceMonitor对接Prometheus Operator。

易用性与可扩展性

• 初始化脚本支持：通过ConfigMap或参数配置自定义.sh/.js脚本，实现实例初始化。
• 外部访问配置：支持Load***或NodePort服务暴露节点，满足跨集群访问需求。
• 密码自动更新：提供密码更新Job，支持通过Helm升级自动更新MongoDB®密码。

使用场景和适用范围

开发环境

• 快速搭建独立模式MongoDB®，用于本地开发或CI/CD流程。

生产环境

• 副本集模式部署，配合持久化存储（PV），满足生产环境数据可靠性需求。
• 需注意：2025年8月28日后，Bitnami将逐步迁移非硬化镜像至“Bitnami Legacy”仓库，建议生产环境采用Bitnami Secure Images。

云原生应用

• 作为微服务架构的后端数据库，支持自动扩展和动态配置。

数据迁移场景

• 支持对接外部MongoDB®集群（如虚拟机部署），实现混合部署，便于向Kubernetes迁移。

详细使用方法和配置说明

前提条件

• Kubernetes集群版本 ≥ 1.23
• Helm版本 ≥ 3.8.0
• 集群支持PV动态供应（或手动创建PV）

快速安装（TL;DR）

通过Helm快速部署MongoDB®：

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

提示：该应用也可作为Kubernetes应用在Azure Marketplace获取，简化AKS部署流程，详见Azure Marketplace。

架构配置

通过architecture参数选择部署架构：

独立模式架构

单Deployment/StatefulSet部署，包含1个MongoDB®服务器：

     ----------------
    |   MongoDB® 服务 |
     ----------------
            |
            v
       ------------
      | MongoDB® 服务器 |
      |    Pod      |
       ------------

副本集架构（含仲裁节点）

包含2个StatefulSet：N个数据节点（1主N-1从）+ 1个仲裁节点：

     ----------------   ----------------   ----------------      -------------
    | MongoDB® 节点0 | | MongoDB® 节点1 | | MongoDB® 节点N |    |   仲裁节点   |
    |  外部服务      | |  外部服务      | |  外部服务      |    |   服务       |
     ----------------   ----------------   ----------------      -------------
            |                  |                  |                    |
            v                  v                  v                    v
     ----------------   ----------------   ----------------      --------------
    | MongoDB® 节点0 | | MongoDB® 节点1 | | MongoDB® 节点N |    | MongoDB® 仲裁 |
    |   主节点       | |   从节点       | |   从节点       |    |    节点       |
    |    Pod         | |    Pod         | |    Pod         |    |    Pod        |
     ----------------   ----------------   ----------------      --------------

安装与配置

基础安装

指定架构和副本数安装：

console
helm install my-release oci://registry-1.docker.io/bitnamicharts/mongodb \
  --set architecture=replicaset \
  --set replicaCount=3

自定义参数

通过values.yaml或--set覆盖默认参数，常用参数示例：

关键配置说明

外部访问配置

副本集模式下，通过以下方式暴露节点至集群外：

Load***服务

• 自动发现IP：通过InitContainer等待LB IP分配（需RBAC权限）：

  yaml
  architecture: replicaset
  externalAccess:
    enabled: true
    service: { type: LoadBalancer }
    autoDiscovery: { enabled: true }
  rbac: { create: true }
  

• 手动指定IP：静态配置LB IP：

  yaml
  externalAccess:
    service:
      loadBalancerIPs: ["EXTERNAL-IP-1", "EXTERNAL-IP-2"]
  

NodePort服务

指定节点端口暴露：

yaml
externalAccess:
  enabled: true
  service:
    type: NodePort
    nodePorts: [30001, 30002] # 对应每个数据节点

初始化脚本

通过以下方式配置实例初始化脚本（支持.sh/.js）：

• 内联脚本：

  yaml
  initdbScripts:
    init-user.js: |
      db.createUser({user: "app", pwd: "apppass", roles: ["readWrite"]})
  

• 外部ConfigMap：

  yaml
  initdbScriptsConfigMap: "my-init-scripts" # 覆盖内联脚本
  

认证与密码管理

• 自动生成密码：默认自动生成root密码，存储于Secret中。
• 使用现有Secret：

  yaml
  auth:
    existingSecret: "my-mongodb-secret" # 需包含mongodb-root-password等键
  

• 密码更新：启用密码更新Job：

  yaml
  passwordUpdateJob:
    enabled: true
  auth:
    rootPassword: "new-root-pass" # 新密码
  

监控集成

启用Prometheus监控：

yaml
metrics:
  enabled: true
  serviceMonitor: # 对接Prometheus Operator
    enabled: true
  username: "metrics-user" # 监控用户
  password: "metrics-pass"

备份与恢复

方法1：使用MongoDB工具

• 备份：mongodump --uri="mongodb://user:pass@host:port/db"
• 恢复：mongorestore --uri="mongodb://user:pass@new-host:port/db" /backup

方法2：持久卷备份（Velero）

通过Velero备份PV，恢复时需保持部署名、命名空间、拓扑一致。

重要注意事项

Bitnami镜像政策变更（2025年8月28日起）

• 安全镜像 initiative：免费 tier 将仅提供硬化（hardened）镜像（latest标签），用于开发环境。
• 旧镜像迁移：非硬化Debian镜像及历史版本标签将迁移至docker.io/bitnamilegacy仓库，不再更新。
• 生产建议：生产环境推荐使用Bitnami Secure Images，提供企业级支持和CVE透明性。

参考链接

• MongoDB官方文档
• https://github.com/bitnami/containers/tree/main/bitnami/mongodb
• https://github.com/bitnami/charts/blob/main/bitnami/mongodb/README.md