Meteor Docker镜像文档

1. 镜像概述和主要用途

1.1 概述

Meteor Docker镜像是专为简化Meteor应用部署而设计的容器化解决方案。该镜像基于官方Node.js基础镜像构建，内置Meteor工具链及运行时依赖，可快速构建、打包和运行Meteor全栈JavaScript应用。

1.2 主要用途

• 提供一致的Meteor应用运行环境，消除"本地运行正常，部署后异常"的环境差异问题
• 简化Meteor应用的构建流程，支持从源码直接构建生产级应用包
• 适配开发、测试、生产多环境部署需求，支持CI/CD流程集成

2. 核心功能和特性

2.1 环境兼容性

• 内置Node.js (LTS版本) 及npm，匹配Meteor官方推荐运行时
• 支持Meteor 1.8+版本应用，自动适配不同版本的构建工具链
• 预安装Python、build-essential等编译依赖，解决原生模块构建问题

2.2 构建优化

• 集成多阶段构建支持，可分离源码构建与运行时环境
• 内置meteor build优化参数，减少构建产物体积
• 支持缓存npm依赖，加速重复构建流程

2.3 运行时增强

• 内置进程管理工具，确保应用崩溃后自动重启
• 支持非root用户运行，提升容器安全性
• 兼容主流容器编排平台（Kubernetes、Docker Compose）

3. 使用场景和适用范围

3.1 开发环境

• 快速搭建本地开发环境，避免系统级依赖冲突
• 支持热重载（需配合卷挂载源码目录）

3.2 测试环境

• 提供与生产环境一致的运行时，确保测试结果可靠性
• 支持并行启动多版本应用实例，用于兼容性测试

3.3 生产环境

• 适用于中小型Meteor应用部署（单实例或集群模式）
• 支持通过环境变量动态配置应用参数

3.4 CI/CD集成

• 可作为CI流程中的构建节点，输出标准化应用包
• 支持与GitLab CI、GitHub Actions等流程无缝对接

4. 使用方法和配置说明

4.1 前提条件

• 已安装Docker Engine (20.10+) 及Docker Compose (v2+)
• Meteor应用源码（本地目录或Git仓库）

4.2 拉取镜像

# 拉取最新稳定版
docker pull meteor/meteor:latest

# 拉取指定Meteor版本（如2.14）
docker pull meteor/meteor:2.14-node18

4.3 构建Meteor应用

4.3.1 基础构建流程

# 进入应用源码目录
cd /path/to/meteor-app

# 启动构建容器（挂载源码目录）
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  meteor/meteor:latest \
  meteor build --directory /app/build --architecture os.linux.x86_64

4.3.2 构建产物说明

构建完成后，/app/build目录下生成：

• bundle/：应用打包文件（包含服务端代码、客户端资源、依赖清单）
• README：部署说明文档

4.4 运行应用容器

4.4.1 直接运行（开发环境）

docker run -it --rm \
  -p 3000:3000 \
  -v $(pwd):/app \
  -w /app \
  -e ROOT_URL=http://localhost:3000 \
  -e MONGO_URL=mongodb://mongo:27017/meteor \
  meteor/meteor:latest \
  meteor run

4.4.2 基于构建产物运行（生产环境）

需先进入构建产物目录：

cd /path/to/meteor-app/build/bundle/programs/server
npm install --production  # 安装生产依赖

# 启动运行容器
docker run -d \
  --name meteor-app \
  -p 3000:3000 \
  -v $(pwd)/../../../:/app \
  -w /app/bundle \
  -e NODE_ENV=production \
  -e ROOT_URL=[***] \
  -e MONGO_URL=mongodb://user:pass@mongo-host:27017/dbname?authSource=admin \
  node:18-alpine \
  node main.js

5. 配置参数与环境变量

5.1 应用核心环境变量

5.2 镜像控制变量

6. Docker部署方案示例

6.1 单容器部署（docker run）

docker run -d \
  --name meteor-prod \
  --restart always \
  -p 80:3000 \
  -e ROOT_URL=[***] \
  -e MONGO_URL=mongodb://mongo-host:27017/prod-db \
  -e NODE_ENV=production \
  -v /data/meteor/logs:/app/logs \
  meteor/meteor:2.14-node18 \
  node /app/bundle/main.js

6.2 多容器部署（docker-compose）

创建docker-compose.yml：

version: '3.8'

services:
  meteor:
    image: meteor/meteor:2.14-node18
    restart: always
    ports:
      - "3000:3000"
    environment:
      - ROOT_URL=[***]
      - MONGO_URL=mongodb://mongo:27017/meteor
      - NODE_ENV=production
      - METEOR_SETTINGS={"public": {"analytics": true}}
    volumes:
      - ./build/bundle:/app/bundle
      - meteor_logs:/app/logs
    depends_on:
      - mongo
    user: "1000:1000"  # 非root用户运行

  mongo:
    image: mongo:5.0
    restart: always
    volumes:
      - mongo_data:/data/db
    command: --wiredTigerCacheSizeGB 1  # 限制内存使用

volumes:
  meteor_logs:
  mongo_data:

启动命令：

docker-compose up -d

7. 注意事项

• 数据持久化：生产环境需通过卷挂载保存应用日志、上传文件等动态数据
• MongoDB配置：建议使用独立MongoDB服务（如MongoDB Atlas），避免容器内数据库数据丢失
• 资源限制：根据应用规模调整容器CPU/内存限制（通过--memory、--cpus参数）
• 安全加固：生产环境需设置user参数使用非root用户，避免挂载敏感目录到容器内
• 版本兼容性：确保镜像标签的Meteor版本与应用meteor --version输出一致，避免构建错误