blockmason/nodejs

Node.js基础镜像文档

镜像概述

本镜像为Node.js应用提供基础运行环境，包含JavaScript开发和运行所需的核心工具：node（Node.js运行时）、npm（Node.js包管理器）和yarn（另一个流行的包管理器）。适用于作为各类Node.js应用的基础镜像，简化应用构建和部署流程。

核心功能和特性

• 包含核心工具：预装node、npm和yarn，满足JavaScript应用开发、依赖管理和运行需求
• 基础环境：提供稳定的Node.js运行时环境，支持基于JavaScript的应用开发和部署
• 轻量设计：作为基础镜像，保持精简结构，便于叠加应用代码和依赖

使用场景和适用范围

• Node.js应用开发：作为本地开发环境基础，提供统一的开发工具链
• 应用构建流程：在CI/CD pipeline中用于依赖安装、代码构建等步骤
• 生产环境部署：作为Node.js应用的运行基础，支持直接运行编译后的应用代码
• 多阶段构建：可在构建阶段使用本镜像安装依赖、编译代码，再将产物复制到更精简的运行时镜像

使用方法和配置说明

基本使用（交互式shell）

通过以下命令启动容器并进入交互式shell，验证环境：

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

进入容器后，可通过以下命令检查工具版本：

bash
node -v   # 查看Node.js版本
npm -v    # 查看npm版本
yarn -v   # 查看yarn版本

作为基础镜像构建应用

在Dockerfile中使用本镜像作为基础，构建自定义Node.js应用：

dockerfile
# 基于本镜像构建
FROM [镜像名称]

# 设置工作目录
WORKDIR /app

# 复制package.json和package-lock.json（或yarn.lock）
COPY package*.json ./

# 使用npm或yarn安装依赖
RUN npm install
# 或使用yarn: RUN yarn install

# 复制应用代码
COPY . .

# 暴露应用端口（根据实际应用调整）
EXPOSE 3000

# 启动应用
CMD ["node", "app.js"]

多阶段构建示例

结合本镜像进行多阶段构建，减小最终镜像体积：

dockerfile
# 构建阶段：使用本镜像安装依赖并构建应用
FROM [镜像名称] as builder
WORKDIR /app
COPY package*.json ./
RUN npm install
COPY . .
RUN npm run build  # 假设应用需要构建步骤（如React、Vue等前端应用）

# 运行阶段：使用更精简的Node.js运行时镜像
FROM node:slim
WORKDIR /app
# 从构建阶段复制构建产物
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/package*.json ./
RUN npm install --production  # 仅安装生产依赖
EXPOSE 3000
CMD ["node", "dist/app.js"]

环境变量配置

本镜像未预设特定环境变量，可根据应用需求在运行时或Dockerfile中添加，例如：

bash
# 运行时指定Node.js环境
docker run -e NODE_ENV=production [镜像名称]