verdigristech/ci-node

CI环境镜像（Node.js + Docker CLI + Heroku CLI）

镜像概述

本镜像为持续集成（CI）场景提供一站式环境，集成Node.js运行时、Docker命令行工具（CLI）及Heroku命令行工具（CLI），旨在简化从代码构建、容器化到云平台部署的全流程CI操作。

核心功能与特性

• 多工具集成：内置Node.js（最新稳定版）、Docker CLI和Heroku CLI，无需额外安装即可满足CI流程需求
• 环境一致性：统一的运行环境确保CI过程中依赖版本一致，避免"本地正常，CI失败"的环境差异问题
• 轻量级设计：基于精简基础镜像构建，平衡功能完整性与资源占用
• 即开即用：无需复杂配置，拉取镜像后可直接用于CI流程

使用场景与适用范围

• 需要Node.js环境的前端/后端项目CI流程（如代码 lint、单元测试、构建打包）
• 基于Docker容器化部署的应用（需在CI中执行docker build、docker push等操作）
• 使用Heroku平台进行应用部署的项目（需通过Heroku CLI执行部署命令）
• 适用于GitHub Actions、Jenkins、GitLab CI等主流CI/CD平台

使用方法与配置说明

基本使用（Docker Run）

bash
# 拉取镜像
docker pull [镜像名称]

# 启动容器并挂载项目目录
docker run -it --rm \
  -v $(pwd):/app \
  -w /app \
  [镜像名称] \
  sh -c "npm install && npm run test && docker build -t my-app . && heroku login -i && heroku push"

CI平台集成示例（GitHub Actions）

在.github/workflows/ci.yml中配置：

yaml
jobs:
  build-and-deploy:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 使用CI环境镜像
        uses: docker://[镜像名称]
        with:
          entrypoint: sh
          args: |
            npm install
            npm run build
            docker build -t my-app:${{ github.sha }} .
            heroku container:login
            heroku container:push web -a my-app
            heroku container:release web -a my-app

环境变量配置

常用命令示例

• 执行Node.js相关操作：npm install、npm run build、node script.js
• Docker操作：docker build -t <镜像名> .、docker push <镜像名>
• Heroku操作：heroku login -i（交互式登录）、heroku create（创建应用）、heroku deploy（部署应用）

注意事项

• 使用Docker CLI时，需确保容器具有足够权限（可通过--privileged参数或挂载Docker socket实现：-v /var/run/docker.sock:/var/run/docker.sock）
• Heroku CLI非交互式登录需配置HEROKU_API_KEY环境变量，避免手动输入凭据
• Node.js版本可通过镜像标签指定（如:node18表示Node.js 18版本），具体标签请参考镜像仓库说明