arkanmx/node

Node.js开发环境镜像

镜像概述

本Docker镜像基于Node.js官方镜像构建，包含多个Node.js版本，并预装了git、curl、rsync、jq、wget及build-essential等常用开发和构建工具。旨在为Node.js应用开发、构建和部署提供一站式环境，减少开发人员配置基础工具的时间成本。

核心功能与特性

• 多Node.js版本支持：提供多个Node.js版本选择，满足不同项目的运行环境需求
• 丰富工具集：预装以下常用工具：
  • git：版本控制工具
  • curl：HTTP请求工具
  • rsync：文件同步工具
  • jq：JSON处理工具
  • wget：文件下载工具
  • build-essential：基础编译工具集（含gcc、g++、make等）
• 即开即用：无需额外安装依赖，拉取镜像后即可投入开发和构建工作

使用场景与适用范围

• Node.js应用的本地开发环境搭建
• CI/CD流程中的构建环境配置
• 轻量级Node.js应用部署
• 需要编译原生模块的Node.js项目（依赖build-essential）
• 需要处理JSON数据、文件同步或版本控制的Node.js开发任务

使用方法与配置说明

基本使用

拉取镜像

根据所需Node.js版本拉取对应标签的镜像（具体版本标签请参考镜像仓库说明）：

bash
docker pull [镜像仓库地址]:[node版本标签]

运行容器

以交互式方式运行容器，映射当前目录到容器内的工作目录：

bash
docker run -it --rm -v $(pwd):/app -w /app [镜像仓库地址]:[node版本标签] /bin/bash

上述命令将：

• 启动一个交互式容器
• 挂载当前目录到容器内的/app目录
• 设置工作目录为/app
• 启动bash终端

验证工具

进入容器后，可通过以下命令验证预装工具是否正常工作：

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

# 验证npm版本
npm -v

# 验证git
git --version

# 验证curl
curl --version

# 验证rsync
rsync --version

# 验证jq
jq --version

# 验证wget
wget --version

# 验证gcc（build-essential组件）
gcc --version

典型应用示例

使用镜像构建Node.js项目

bash
# 拉取镜像（假设使用Node.js 18版本）
docker pull [镜像仓库地址]:18

# 运行容器并执行构建命令
docker run --rm -v $(pwd):/app -w /app [镜像仓库地址]:18 npm install && npm run build

在CI/CD流程中使用

在GitHub Actions等CI/CD工具中配置：

yaml
jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: Use Node.js environment image
        uses: docker://[镜像仓库地址]:18
        with:
          args: npm install && npm run test && npm run build

注意事项

• 请根据项目需求选择合适的Node.js版本标签
• 容器运行时如需持久化数据，建议通过-v参数挂载本地目录
• 生产环境部署时，建议基于本镜像构建应用专用镜像，减少不必要的工具依赖