manios/mongo

manios/mongo Docker镜像文档

镜像概述

基于官方Mongo镜像3.0.15版本的commit https://github.com/docker-library/mongo/tree/https://github.com/docker-library/mongo/tree/7b2fe2cd853161fdb6d28d318e9e7968e51d0ee3%E6%9E%84%E5%BB%BA%EF%BC%8C%E4%B8%93%E6%B3%A8%E4%BA%8E%E6%8F%90%E4%BE%9B3.x%E4%B9%8B%E5%89%8D%E7%89%88%E6%9C%AC%E7%9A%84MongoDB%E6%94%AF%E6%8C%81%E3%80%82

支持的标签及对应Dockerfile链接

• 2.6.0, 2.6, latest https://github.com/manios/mongo-docker/blob/master/2.6/Dockerfile

https://images.microbadger.com/badges/image/manios/mongo.svg](http://microbadger.com/images/manios/mongo) https://img.shields.io/travis/manios/mongo-docker/master.svg](https://travis-ci.org/manios/mongo-docker/branches)

什么是MongoDB？

MongoDB（源自"humongous"）是一个跨平台的面向文档的数据库。作为NoSQL数据库的一种，MongoDB摒弃了传统的基于表的关系型数据库结构，转而采用类JSON的文档（MongoDB称为BSON格式）和动态模式，使某些类型应用的数据集成更加简单快捷。MongoDB在GNU Affero通用公共许可证和Apache许可证的双重许可下发布，是免费开源软件。

最初由软件公司10gen（现MongoDB Inc.）于2007年10月开发，作为计划中的平台即服务产品的组件，该公司于2009年转向开源开发模式，10gen提供商业支持和其他服务。此后，MongoDB被众多主要网站和服务采用作为后端软件，包括Craigslist、eBay、Foursquare、SourceForge、Viacom和《纽约时报》等。MongoDB是最受欢迎的NoSQL数据库系统。

***.org/wiki/MongoDB

!https://raw.githubusercontent.com/docker-library/docs/01c***b2fe592c1f93a13b4e289ada0e3a1/mongo/logo.png

如何使用此镜像

启动Mongo实例

console
$ docker run --name some-mongo -d manios/mongo

此镜像包含EXPOSE 27017（Mongo端口），因此标准容器链接会自动使其对链接的容器可用（如下例所示）。

从应用程序连接

console
$ docker run --name some-app --link some-mongo:manios/mongo -d application-that-uses-mongo

通过mongo客户端连接

console
$ docker run -it --link some-mongo:mongo --rm manios/mongo sh -c 'exec mongo "$MONGO_PORT_27017_TCP_ADDR:$MONGO_PORT_27017_TCP_PORT/test"'

配置

有关使用和配置MongoDB（如副本集和分片）的信息，请参阅https://docs.mongodb.com/manual/%E3%80%82

如果要在MongoDB 3.0及以上版本中使用WiredTiger存储引擎而不创建配置文件，只需添加--storageEngine参数。WiredTiger是MongoDB 3.2及以上版本的默认存储引擎。请务必查看https://docs.mongodb.com/manual/release-notes/3.0-upgrade/#change-storage-engine-for-standalone-to-wiredtiger%E4%BA%86%E8%A7%A3%E5%A6%82%E4%BD%95%E4%BB%8E%E6%97%A7%E7%89%88%E6%9C%AC%E5%8D%87%E7%BA%A7%E3%80%82

console
$ docker run --name some-mongo -d manios/mongo --storageEngine wiredTiger

身份验证和授权

MongoDB默认不需要身份验证，但可以配置为需要。有关此处描述的功能的更多详细信息，请参阅官方文档中详细描述https://docs.mongodb.com/manual/core/authentication/%E5%92%8Chttps://docs.mongodb.com/manual/core/authorization/%E7%9A%84%E9%83%A8%E5%88%86%E3%80%82

启动数据库

console
$ docker run --name some-mongo -d manios/mongo --auth

添加初始管理员用户

console
$ docker exec -it some-mongo mongo admin
connecting to: admin
> db.createUser({ user: 'jsmith', pwd: 'some-initial-password', roles: [ { role: "userAdminAnyDatabase", db: "admin" } ] });
Successfully added user: {
	"user" : "jsmith",
	"roles" : [
		{
			"role" : "userAdminAnyDatabase",
			"db" : "admin"
		}
	]
}

外部连接

console
$ docker run -it --rm --link some-mongo:mongo manios/mongo mongo -u jsmith -p some-initial-password --authenticationDatabase admin some-mongo/some-db
> db.getName();
some-db

将日志写入卷中的文件

传统上，此镜像将日志输出到stdout。要将日志写入文件，请使用以下命令：

console
$ docker run \
   -d \
   --name some-mongo \
   -v /my/own/logdir:/data/log \
   manios/mongo:2.6 
     --logpath /data/log/mongo.log \

命令中的-v /my/own/logdir:/data/log部分将主机系统的/my/own/logdir目录挂载为容器内的/data/log，MongoDB默认会将日志文件写入该目录。

与主机共享相同的日期时间

默认情况下，Docker使用UTC作为其时区。如果希望容器内的日期时间与主机相同并在日志中正确显示，可以使用以下命令：

console
$ docker run \
   -d \
   --name some-mongo \
   -v /my/own/logdir:/data/log \
   -v /etc/localtime:/etc/localtime \
   manios/mongo:2.6 
     --logpath /data/log/mongo.log \

命令中的-v /etc/localtime:/etc/localtime部分将主机系统的/etc/localtime文件挂载为容器内的/etc/localtime。因此，MongoDB将在其日志文件中使用与主机相同的时区显示日期和时间。

