hexinc/node

镜像概述

该镜像是一个基于Node.js的Docker镜像，专为持续集成(CI)环境设计。作为hex项目及其他Node.js应用CI流程的基础环境，提供稳定的运行时支持，确保自动化构建、测试等环节的高效执行。

核心功能与特性

• Node.js运行环境：内置Node.js运行时，满足JavaScript/TypeScript项目的执行需求
• 依赖管理工具：预装npm、yarn等包管理工具，支持项目依赖自动化安装
• CI流程优化：适配自动化流程，可与GitHub Actions、GitLab CI等主流CI/CD工具无缝集成
• 环境一致性：标准化Node.js环境，避免因环境差异导致的构建或测试问题

使用场景与适用范围

• hex项目CI流程：支持monorepo中前端（packages/client）、后端（packages/server）等模块的自动化测试与构建
• Node.js应用CI：适用于基于Node.js的前后端项目，如代码linting、单元测试、应用打包等自动化环节
• 跨项目复用：可作为通用Node.js CI镜像，用于其他需要标准化Node环境的持续集成场景

使用方法与配置说明

基础使用示例

在CI配置文件中引用

以GitHub Actions为例，在工作流配置中指定该镜像：

yaml
jobs:
  build-and-test:
    runs-on: ubuntu-latest
    container:
      image: [镜像名称]  # 替换为实际镜像地址
    steps:
      - name: Checkout code
        uses: actions/checkout@v4
      - name: Install dependencies
        run: npm install  # 或 yarn install
      - name: Run tests
        run: npm test

本地验证

通过docker run命令验证镜像环境：

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

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

关联项目仓库

• 核心代码仓库（monorepo）：https://github.com/hex-inc/hex
  包含项目主要代码，如前端（packages/client）、后端服务（packages/server）、执行管理服务（packages/sidecar）等模块，该镜像主要服务于此仓库的CI流程。

• 其他相关仓库：

  • Terraform配置（全局资源管理）：https://github.com/hex-inc/terraform
  • 部署配置（多环境部署）：https://github.com/hex-inc/terraform-hex-deployments
  • 官网代码：https://github.com/hex-inc/public-website