dsyko/meteor-launchpad

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

镜像概述和主要用途

Meteor Launchpad是一个为Meteor应用设计的基础Docker镜像，旨在简化Meteor应用的构建、部署和运行流程。它内置完整的生产环境构建流程，支持自定义依赖安装，以非root用户运行增强安全性，并提供开发环境优化选项，适用于Meteor应用的开发、测试和生产部署场景。

核心功能和特性

• 生产环境优化：自动处理Meteor应用的依赖管理和构建流程，生成精简的生产镜像
• 安全运行机制：以非root用户身份运行应用，默认监听3000端口（避免特权端口使用）
• 灵活依赖管理：支持安装MongoDB、PhantomJS、GraphicsMagick等额外组件，或通过apt-get添加系统依赖
• 数据库适配：可连接外部MongoDB或在容器内启动MongoDB（仅建议测试/开发环境）
• 启动控制：支持设置启动延迟（STARTUP_DELAY），等待外部服务就绪
• 开发加速：提供devbuild标签，跳过重复下载Meteor，加速频繁开发构建
• 多容器集成：提供Docker Compose配置模板，简化应用与数据库的协同部署

使用场景和适用范围

• Meteor应用的容器化部署（开发、测试和生产环境）
• 需要自定义系统依赖或组件的Meteor应用（如图像处理、PDF生成等场景）
• 希望简化部署流程，避免手动配置Meteor运行环境的开发团队
• 开发过程中需要频繁构建镜像，追求构建效率的场景

使用方法和配置说明

构建镜像

创建Dockerfile

在应用根目录创建Dockerfile：

Dockerfile
FROM dsyko/meteor-launchpad:latest

执行构建命令

sh
docker build -t yourname/app .

配置.dockerignore文件

为避免不必要文件复制到容器，在应用根目录创建.dockerignore：

.git
.meteor/local
node_modules

运行容器

基本运行命令

应用默认监听3000端口，映射到主机80端口：

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

环境变量说明

• ROOT_URL：应用的根URL（必填）
• MONGO_URL：MongoDB连接URL（外部数据库，必填）
• MONGO_OPLOG_URL：MongoDB Oplog连接URL（可选，用于数据同步）
• MAIL_URL：邮件服务连接URL（可选）
• 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

构建选项

支持通过配置文件或Docker build args自定义构建过程，可安装额外组件、指定Node版本等。

方法1：使用launchpad.conf配置文件

在应用根目录创建launchpad.conf：

sh
# launchpad.conf

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

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

# 安装组件开关（默认：均为false）
INSTALL_MONGO=true          # 安装MongoDB
INSTALL_PHANTOMJS=true      # 安装PhantomJS
INSTALL_GRAPHICSMAGICK=true # 安装GraphicsMagick

方法2：使用Docker Build Args

构建时通过--build-arg传递参数：

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

MongoDB使用说明

• 内部MongoDB：未提供MONGO_URL时，容器内自动启动MongoDB（仅建议测试/开发）
• 外部MongoDB：提供MONGO_URL时，容器内MongoDB不会启动，应用使用外部数据库（生产环境推荐）

安装私有NPM包

通过NPM_TOKEN build arg提供NPM认证令牌：

sh
docker build --build-arg NPM_TOKEN="<your token>" -t myorg/myapp:latest .

开发构建

为加速频繁开发构建，使用devbuild标签（不建议生产环境，镜像较大）：

Dockerfile
FROM dsyko/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
  command: mongod --storageEngine=wiredTiger

启动应用和数据库容器：

sh
docker-compose up -d

自定义Meteor Launchpad构建

如需修改Meteor Launchpad基础镜像，使用项目根目录的build.sh脚本：

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

许可证

MIT许可证

版权所有 (c) 2017 Jeremy Shimko

特此授予任何获得本软件及相关文档文件（以下简称“软件”）副本的人免费许可，不受限制地处理本软件，包括但不限于使用、复制、修改、合并、出版、分发、再许可和/或出售软件副本的权利，并允许向其提供软件的人这样做，但须符合以下条件：

上述版权声明和本许可声明应包含在软件的所有副本或主要部分中。

本软件按“原样”提供，不提供任何明示或暗示的担保，包括但不限于对适销性、特定用途适用性和非侵权性的担保。在任何情况下，作者或版权持有人均不对因软件或软件的使用或其他交易而产生的任何索赔、损害或其他责任承担责任，无论是合同诉讼、侵权行为还是其他形式。