数据存储位置

重要说明：有多种方式存储Docker容器中运行的应用程序使用的数据。我们建议mongo镜像的用户熟悉可用选项，包括：

• 让Docker通过https://docs.docker.com/engine/tutorials/dockervolumes/#adding-a-data-volume%E6%9D%A5%E7%AE%A1%E7%90%86%E6%95%B0%E6%8D%AE%E5%BA%93%E6%95%B0%E6%8D%AE%E7%9A%84%E5%AD%98%E5%82%A8%E3%80%82%E8%BF%99%E6%98%AF%E9%BB%98%E8%AE%A4%E9%80%89%E9%A1%B9%EF%BC%8C%E5%AF%B9%E7%94%A8%E6%88%B7%E6%9D%A5%E8%AF%B4%E7%AE%80%E5%8D%95%E4%B8%94%E7%9B%B8%E5%BD%93%E9%80%8F%E6%98%8E%E3%80%82%E7%BC%BA%E7%82%B9%E6%98%AF%E5%AF%B9%E4%BA%8E%E7%9B%B4%E6%8E%A5%E5%9C%A8%E4%B8%BB%E6%9C%BA%E7%B3%BB%E7%BB%9F%EF%BC%88%E5%8D%B3%E5%AE%B9%E5%99%A8%E5%A4%96%E9%83%A8%EF%BC%89%E8%BF%90%E8%A1%8C%E7%9A%84%E5%B7%A5%E5%85%B7%E5%92%8C%E5%BA%94%E7%94%A8%E7%A8%8B%E5%BA%8F%EF%BC%8C%E5%8F%AF%E8%83%BD%E9%9A%BE%E4%BB%A5%E5%AE%9A%E4%BD%8D%E6%96%87%E4%BB%B6%E3%80%82
• 在主机系统上（容器外部）创建数据目录，并https://docs.docker.com/engine/tutorials/dockervolumes/#mount-a-host-directory-as-a-data-volume%E3%80%82%E8%BF%99%E4%BC%9A%E5%B0%86%E6%95%B0%E6%8D%AE%E5%BA%93%E6%96%87%E4%BB%B6%E6%94%BE%E7%BD%AE%E5%9C%A8%E4%B8%BB%E6%9C%BA%E7%B3%BB%E7%BB%9F%E4%B8%8A%E7%9A%84%E5%B7%B2%E7%9F%A5%E4%BD%8D%E7%BD%AE%EF%BC%8C%E4%BE%BF%E4%BA%8E%E4%B8%BB%E6%9C%BA%E7%B3%BB%E7%BB%9F%E4%B8%8A%E7%9A%84%E5%B7%A5%E5%85%B7%E5%92%8C%E5%BA%94%E7%94%A8%E7%A8%8B%E5%BA%8F%E8%AE%BF%E9%97%AE%E6%96%87%E4%BB%B6%E3%80%82%E7%BC%BA%E7%82%B9%E6%98%AF%E7%94%A8%E6%88%B7%E9%9C%80%E8%A6%81%E7%A1%AE%E4%BF%9D%E7%9B%AE%E5%BD%95%E5%AD%98%E5%9C%A8%EF%BC%8C%E5%B9%B6%E4%B8%94%E4%B8%BB%E6%9C%BA%E7%B3%BB%E7%BB%9F%E4%B8%8A%E7%9A%84%E7%9B%AE%E5%BD%95%E6%9D%83%E9%99%90%E5%92%8C%E5%85%B6%E4%BB%96%E5%AE%89%E5%85%A8%E6%9C%BA%E5%88%B6%E8%AE%BE%E7%BD%AE%E6%AD%A3%E7%A1%AE%E3%80%82

警告（Windows和OS X）：Windows和OS X上的默认Docker设置使用VirtualBox VM托管Docker守护进程。不幸的是，VirtualBox用于在主机系统和Docker容器之间共享文件夹的机制与MongoDB使用的内存映射文件不兼容（参见https://www.virtualbox.org/ticket/819%E3%80%81https://docs.mongodb.com/manual/administration/production-notes/#fsync-on-directories%E5%92%8C%E7%9B%B8%E5%85%B3%E7%9A%84https://jira.mongodb.org/browse/SERVER-8600 bug）。这意味着无法运行将数据目录映射到主机的MongoDB容器。

Docker文档是了解不同存储选项和变体的良好起点，有多个博客和论坛帖子讨论并提供该领域的建议。我们在此仅展示上述后一种选项的基本步骤：

1. 在主机系统的合适卷上创建数据目录，例如/my/own/datadir。

2. 像这样启动mongo容器：

   console
   $ docker run --name some-mongo -v /my/own/datadir:/data/db -d manios/mongo:tag
   

命令中的-v /my/own/datadir:/data/db部分将主机系统的/my/own/datadir目录挂载为容器内的/data/db，MongoDB默认会将其数据文件写入该目录。

此镜像还为/data/configdb定义了一个卷https://docs.mongodb.com/v2.6/reference/program/mongod/#cmdoption-configsvr%E3%80%82

请注意，启用SELinux的主机系统上的用户可能会遇到此问题。当前的解决方法是为新数据目录分配相关的SELinux策略类型，以便容器被允许访问它：

console
$ chcon -Rt svirt_sandbox_file_t /my/own/datadir

mongo:<version>

这是默认镜像。如果不确定自己的需求，可能需要使用此镜像。它设计为既可作为临时容器（挂载源代码并启动容器以启动应用程序），也可作为构建其他镜像的基础。