fundingsocietiesdocker/node

Node Docker基础镜像文档

概述

Node Docker基础镜像是基于官方Node.js镜像构建的标准化容器镜像，旨在为Node.js应用程序提供一致、可移植的运行环境。该镜像集成了Node.js运行时、npm/yarn包管理器及基础系统依赖，简化Node.js应用的容器化部署流程，支持开发、测试和生产环境的无缝切换。

核心功能与特性

• 官方Node.js版本支持：基于官方Node.js镜像构建，支持多种LTS版本（如14.x、16.x、18.x等），确保运行时稳定性。
• 多架构兼容：支持amd64、arm64等主流架构，适配不同硬件环境。
• 精简镜像体积：采用Alpine或Slim基础镜像（可选），减少镜像大小，提升部署效率。
• 内置包管理器：集成npm和yarn，支持应用依赖安装与管理。
• 环境变量配置：支持通过环境变量灵活配置应用参数（如NODE_ENV、日志级别等）。
• 标准化文件结构：预设工作目录（如/app），便于应用代码挂载与管理。

使用场景与适用范围

• Node.js应用容器化：作为Node.js应用的基础镜像，快速构建应用镜像。
• 开发环境一致性：统一开发团队的本地运行环境，避免"在我电脑上能运行"问题。
• CI/CD流程集成：嵌入自动化构建、测试流程，实现应用持续部署。
• 微服务架构：作为微服务中Node.js服务的基础组件，支持服务编排与扩展。
• 生产环境部署：适用于中小规模Node.js应用的生产环境运行，配合健康检查、日志收集等功能使用。

使用方法与配置说明

基本使用步骤

1. 拉取镜像

从镜像仓库拉取指定版本的Node基础镜像（以18.x为例）：

bash
docker pull node:18-alpine  # Alpine版本（体积更小）
# 或
docker pull node:18-slim    # Slim版本（平衡体积与兼容性）
# 或
docker pull node:18         # 完整版（包含更多系统依赖）

2. 运行基础容器

启动交互式容器验证Node.js环境：

bash
docker run -it --rm node:18-alpine node -v  # 查看Node.js版本
docker run -it --rm node:18-alpine npm -v   # 查看npm版本

3. 构建应用镜像

以Express应用为例，创建Dockerfile：

dockerfile
# 基于Node基础镜像
FROM node:18-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 -it --rm -p 3000:3000 -v $(pwd):/app -w /app node:18-alpine npm run dev

环境变量配置

通过-e参数设置环境变量：

bash
docker run -e NODE_ENV=production -e PORT=4000 -p 4000:4000 my-node-app

Docker Compose配置示例

yaml
version: '3'
services:
  node-app:
    image: node:18-alpine
    working_dir: /app
    volumes:
      - ./:/app
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=development
      - DB_HOST=mysql
    command: npm run dev
  mysql:
    image: mysql:8
    environment:
      - MYSQL_ROOT_PASSWORD=root
      - MYSQL_DATABASE=node_app_db

启动服务：docker-compose up

常用环境变量说明

注意事项

• 生产环境建议使用指定版本标签（如node:18.18.0-alpine），避免版本更新导致兼容性问题。
• 敏感配置通过Docker Secrets或.env文件管理，避免硬编码。
• 自定义系统依赖可通过RUN命令安装（Alpine用apk add，Debian用apt-get）。