centos/mongodb-34-centos7

MongoDB 3.4 NoSQL Database Server 容器镜像

镜像概述和主要用途

本仓库包含用于通用场景和OpenShift的MongoDB容器镜像Dockerfile，用户可选择基于RHEL或CentOS的镜像。RHEL镜像可从Red Hat容器目录获取，镜像名为registry.access.redhat.com/rhscl/mongodb-34-rhel7；CentOS镜像可从https://hub.docker.com/r/centos/mongodb-34-centos7/%E8%8E%B7%E5%8F%96%EF%BC%8C%E9%95%9C%E5%83%8F%E5%90%8D%E4%B8%BA%60centos/mongodb-34-centos7%60%E3%80%82

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

核心功能和特性

• 多基础镜像支持：提供基于RHEL和CentOS的两种镜像选择，适应不同环境需求。
• 完整数据库服务：包含mongod守护进程和客户端应用，支持数据库连接与数据访问。
• 用户认证机制：支持创建管理员用户和普通用户，实现基于角色的权限控制。
• 数据持久化：通过卷挂载实现数据库数据的持久化存储。
• 配置灵活性：支持通过环境变量自定义数据库配置，如WiredTiger缓存大小、日志级别等。
• 可扩展性：支持使用source-to-image (s2i)构建自定义镜像，通过配置目录扩展功能。

使用场景和适用范围

适用于需要容器化部署MongoDB 3.4数据库的场景，包括但不限于：

• 开发环境中的数据库服务搭建
• 测试环境的快速部署与数据隔离
• 生产环境中需要持久化存储和用户认证的MongoDB服务

使用方法和配置说明

基本使用示例

以下示例基于rhscl/mongodb-34-rhel7镜像。若只需设置必填环境变量并将数据库存储在主机的/home/user/database目录，执行以下命令：

bash
$ docker run -d \
  -e MONGODB_USER=<user> \
  -e MONGODB_PASSWORD=<password> \
  -e MONGODB_DATABASE=<database> \
  -e MONGODB_ADMIN_PASSWORD=<admin_password> \
  -v /home/user/database:/var/lib/mongodb/data \
  rhscl/mongodb-34-rhel7

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

环境变量说明

必填环境变量

可选环境变量

卷挂载说明

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

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

MongoDB 用户与权限

管理员用户

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

• dbAdminAnyDatabase：所有数据库的管理权限
• userAdminAnyDatabase：所有数据库的用户管理权限
• readWriteAnyDatabase：所有数据库的读写权限
• clusterAdmin：集群管理权限

（权限详情参见MongoDB官方文档）

普通用户

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

修改密码

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

扩展镜像

可使用https://github.com/openshift/source-to-image%EF%BC%88s2i%EF%BC%89%E6%9E%84%E5%BB%BA%E8%87%AA%E5%AE%9A%E4%B9%89MongoDB%E9%95%9C%E5%83%8F%E3%80%82%E4%BE%8B%E5%A6%82%EF%BC%8C%E5%9F%BA%E4%BA%8E%60centos/mongodb-34-centos7%60%E9%95%9C%E5%83%8F%E5%92%8C%60~/image-configuration/%60%E7%9B%AE%E5%BD%95%E4%B8%8B%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-34-centos7 my-mongodb-centos7

配置目录结构

s2i build指定的目录可包含以下子目录，用于自定义镜像功能：

mongodb-cfg/

包含mongod.conf文件，用于mongod服务配置。

• 会对该文件执行envsubst命令，支持通过环境变量自定义配置。
• 副本集名称需通过MONGODB_REPLICA_NAME环境变量设置，不受该配置文件影响。
• 不支持通过该文件配置SSL。

mongodb-ssl/

包含SSL/TLS证书，用于配置MongoDB服务的SSL/TLS支持。

注意：为允许内部脚本连接，SSL证书的SAN字段必须包含localhost。

• mongodb.pem：包含公钥证书和私钥的文件（不支持私钥加密，详情参见官方文档）。
• ca.pem（可选）：包含证书颁发机构（CA）根证书链的文件（详情参见官方文档）。

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/：

bash
-v ./image-configuration/:/opt/app-root/src/

故障排除

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

bash
docker logs <container>

参考资料

• 该容器镜像的Dockerfile及源码可在GitHub仓库获取：https://github.com/sclorg/mongodb-container
• 仓库中，CentOS版本的Dockerfile名为Dockerfile，RHEL版本的Dockerfile名为Dockerfile.rhel7。