rogerdz/node

镜像概述

本镜像基于官方Node.js镜像构建，集成了Node.js运行环境，并预装eslint（静态代码分析工具）和pm2（Node.js应用进程管理工具）。旨在简化Node.js应用的开发流程、代码质量控制及生产环境部署，减少额外工具安装步骤。

核心功能与特性

1. Node.js运行环境

• 提供完整的Node.js运行时环境，支持Node.js应用的直接运行。
• 基于官方Node.js镜像，版本兼容性与官方保持一致（具体版本可通过镜像标签指定，如node-eslint-pm2:18-alpine对应Node.js 18 Alpine版本）。

2. eslint代码检查工具

• 预装eslint及基础配置，支持对JavaScript/TypeScript代码进行自动化语法检查、风格校验和错误检测。
• 可直接在容器内执行eslint命令，无需额外安装依赖。

3. pm2进程管理工具

• 集成pm2进程管理器，支持Node.js应用的启动、停止、重启及日志管理。
• 提供生产级进程守护能力，确保应用崩溃后自动重启，提升服务稳定性。

使用场景与适用范围

开发环境

• 本地Node.js应用开发，利用容器内的eslint进行代码实时检查，确保代码风格一致性。
• 多版本Node.js项目开发，通过切换镜像标签快速切换Node.js运行环境。

生产环境

• Node.js应用部署，通过pm2管理应用进程，实现进程守护、负载均衡及资源监控。
• 微服务架构中Node.js服务的容器化部署，简化依赖管理。

CI/CD流程集成

• 集成到持续集成流程，通过eslint进行代码质量门禁检查。
• 作为构建阶段基础镜像，生成包含应用代码的生产镜像。

使用方法与配置说明

基础使用

拉取镜像

bash
docker pull docker.xuanyuan.run/[镜像名称]:[标签]  # 例如：docker pull docker.xuanyuan.run/node-eslint-pm2:latest

启动交互式容器

bash
docker run -it --rm -v $(pwd):/app [镜像名称]:[标签] /bin/sh

• -v $(pwd):/app：将本地当前目录挂载到容器内/app目录，便于代码编辑与检查。
• --rm：容器退出后自动删除，适合临时开发任务。

代码检查（eslint）

在容器内执行eslint检查当前目录代码：

bash
# 进入容器后
cd /app
eslint .  # 检查当前目录所有文件
eslint src/  # 检查src目录下的文件

可通过挂载自定义eslint配置文件（如.eslintrc.js、.eslintignore）覆盖默认配置：

bash
docker run -it --rm -v $(pwd):/app -v $(pwd)/.eslintrc.js:/app/.eslintrc.js [镜像名称]:[标签] eslint .

应用部署（pm2）

使用pm2启动Node.js应用（假设应用入口文件为app.js）：

bash
# 进入容器后
cd /app
pm2 start app.js  # 启动应用
pm2 logs  # 查看应用日志
pm2 monit  # 监控应用资源使用情况

生产环境部署示例（docker run）

bash
docker run -d --name node-app -v $(pwd):/app -p 3000:3000 [镜像名称]:[标签] pm2 start app.js --no-daemon

• -d：后台运行容器。
• --name node-app：指定容器名称。
• -p 3000:3000：映射容器端口到主机，便于外部访问。
• --no-daemon：确保pm2在前台运行，避免容器因主进程退出而停止。

环境变量配置

可通过-e参数传递环境变量，如指定Node.js环境：

bash
docker run -it --rm -e NODE_ENV=production [镜像名称]:[标签] node -v

常用环境变量：

• NODE_ENV：Node.js运行环境（如development、production），默认development。
• PM2_HOME：pm2配置文件目录，默认/root/.pm2。

docker-compose配置示例

yaml
version: '3'
services:
  node-app:
    image: [镜像名称]:[标签]
    volumes:
      - ./app:/app
    ports:
      - "3000:3000"
    command: pm2 start /app/app.js --no-daemon
    environment:
      - NODE_ENV=production