teamtrussle/docker-builder

Node构建器镜像

镜像概述

Node构建器镜像是专为多阶段构建和构建器模式设计的Node.js专用镜像。其核心目标是分离应用的构建环境与运行环境，在构建阶段完成依赖安装、代码编译、打包等操作，最终仅将必要的运行时文件复制到生产镜像，从而提高构建效率并显著减小最终镜像体积。

核心功能与特性

• 多阶段构建支持：作为构建阶段基础镜像，与生产阶段的轻量级镜像（如node:alpine）配合使用，实现构建环境与运行环境的分离
• 完整构建工具链：预装Node.js运行时、npm/yarn包管理工具及常用构建依赖，满足各类Node.js项目（如React、Vue、Express等）的构建需求
• 环境一致性保障：提供标准化的构建环境，避免因开发环境差异导致的"在我机器上能运行"问题
• 镜像体积优化：通过多阶段构建机制，仅将编译后的产物和运行依赖复制到生产镜像，大幅降低最终镜像大小

使用场景与适用范围

• Node.js应用容器化：适用于需要编译、打包的Node.js应用（如前端React/Vue项目、后端TypeScript项目）
• CI/CD流水线集成：在持续集成流程中作为构建阶段环境，确保跨平台构建一致性
• 开发与生产环境隔离：构建环境可包含开发依赖（如测试工具、编译器），生产环境仅保留运行依赖
• 镜像体积敏感场景：对容器镜像大小有严格要求的生产环境或资源受限场景

使用方法与配置说明

多阶段构建基础示例

以下Dockerfile展示了使用该镜像进行多阶段构建的典型流程：

dockerfile
# 构建阶段：使用Node构建器镜像
FROM node-builder-image AS builder
WORKDIR /app

# 复制依赖文件并安装（利用Docker层缓存优化）
COPY package.json package-lock.json ./
RUN npm ci  # 安装精确版本依赖，适合CI环境

# 复制源代码并执行构建
COPY . .
RUN npm run build  # 执行项目构建命令（根据项目调整，如tsc、webpack等）

# 生产阶段：使用轻量级Node镜像
FROM node:alpine
WORKDIR /app

# 仅复制生产必要文件
COPY --from=builder /app/dist ./dist  # 复制构建产物
COPY --from=builder /app/package.json ./
COPY --from=builder /app/package-lock.json ./

# 安装生产依赖
RUN npm ci --only=production

# 暴露端口并启动应用
EXPOSE 3000
CMD ["node", "dist/server.js"]

自定义构建配置

使用Yarn作为包管理器

dockerfile
FROM node-builder-image AS builder
WORKDIR /app
COPY package.json yarn.lock ./
RUN yarn install --frozen-lockfile  # 锁定依赖版本
COPY . .
RUN yarn build  # 使用Yarn执行构建命令

配置自定义NPM镜像源

dockerfile
FROM node-builder-image AS builder
ENV NPM_REGISTRY=https://registry.npm.taobao.org  # 设置国内镜像源加速安装
WORKDIR /app
COPY package*.json ./
RUN npm config set registry $NPM_REGISTRY && npm install
COPY . .
RUN npm run build

环境变量说明

构建器镜像支持通过环境变量调整构建行为：

docker-compose集成示例

在docker-compose.yml中使用多阶段构建：

yaml
version: '3.8'
services:
  app:
    build:
      context: .
      dockerfile: Dockerfile  # 引用包含多阶段构建的Dockerfile
    ports:
      - "3000:3000"
    environment:
      - NODE_ENV=production
    restart: unless-stopped