owncloudops/mongodb

mongodb

镜像概述和主要用途

自定义容器镜像，用于部署MongoDB数据库，支持数据库运行、备份调度及灵活配置，适用于开发和生产环境中的MongoDB部署与数据管理。

核心功能和特性

• 基于MongoDB官方版本构建，提供版本化标签管理
• 支持数据库备份调度功能，可配置持久化存储备份文件
• 提供丰富的环境变量，支持灵活配置数据库参数
• 支持副本集配置及安全认证

版本控制

使用的版本标签代表上游次要版本，补丁版本由项目维护方计数，不直接反映上游完整版本。例如：v5.0.10表示镜像包含MongoDB v5.0，但不一定是MongoDB v5.0.10。

Docker标签及对应Dockerfile链接

• https://github.com/owncloud-ops/mongodb/blob/main/4/Dockerfile%EF%BC%8C%E5%8F%AF%E7%94%A8%E6%A0%87%E7%AD%BE%EF%BC%9A%60owncloud-ops/mongodb:4%60
• https://github.com/owncloud-ops/mongodb/blob/main/5/Dockerfile%EF%BC%8C%E5%8F%AF%E7%94%A8%E6%A0%87%E7%AD%BE%EF%BC%9A%60owncloud-ops/mongodb:latest%60%E3%80%81%60owncloud-ops/mongodb:5%60

环境变量

Shell
MONGO_DATA_DIR=/opt/mongo          # MongoDB数据存储目录
MONGO_DISABLE_SYSTEM_LOG=false     # 是否禁用系统日志
MONGO_SYSTEM_LOG_VERBOSITY=0       # 系统日志详细程度
MONGO_PORT_NUMBER=27017            # MongoDB服务端口
MONGO_REPLICA_SET_NAME=            # 副本集名称（若使用副本集）
MONGO_OPLOG_SIZE=                  # Oplog大小（MB）
MONGO_DIRECTORY_PER_DB=false       # 是否为每个数据库创建独立目录
MONGO_SMALL_FILES=false            # 是否使用小文件模式（减少初始文件大小）
MONGO_ROOT_USERNAME=               # 根用户用户名
MONGO_ROOT_PASSWORD=               # 根用户密码
MONGO_USERNAME=                    # 普通用户用户名
MONGO_PASSWORD=                    # 普通用户密码
MONGO_DATABASE=$MONGO_USERNAME     # 数据库名称（默认与用户名相同）
MONGO_SECURITY_KEYFILE=            # 安全密钥文件路径（用于副本集认证）

MONGO_BACKUP_HOST=mongodb          # 备份目标主机
MONGO_BACKUP_PORT=27017            # 备份目标端口

使用场景和适用范围

• 开发环境中的MongoDB快速部署
• 生产环境中的MongoDB服务运行
• 数据库定期备份与数据保护
• 需要灵活配置的MongoDB实例部署

使用方法和配置说明

基本运行示例

Shell
docker run -d \
    -p 27017:27017 \
    -e MONGO_ROOT_USERNAME=admin \
    -e MONGO_ROOT_PASSWORD=securepassword \
    -v mongo-data:/opt/mongo \
    owncloud-ops/mongodb:latest

备份使用示例

容器可用于调度数据库备份，需确保备份容器与数据库容器在同一网络。备份文件存储在${MONGO_DATA_DIR}/dump，需配置卷或绑定挂载以永久存储备份：

Shell
docker run --no-healthcheck \
    --network my-network \
    --entrypoint /usr/bin/entrypoint \
    -e MONGO_ROOT_USERNAME=admin \
    -e MONGO_ROOT_PASSWORD=password \
    -v mongo-backups:/opt/mongo/dump \
    -it owncloud-ops/mongodb:latest backup

构建镜像

可使用BUILD_VERSION参数指定目标版本：

Shell
docker build --build-arg BUILD_VERSION=5.0.10 -f 5/Dockerfile -t mongodb:latest .

许可证

本项目采用Apache 2.0许可证 - 详见https://github.com/owncloud-ops/mongodb/blob/main/LICENSE%E6%96%87%E4%BB%B6%E3%80%82