centos/mongodb-36-centos7

MongoDB 3.6 NoSQL Database Server 容器镜像

镜像概述

本仓库包含用于通用场景和OpenShift的MongoDB镜像Dockerfile。用户可选择基于RHEL或CentOS的镜像：

• RHEL镜像：可从Red Hat Container Catalog获取，镜像名为registry.access.redhat.com/rhscl/mongodb-36-rhel7
• CentOS镜像：可从Quay.io获取，镜像名为centos7/mongodb-36-centos7

核心功能与特性

该容器镜像提供MongoDB的mongod守护进程和客户端应用的容器化打包。mongod服务器守护进程接受客户端连接，并代表客户端提供对MongoDB数据库内容的访问。更多关于MongoDB项目的信息可访问MongoDB官网。

使用场景与适用范围

适用于需要容器化部署MongoDB 3.6数据库的场景，包括开发、测试及生产环境。支持数据持久化存储、用户权限管理、自定义配置及SSL/TLS加密，满足不同规模应用的NoSQL数据库需求。

使用方法

以下示例基于rhscl/mongodb-36-rhel7镜像，如需使用CentOS镜像，替换镜像名为centos7/mongodb-36-centos7即可。

基本部署命令

若只需设置必要环境变量并将数据库存储在主机的/home/user/database目录，执行以下命令：

bash
$ docker run -d \
  -e MONGODB_USER=<用户> \
  -e MONGODB_PASSWORD=<密码> \
  -e MONGODB_DATABASE=<数据库名> \
  -e MONGODB_ADMIN_PASSWORD=<管理员密码> \
  -v /home/user/database:/var/lib/mongodb/data \
  rhscl/mongodb-36-rhel7

初始化说明

• 首次使用指定的共享卷初始化数据库时，将创建两个用户：admin（管理员）和MONGODB_USER（普通用户），随后启动MongoDB守护进程。
• 若将卷重新挂载到另一个容器，将跳过数据库用户和管理员用户的创建，仅更新用户密码并启动MongoDB守护进程。

环境变量与卷

环境变量

通过-e VAR=VALUE参数传递以下环境变量进行初始化配置：

必选环境变量

• MONGODB_ADMIN_PASSWORD：管理员用户密码（管理员用户名为固定admin）。

可选用户配置（需同时指定以下三个变量）

• MONGODB_USER：要创建的数据库用户名称。
• MONGODB_PASSWORD：数据库用户密码。
• MONGODB_DATABASE：数据库名称。

可选配置变量

• MONGODB_QUIET（默认值：true）：启用MongoDB静默模式，减少输出信息。
• WIREDTIGER_CACHE_SIZE：WiredTiger缓存大小（对应cache_size配置项的值）。

卷挂载

通过-v /host:/container参数挂载以下目录：

• /var/lib/mongodb/data：MongoDB数据目录。

注意：从主机挂载目录到容器时，需确保挂载目录具有适当权限，且目录的所有者和组与容器内运行的用户UID或名称匹配。

MongoDB 管理员用户

管理员用户名为固定的admin，密码通过MONGODB_ADMIN_PASSWORD环境变量设置。该用户拥有以下角色：

• dbAdminAnyDatabase
• userAdminAnyDatabase
• readWriteAnyDatabase
• clusterAdmin

更多角色说明参见MongoDB官方文档。

可选非特权用户

$MONGODB_USER用户将在$MONGODB_DATABASE数据库中创建，密码通过MONGODB_PASSWORD环境变量设置。该用户仅拥有对目标数据库的readWrite角色。

更改密码

数据库用户（MONGODB_USER）和管理员用户（admin）的密码仅支持通过修改环境变量MONGODB_PASSWORD和MONGODB_ADMIN_PASSWORD进行更新。直接在MongoDB中修改密码会导致环境变量值与实际密码不匹配，容器启动时将自动重置为环境变量指定的值。

扩展镜像

可使用https://github.com/openshift/source-to-image%EF%BC%88s2i%EF%BC%89%E6%89%A9%E5%B1%95%E9%95%9C%E5%83%8F%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%8C%E4%BD%BF%E7%94%A8%60~/image-configuration/%60%E7%9B%AE%E5%BD%95%E4%B8%AD%E7%9A%84%E9%85%8D%E7%BD%AE%E6%9E%84%E5%BB%BA%E8%87%AA%E5%AE%9A%E4%B9%89%E9%95%9C%E5%83%8F%60my-mongodb-centos7%60%EF%BC%9A

bash
$ s2i build ~/image-configuration/ centos/mongodb-36-centos7 my-mongodb-centos7

配置目录结构

s2i build指定的目录需包含以下一个或多个子目录：

mongodb-cfg/

• 包含mongod.conf文件，用于mongod配置（运行run-mongod或run-mongod-replication命令时生效）。
• 对该文件执行envsubst命令，支持通过环境变量自定义配置。
• 副本集名称需通过MONGODB_REPLICA_NAME环境变量设置，不支持通过自定义配置文件修改。
• 不支持通过自定义配置文件配置SSL。

mongodb-ssl/

• 用于配置MongoDB服务器SSL/TLS支持的证书文件。
  • mongodb.pem：包含公钥证书及其关联私钥的文件（不支持私钥加密，参见官方文档）。
  • ca.pem（可选）：包含证书颁发机构（CA）的根证书链文件（参见官方文档）。
• 注意：为允许内部脚本连接，SSL证书的SAN字段必须包含localhost。

mongodb-pre-init/

• 包含的shell脚本（*.sh）在mongod服务器启动前执行。

mongodb-init/

• 包含的shell脚本（*.sh）在mongod服务器首次启动（数据目录为空）时执行。
  • run-mongod命令在此阶段未启用认证。
  • run-mongod-replication命令在此阶段已启用认证。

mongodb-start/

• 语义与mongodb-init/相同，但脚本始终执行（若mongodb-init/脚本存在，则在其后执行）。
• 若run-mongod-replication命令用于已初始化的数据目录，将跳过这些脚本。

脚本可用变量

自定义脚本中可使用以下变量：

• mongo_common_args：mongod服务器的参数（修改可能导致默认自定义脚本失效）。
• shell_args：mongo shell的全局参数（如SSL连接参数），可通过mongo_cmd函数使用（内部脚本中已定义）。
• $MEMBER_ID：仅在副本集脚本（run-mongod-replication命令）中定义，表示容器的副本集成员ID，不同副本集节点的值不同，可用于编写仅在特定节点执行的脚本。

配置覆盖

s2i build会将所有配置文件复制到新镜像的/opt/app-root/src目录。若目标目录已存在同名文件，将被覆盖。用户提供的文件优先级高于/usr/share/container-scripts/mongodb/中的默认文件，支持覆盖默认配置。

也可通过docker run挂载目录覆盖镜像内置配置：将配置目录挂载到/opt/app-root/src/（-v ./image-configuration/:/opt/app-root/src/）。

故障排除

容器中的mongod守护进程日志输出到标准输出，可通过以下命令查看容器日志：

bash
docker logs <容器ID>

另请参见

该容器镜像的Dockerfile及其他源码可在https://github.com/sclorg/mongodb-container%E8%8E%B7%E5%8F%96%E3%80%82%E4%BB%93%E5%BA%93%E4%B8%AD%EF%BC%9A

• CentOS版本的Dockerfile名为Dockerfile
• RHEL版本的Dockerfile名为Dockerfile.rhel7