p2media/node

Node.js预安装全局模块环境镜像

镜像概述和主要用途

概述

该镜像提供一个配置完整的Node.js运行环境，已预先安装常用全局Node.js模块，旨在简化Node.js应用的开发、测试和部署流程。通过集成常用全局依赖，可直接启动开发或生产环境，避免重复安装依赖的时间成本。

主要用途

• 快速搭建Node.js应用本地开发环境
• 部署依赖特定全局模块的Node.js服务
• 作为CI/CD流水线中的构建或测试环境
• 演示或教学场景中的Node.js环境快速初始化

核心功能和特性

核心功能

• 内置指定版本的Node.js运行时（具体版本可通过标签指定）
• 预安装常用全局Node.js模块，如npm、yarn、pm2、nodemon、typescript等
• 基于轻量级基础镜像（如Alpine Linux）构建，减少镜像体积
• 支持标准Node.js应用运行和调试流程

特性

• 依赖预配置：无需手动执行npm install -g安装全局模块
• 版本锁定：Node.js版本和全局模块版本固定，确保环境一致性
• 即开即用：拉取镜像后可直接运行Node.js应用
• 可扩展性：支持通过Dockerfile或运行时命令扩展自定义模块

使用场景和适用范围

适用场景

• 本地开发：开发者无需在本地系统安装Node.js，直接通过容器启动开发环境
• 容器化部署：生产环境中快速部署依赖全局模块的Node.js服务（如PM2进程管理）
• CI/CD流水线：在自动化流程中作为构建环境，执行代码检查、编译、测试等操作
• 多版本隔离：通过不同标签镜像同时管理多个Node.js版本开发环境

适用范围

• 需要全局Node.js模块的应用（如使用pm2管理进程、nodemon热重载的项目）
• 追求环境一致性的团队协作场景
• 对部署速度有要求的自动化流程

使用方法和配置说明

基本使用

拉取镜像

bash
# 拉取最新版本
docker pull [镜像名称]:latest

# 拉取指定Node.js版本（如18.x）
docker pull [镜像名称]:18

启动交互式终端

bash
docker run -it --rm [镜像名称] /bin/sh

进入终端后可直接使用Node.js和预安装模块：

bash
# 验证Node.js版本
node -v

# 验证全局模块
npm list -g --depth=0

运行Node.js应用

假设本地有app.js文件，通过挂载目录运行：

bash
docker run -v $(pwd):/app -w /app [镜像名称] node app.js

使用PM2启动应用

若预安装pm2，可通过配置文件启动应用：

bash
# 挂载应用目录和pm2配置文件
docker run -d -v $(pwd):/app -w /app --name node-app [镜像名称] pm2 start pm2.config.js --no-daemon

Docker Compose配置示例

创建docker-compose.yml：

yaml
version: '3'
services:
  node-app:
    image: [镜像名称]:latest
    volumes:
      - ./app:/app
    working_dir: /app
    command: nodemon app.js  # 使用nodemon实现热重载
    ports:
      - "3000:3000"  # 映射应用端口
    environment:
      - NODE_ENV=development  # 设置环境变量

启动服务：

bash
docker-compose up -d

自定义配置

添加额外全局模块

通过Dockerfile基于该镜像扩展：

dockerfile
FROM [镜像名称]:latest
RUN npm install -g eslint prettier  # 添加自定义全局模块

设置环境变量

运行时通过-e参数传递环境变量：

bash
docker run -e NODE_ENV=production -e PORT=8080 [镜像名称] node server.js

注意事项

• 具体预安装模块列表可通过docker run --rm [镜像名称] npm list -g --depth=0查看
• 生产环境建议使用固定版本标签（如:18.18.0）而非:latest，确保环境稳定性
• 若需持久化数据或配置，需通过-v参数挂载宿主机目录