timbru31/node-alpine-git

Node.js with Git Docker镜像

https://github.com/timbru31/docker-node-alpine-git/workflows/buildx/badge.svg](https://github.com/timbru31/docker-node-alpine-git/actions?query=workflow%3Abuildx) https://github.com/timbru31/docker-node-alpine-git/workflows/Lint%20Dockerfiles/badge.svg](https://github.com/timbru31/docker-node-alpine-git/actions?query=workflow%3A%22Lint+Dockerfiles%22)

镜像概述和主要用途

一个基于Node.js 20 LTS（Iron）、Node.js 22 LTS（Jod）或Node.js 24（Krypton）alpine版本的轻量级Docker镜像，已预安装Git和ssh。该镜像旨在提供最小化的运行环境，同时集成Node.js开发所需的核心工具和版本控制功能，适用于需要Node.js运行环境且需版本控制能力的开发、构建及CI/CD场景。

核心功能和特性

包含组件

• Node.js 20 LTS（Iron）、Node.js 22 LTS（Jod）或Node.js 24（Krypton）
• npm 10
• yarn
• Git
• ssh

支持的平台

该镜像利用buildx功能构建，支持以下平台：

• linux/amd64
• linux/arm64
• linux/arm/v7（不适用于Node.js 24（Krypton）及更新版本）
• linux/arm/v6（不适用于Node.js 24（Krypton）及更新版本）
• linux/ppc64le（不适用于Node.js 22 LTS（Jod）及更新版本）
• linux/s390x

使用场景和适用范围

• 开发环境一致性：确保团队使用统一的Node.js和Git版本，避免环境差异导致的问题
• CI/CD流水线：用于构建依赖Git仓库的Node.js应用，支持多平台部署
• 轻量级构建：基于Alpine Linux，镜像体积小，适合资源受限的环境
• 版本控制集成：直接在容器内执行Git操作（如克隆仓库、拉取代码），简化构建流程

使用方法和配置说明

基本使用

拉取镜像

根据需要的Node.js版本拉取对应标签的镜像（标签通常为Node.js主版本号，如20、22、24）：

bash
# 拉取Node.js 20 LTS版本
docker pull timbru31/node-alpine-git:20

# 拉取Node.js 22 LTS版本
docker pull timbru31/node-alpine-git:22

# 拉取Node.js 24版本
docker pull timbru31/node-alpine-git:24

运行容器

启动交互式终端验证环境：

bash
docker run -it --rm timbru31/node-alpine-git:22 sh

在容器内验证组件版本：

bash
# 验证Node.js版本
node -v  # 输出示例：v22.9.0

# 验证npm版本
npm -v   # 输出示例：10.8.2

# 验证Git版本
git -v   # 输出示例：git version 2.40.1

Docker Compose配置示例

创建docker-compose.yml文件，集成到项目中：

yaml
version: '3.8'
services:
  node-build:
    image: timbru31/node-alpine-git:20
    volumes:
      - ./:/app  # 挂载当前目录到容器内/app
    working_dir: /app
    command: >
      sh -c "git clone https://github.com/your-repo/your-node-app.git &&
             cd your-node-app &&
             npm install &&
             npm run build"
    environment:
      - NODE_ENV=production  # 设置Node.js环境变量

启动服务执行构建：

bash
docker-compose up

注意事项

• 不同Node.js版本对平台的支持存在差异，具体请参考“支持的平台”部分
• Alpine Linux使用musl libc，部分依赖glibc的Node.js模块可能需要额外配置（如安装libc6-compat）
• 如需持久化数据或配置ssh密钥，可通过-v参数挂载宿主机目录到容器内（如-v ~/.ssh:/root/.ssh）

由(c) Tim Brust及贡献者构建，基于MIT许可证发布。