touchbistro/alpine-node

镜像概述

本镜像为基于alpine-node的基础镜像，旨在提供轻量级、高效的Node.js运行环境，主要用于本地开发环境搭建、CircleCI等持续集成流程以及构建生产环境部署镜像。基于Alpine Linux的特性，镜像体积小且资源占用低，同时包含完整的Node.js运行时及包管理工具，满足多场景下的Node.js应用开发与构建需求。

核心功能与特性

• 轻量级基础：基于Alpine Linux构建，相比传统Linux基础镜像体积更小，资源消耗更低
• 完整Node.js环境：包含Node.js运行时及npm/yarn包管理器，支持Node.js应用的开发、测试与运行
• 多场景适配：兼容本地开发、CI/CD流程（如CircleCI）及生产部署镜像构建，提供一致的运行环境
• 环境一致性：作为基础镜像使用时，可确保开发、测试与生产环境的Node.js版本及依赖一致性

使用场景

1. 本地开发环境

快速搭建隔离的Node.js开发环境，避免本地环境配置冲突：

• 运行Node.js应用进行本地调试
• 执行npm/yarn命令安装依赖、运行脚本
• 配合本地IDE进行开发与测试

2. CI/CD流程集成

作为CircleCI等持续集成平台的运行环境，执行自动化构建与测试：

• 在CI流程中运行单元测试、集成测试
• 执行代码 linting、构建静态资源
• 生成部署所需的应用包或镜像

3. 部署镜像构建

作为基础镜像，构建用于生产环境的部署镜像：

• 减少最终部署镜像的体积
• 确保生产环境与开发/测试环境的Node.js版本一致
• 简化部署镜像的Dockerfile编写

使用方法

本地开发使用

基本运行

启动交互式容器，运行Node.js命令：

bash
docker run -it --rm [镜像名称] node --version

挂载本地项目目录

将本地项目目录挂载到容器中，进行开发调试：

bash
docker run -it --rm -v $(pwd):/app -w /app [镜像名称] npm install
docker run -it --rm -v $(pwd):/app -w /app [镜像名称] npm run dev

CI流程集成（以CircleCI为例）

在.circleci/config.yml中配置使用本镜像：

yaml
version: 2.1
jobs:
  build-and-test:
    docker:
      - image: [镜像名称]  # 替换为实际镜像名称
    steps:
      - checkout  # 拉取代码
      - run: npm install  # 安装依赖
      - run: npm run lint  # 代码检查
      - run: npm test     # 执行测试
      - run: npm run build # 构建应用

作为基础镜像构建部署镜像

在应用的Dockerfile中引用本镜像作为基础：

dockerfile
# 基于本镜像构建部署镜像
FROM [镜像名称] AS builder

# 设置工作目录
WORKDIR /app

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

# 复制源代码并构建
COPY . .
RUN npm run build

# 构建生产镜像（如需）
FROM [镜像名称]
WORKDIR /app
COPY --from=builder /app/dist ./dist
COPY --from=builder /app/node_modules ./node_modules
CMD ["node", "dist/index.js"]

环境变量与配置

本镜像继承alpine-node的基础配置，默认包含以下核心组件：

• Node.js运行时（版本取决于具体镜像标签）
• npm包管理器
• 基础Alpine Linux工具链（如bash、curl等）

可通过以下命令查看环境信息：

bash
# 查看Node.js版本
docker run --rm [镜像名称] node -v

# 查看npm版本
docker run --rm [镜像名称] npm -v

注：[镜像名称]需替换为实际使用的镜像完整名称（含仓库地址及标签，如username/alpine-node-base:latest）。