triggerz/node-ci

镜像概述

node-ci-docker 是基于 Docker Hub 官方 Node.js 镜像构建的稳定镜像，主要用于为 Node.js 项目提供可靠的运行环境，支持持续集成/持续部署（CI/CD）流程。该镜像可直接从 Docker Hub 获取，同时兼容其他主要版本的 Node.js，满足不同项目对 Node.js 版本的需求。

核心功能与特性

• 稳定版本支持：提供经过验证的稳定 Node.js 版本，确保 CI/CD 流程的可靠性
• 多版本兼容：除默认稳定版本外，支持使用其他主要版本的 Node.js（如 16.x、18.x、20.x 等）
• CI 环境适配：优化适用于 CI/CD 场景，可无缝集成到各类自动化流程（如测试、构建、部署）
• 官方兼容性：基于 Docker Hub 官方 Node.js 镜像构建，确保与 Node.js 生态工具链的兼容性

使用场景

• Node.js 项目的持续集成流程（如自动化测试、代码质量检查、依赖安装）
• Node.js 应用的自动化构建过程（如打包前端资源、编译后端代码）
• CI/CD 管道中的 Node.js 运行环境提供（如 GitLab CI、GitHub Actions、Jenkins 等平台）

使用方法与配置说明

获取镜像

从 Docker Hub 拉取指定版本的镜像（推荐指定具体版本以确保稳定性）：

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

# 拉取特定主版本（如 20.x）
docker pull node:20

# 拉取特定版本（如 20.10.0）
docker pull node:20.10.0

# 拉取轻量级 alpine 版本（适用于资源受限环境）
docker pull node:20-alpine

基本使用示例

1. 运行 Node.js 命令

在容器中执行 Node.js 命令（如查看版本、运行脚本）：

bash
# 查看 Node.js 版本
docker run --rm node:20 node -v  # 输出 v20.x.x

# 运行本地 Node.js 脚本（假设当前目录有 app.js）
docker run --rm -v $(pwd):/app -w /app node:20 node app.js

2. 在 CI 配置中使用（以 GitHub Actions 为例）

在 .github/workflows/ci.yml 中配置 Node.js 环境：

yaml
jobs:
  test:
    runs-on: ubuntu-latest
    container:
      image: node:20
    steps:
      - uses: actions/checkout@v4
      - run: npm install
      - run: npm test

版本选择说明

镜像标签遵循 Docker Hub 官方 Node.js 镜像的命名规范，主要标签类型：

• node:<major>：指定主版本（如 node:20，自动指向该主版本的最新稳定更新）
• node:<major>.<minor>.<patch>：指定具体版本（如 node:20.10.0，精确版本）
• node:<version>-alpine：基于 Alpine Linux 的轻量级版本（如 node:20-alpine）
• node:<version>-slim：精简版，包含基本运行依赖（如 node:20-slim）

详细版本标签可参考 https://hub.docker.com/_/node%E3%80%82

配置参考

该镜像基于官方 Node.js 镜像构建，详细配置（如环境变量、工作目录设置、用户权限等）可参考 https://hub.docker.com/_/node%E3%80%82