meteorhacks/meteord

项目已不再维护

请使用https://github.com/jshimko/meteor-launchpad%E4%BD%9C%E4%B8%BA%E7%A8%B3%E5%AE%9A%E4%B8%94%E7%BB%B4%E6%8A%A4%E4%B8%AD%E7%9A%84Meteor%E5%BA%94%E7%94%A8Docker%E5%9F%BA%E7%A1%80%E9%95%9C%E5%83%8F%E3%80%82

![Circle CI]([***]

MeteorD - Meteor应用的Docker运行时

Docker与Meteor应用结合主要有两种方式：

1. 为应用构建Docker镜像
2. 使用Docker运行Meteor bundle

MeteorD支持以上两种方式，以下是具体使用方法

1. 为应用构建Docker镜像

通过此方法，应用将被转换为Docker镜像，之后可直接运行该镜像。

只需将meteorhacks/meteord:onbuild作为基础镜像即可，具体步骤如下：

在应用根目录添加以下Dockerfile：

shell
FROM meteorhacks/meteord:onbuild

构建Docker镜像：

shell
docker build -t yourname/app .

运行镜像：

shell
docker run -d \
    -e ROOT_URL=http://yourapp.com \
    -e MONGO_URL=mongodb://url \
    -e MONGO_OPLOG_URL=mongodb://oplog_url \
    -p 8080:80 \
    yourname/app

应用可通过主机的8080端口访问。

避免重复下载Meteor（主要用于开发环境）

上述方法中，MeteorD会每次下载并安装Meteor，在开发环境中效率较低。可使用meteorhacks/meteord:devbuild作为基础镜像解决此问题。

警告：不要将meteorhacks/meteord:devbuild用于最终构建。使用该镜像会使最终镜像包含Meteor发行版，导致镜像大小约为700MB。

2. 使用Docker运行Meteor bundle

可直接使用MeteorD运行Meteor bundle，支持通过本地挂载或网络URL获取bundle。

2.1 本地挂载

shell
docker run -d \
    -e ROOT_URL=http://yourapp.com \
    -e MONGO_URL=mongodb://url \
    -e MONGO_OPLOG_URL=mongodb://oplog_url \
    -v /mybundle_dir:/bundle \
    -p 8080:80 \
    meteorhacks/meteord:base

此方法要求Meteor bundle为tarball格式，且需构建适用于os.linux.x86_64架构的bundle并放入/bundle卷中。构建bundle的命令如下：

shell
meteor build --architecture=os.linux.x86_64 ./

2.2 从网络获取

通过BUNDLE_URL环境变量指定tarball的URL，MeteorD会自动下载并运行bundle：

shell
docker run -d \
    -e ROOT_URL=http://yourapp.com \
    -e MONGO_URL=mongodb://url \
    -e MONGO_OPLOG_URL=mongodb://oplog_url \
    -e BUNDLE_URL=http://mybundle_url_at_s3.tar.gz \
    -p 8080:80 \
    meteorhacks/meteord:base

2.3 使用Docker Compose

docker-compose.yml配置示例：

shell
dashboard:
  image: yourrepo/yourapp
  ports:
   - "80:80"
  links:
   - mongo
  environment:
   - MONGO_URL=mongodb://mongo/yourapp
   - ROOT_URL=http://yourapp.com
   - MAIL_URL=smtp://some.mailserver.com:25

mongo:
  image: mongo:latest

使用Docker Compose同时启动Meteor容器和Mongo容器时，需等待数据库启动后再启动Meteor应用，否则容器可能启动失败。上述配置示例指定了容器监听端口、传递给Meteor的必要环境变量，并在启动Meteor容器前等待Mongo容器启动30秒。

重建二进制NPM模块

如需重建二进制NPM模块，可设置REBUILD_NPM_MODULES环境变量，此过程需数秒时间：

shell
docker run -d \
    -e ROOT_URL=http://yourapp.com \
    -e MONGO_URL=mongodb://url \
    -e MONGO_OPLOG_URL=mongodb://oplog_url \
    -e BUNDLE_URL=http://mybundle_url_at_s3.tar.gz \
    -e REBUILD_NPM_MODULES=1 \
    -p 8080:80 \
    meteorhacks/meteord:binbuild

已知问题

Spiderable无法工作（有解决方案）

在Docker容器中运行spiderable存在问题，详情参见：https://github.com/meteor/meteor/issues/2429

解决方案：使用https://github.com/ongoworks/spiderable%E6%9B%BF%E4%BB%A3%E5%AE%98%E6%96%B9%E5%8C%85%E3%80%82

在Joyent的Triton基础设施上容器无法启动

当前（2015-07-18）存在命令或入口点解析问题，导致使用上述docker run命令无法启动容器。

Joyent支持建议以下临时解决方法，直至修复发布：

shell
docker run -d \
    -e ROOT_URL=[***] \
    -e MONGO_URL=mongodb://url \
    -e MONGO_OPLOG_URL=mongodb://oplog_url \
    -p 80:80 \
    --entrypoint=bash \
    yourname/app \
    /opt/meteord/run_app.sh