jshimko/meteor-launchpad

Meteor Launchpad - Meteor应用的基础Docker镜像

镜像概述和主要用途

Meteor Launchpad是一个专为Meteor应用设计的基础Docker镜像，旨在简化Meteor应用的容器化构建、部署和运行流程。该镜像基于debian:jesse构建，提供了灵活的配置选项，支持自定义依赖安装、Node版本指定、延迟启动等功能，同时兼顾开发和生产环境需求。

核心功能和特性

• 简化构建流程：通过简单的Dockerfile配置即可构建Meteor应用镜像
• 安全运行：使用非root用户运行应用，默认监听3000端口（非root用户无法使用80端口）
• 自定义依赖：支持通过配置文件或构建参数安装额外依赖（如PhantomJS、GraphicsMagick、MongoDB等）
• 延迟启动：可设置启动延迟，等待外部服务（如数据库）就绪
• 开发优化：提供devbuild标签，加速开发环境下的重复构建
• 灵活的数据库配置：支持内部MongoDB（测试用）或外部MongoDB（生产推荐）
• Docker Compose集成：提供完整的Compose配置示例，简化多容器部署

使用场景和适用范围

• Meteor应用的开发、测试和生产环境容器化部署
• 需要快速将Meteor应用Docker化的场景
• 需自定义运行环境依赖的Meteor项目
• 开发过程中频繁构建镜像的场景（使用devbuild标签）

使用方法和配置说明

构建镜像

在应用根目录创建Dockerfile，添加以下内容：

Dockerfile
FROM jshimko/meteor-launchpad:latest

然后执行构建命令：

sh
docker build -t yourname/app .

运行容器

使用以下命令运行容器（应用默认监听3000端口）：

sh
docker run -d \
  -e ROOT_URL=http://example.com \
  -e MONGO_URL=mongodb://url \
  -e MONGO_OPLOG_URL=mongodb://oplog_url \
  -e MAIL_URL=smtp://mail_url.com \
  -p 80:3000 \
  yourname/app

延迟启动

如需延迟Node进程启动（如等待数据库就绪），可设置STARTUP_DELAY环境变量（单位：秒）：

sh
docker run -d \
  -e ROOT_URL=http://example.com \
  -e MONGO_URL=mongodb://url \
  -e STARTUP_DELAY=10 \  # 延迟10秒启动
  -p 80:3000 \
  yourname/app

构建选项

Meteor Launchpad支持两种方式设置自定义构建选项：配置文件（launchpad.conf）或Docker构建参数（--build-arg）。支持的选项包括安装额外依赖、指定Node版本、安装MongoDB等。

选项1：使用launchpad.conf配置文件

在应用根目录创建launchpad.conf文件，添加以下配置（按需选择）：

sh
# launchpad.conf

# 使用apt-get安装额外依赖（默认：未定义）
APT_GET_INSTALL="curl git wget"

# 指定Node版本（默认：最新4.x版本）
NODE_VERSION=4.8.3

# 安装最新版本的组件（默认：均为false）
INSTALL_MONGO=true          # 安装MongoDB
INSTALL_PHANTOMJS=true      # 安装PhantomJS
INSTALL_GRAPHICSMAGICK=true # 安装GraphicsMagick

选项2：使用Docker构建参数

通过--build-arg在构建时指定参数：

sh
docker build \
  --build-arg APT_GET_INSTALL="curl git wget" \
  --build-arg INSTALL_MONGO=true \
  --build-arg NODE_VERSION=4.7.2 \
  -t myorg/myapp:latest .

注意：如安装MongoDB且未提供MONGO_URL，容器将启动内部MongoDB；如提供MONGO_URL，则使用外部数据库。内部MongoDB仅建议用于测试/开发，生产环境应使用独立MongoDB部署或容器。

开发环境构建

为避免开发中重复下载Meteor，可使用devbuild标签加速构建（不建议用于生产，镜像体积较大）：

Dockerfile
FROM jshimko/meteor-launchpad:devbuild

首次构建会下载安装Meteor，后续构建可跳过此步骤，仅构建应用。

Docker Compose配置

在项目根目录创建docker-compose.yml：

yaml
# docker-compose.yml

app:
  image: yourname/app  # 替换为你的镜像名称
  ports:
    - "80:3000"
  links:
    - mongo
  environment:
    - ROOT_URL=http://example.com
    - MONGO_URL=mongodb://mongo:27017/meteor

mongo:
  image: mongo:latest --storageEngine=wiredTiger

启动应用和数据库容器：

sh
docker-compose up -d

自定义Meteor Launchpad构建

如需自定义Meteor Launchpad镜像，可使用项目根目录的build.sh脚本：

sh
# 构建为jshimko/meteor-launchpad:latest
./build.sh

环境变量说明

配置参数说明

许可证

MIT License

Copyright (c) 2017 Jeremy Shimko

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.