geoffreybooth/meteor-base Docker 镜像 - 轩辕镜像

Meteor应用基础Docker镜像文档

镜像概述和主要用途

本镜像为Meteor应用提供基础Docker镜像支持，基于多阶段Dockerfile构建。其核心价值在于简化Meteor应用的Docker化流程，通过多阶段构建机制优化最终镜像体积与安全性，同时隔离构建环境以确保一致性。

核心功能和特性

构建流程优化

• 内置构建能力：在Docker镜像构建过程中完成Meteor应用的构建/打包，无需在构建机预先安装Node或Meteor依赖，降低环境配置复杂度。
• 隔离与可重复：构建环境完全隔离，确保不同环境下的构建结果一致，满足持续集成场景的可重复构建需求。

镜像体积与安全性优化

• 小型化最终镜像：通过多阶段构建，最终镜像不含Meteor环境，体积显著减小。
• Alpine Linux基础：采用Alpine Linux作为基础镜像，减少系统表面面积，降低安全扫描中发现漏洞的概率。

使用场景和适用范围

• 持续集成环境：无需在CI服务器安装Meteor或Node，简化环境配置。
• 安全敏感场景：需要通过安全扫描、减少漏洞暴露面的应用部署。
• 隔离构建需求：需确保构建环境一致性、避免依赖冲突的开发或生产环境。
• Meteor应用容器化：所有需要Docker化部署的Meteor应用项目。

使用方法和配置说明

快速开始步骤

1. 准备文件

将以下示例文件复制到项目根目录：

• Dockerfile：应用构建配置文件
• .dockerignore：Docker构建忽略规则
• docker-compose.yml：容器编排配置

2. 调整应用路径

默认示例Dockerfile假设Meteor应用位于项目根目录下的app文件夹中。根据实际情况：

• 若应用已在app文件夹，无需调整；
• 若应用在其他路径或项目根目录，修改Dockerfile中的路径配置指向应用位置。

3. 构建并启动

在项目根目录执行以下命令：

bash
docker-compose up

该命令会构建应用镜像，启动应用容器及关联的MongoDB容器。

4. 访问应用

构建完成后，通过http://localhost/访问运行中的Meteor应用。

配置说明

• Dockerfile：控制多阶段构建流程，包括依赖安装、应用打包、最终镜像构建等步骤，可根据需求调整（如添加系统依赖）。
• .dockerignore：排除无需打包的文件（如node_modules、.meteor/local等），减小构建上下文体积。
• docker-compose.yml：定义应用容器与MongoDB容器的关联配置，默认包含端口映射、容器链接等基础设置。

自定义调整

• 如需修改应用端口或MongoDB配置，编辑docker-compose.yml中的相关参数；
• 如需添加额外系统依赖，在Dockerfile的构建阶段通过RUN命令安装（如Alpine的apk add）。