cityofsurrey/node Docker 镜像 - 轩辕镜像

docker-node 镜像文档

镜像概述

docker-node是一个为NodeJS应用程序设计的Docker镜像，提供了开箱即用的容器环境。该镜像集成了NodeJS运行时及必要工具，旨在简化NodeJS应用的部署流程，帮助开发者快速搭建一致的运行环境。

核心功能与特性

• 完整运行环境：内置NodeJS运行时，支持直接执行NodeJS应用代码
• 包管理工具：集成npm/yarn包管理器，可直接安装项目依赖
• 轻量级设计：基于Alpine或Debian等基础镜像构建，平衡体积与兼容性
• 版本灵活性：提供多种NodeJS版本标签（如LTS版、特定版本），适配不同应用需求
• 即开即用：无需额外配置即可启动基础NodeJS应用，降低部署门槛

使用场景与适用范围

• 快速部署：适用于需要快速将NodeJS应用部署到容器环境的场景
• 开发环境：为本地开发提供一致的NodeJS运行环境，避免"环境不一致"问题
• CI/CD集成：可作为CI/CD流程中的基础镜像，用于自动化测试和构建
• 微服务架构：适合作为NodeJS微服务的基础容器，支持水平扩展

使用方法与配置说明

基本使用示例

1. 拉取镜像

通过docker pull命令获取指定版本的镜像：

bash
# 拉取最新版
docker pull node:latest

# 拉取特定版本（如NodeJS 20 Alpine版）
docker pull node:20-alpine

2. 运行基础应用

挂载本地代码并执行NodeJS脚本：

bash
# 运行当前目录下的app.js
docker run -it --rm -v $(pwd):/app -w /app node:latest node app.js

参数说明：

• -it: 启用交互式终端
• --rm: 容器退出后自动清理
• -v $(pwd):/app: 将本地当前目录挂载到容器内/app目录
• -w /app: 设置工作目录为/app
• node app.js: 执行的NodeJS命令

3. 构建自定义应用镜像

在项目根目录创建Dockerfile：

dockerfile
# 基于指定版本的Node镜像
FROM node:20-alpine

# 设置工作目录
WORKDIR /app

# 复制依赖文件并安装
COPY package*.json ./
RUN npm install --production

# 复制应用代码
COPY . .

# 暴露应用端口
EXPOSE 3000

# 启动命令
CMD ["node", "server.js"]

构建并运行自定义镜像：

bash
# 构建镜像
docker build -t my-node-app .

# 运行容器并映射端口
docker run -p 3000:3000 my-node-app

环境变量配置

示例：设置生产环境并指定端口

bash
docker run -e NODE_ENV=production -e PORT=4000 -p 4000:4000 node:latest node server.js

版本选择建议

注意事项

• 生产环境建议使用具体版本标签（如node:20.10.0-alpine）而非latest，避免因版本更新导致环境变化
• 本地开发时，通过挂载目录实现代码热更新，无需反复构建镜像
• 生产环境部署时，建议使用.dockerignore文件排除无关文件（如node_modules、.git），减小镜像体积
• 高并发场景下，可结合--init参数启用init进程，处理僵尸进程回收