hexinc/e2e-image Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Hex项目Docker镜像文档

镜像概述

Hex项目Docker镜像是其容器化部署解决方案，整合了Web前端（packages/client）、应用服务器（packages/server）及侧车服务（packages/sidecar）等核心组件。该镜像旨在简化Hex应用的部署流程，支持开发、测试及生产多环境配置，为用户提供一体化的应用部署体验。

核心功能与特性

• 组件整合：集成Web客户端（前端界面）、主应用服务器（核心后端逻辑）及侧车服务（项目执行管理），实现前后端及辅助服务的协同部署。
• 多环境支持：适配开发、测试、生产等不同场景，可通过配置文件或环境变量灵活调整部署参数。
• 开发便捷性：提供开发环境快速搭建方案，支持前端独立开发或全项目开发配置，降低环境配置复杂度。
• 执行管理：通过侧车服务（sidecar）组件管理项目执行生命周期，确保后端逻辑稳定运行。

使用场景

• 开发团队环境搭建：供开发人员快速部署完整的Hex开发环境，包含前后端依赖及服务组件，加速开发流程。
• 企业生产部署：支持企业级生产环境部署，适配多租户架构及规模化部署需求，可结合Terraform配置实现自动化部署。
• 测试与演示：在测试或演示环境中快速启动Hex应用实例，用于功能验证、性能测试或产品展示。

使用方法与配置说明

前提条件

• 安装Docker Engine（20.10+版本）及Docker Compose（v2+版本）。
• 访问Hex项目Monorepo仓库（[***]

镜像构建

1. 克隆Monorepo仓库：

   bash
   git clone [***]
   cd hex
   

2. 构建Docker镜像（具体构建细节可参考项目文档docs/DOCKER_IMAGES.md）：

   bash
   # 构建Web客户端镜像
   docker build -t hex/client -f packages/client/Dockerfile .
   
   # 构建应用服务器镜像
   docker build -t hex/server -f packages/server/Dockerfile .
   
   # 构建侧车服务镜像
   docker build -t hex/sidecar -f packages/sidecar/Dockerfile .
   

配置参数说明

Docker镜像的详细配置参数及环境变量说明可参考项目文档docs/DOCKER_IMAGES.md，核心配置项包括：

• 服务端口映射：前端默认端口（80/443）、应用服务器端口（3000）、侧车服务端口（4000）。
• 环境变量：如NODE_ENV（环境标识，如development/production）、SIDECAR_URL（侧车服务地址）、REACT_APP_API_URL（前端API请求地址）等。
• 数据持久化：支持挂载卷（Volume）存储应用数据、日志文件等。

Docker部署示例

使用Docker Compose部署

创建docker-compose.yml文件，整合前端、服务器及侧车服务：

yaml
version: '3.8'
services:
  client:
    image: hex/client
    ports:
      - "80:80"  # 前端Web服务端口
    depends_on:
      - server  # 依赖服务器服务
    environment:
      - REACT_APP_API_URL=[***]  # 前端API请求地址

  server:
    image: hex/server
    ports:
      - "3000:3000"  # 应用服务器端口
    depends_on:
      - sidecar  # 依赖侧车服务
    environment:
      - NODE_ENV=production  # 环境标识
      - SIDECAR_URL=[***]  # 侧车服务地址

  sidecar:
    image: hex/sidecar
    ports:
      - "4000:4000"  # 侧车服务端口
    environment:
      - EXECUTION_MODE=production  # 执行模式

启动服务：

bash
docker-compose up -d

独立运行服务器组件

bash
docker run -d \
  --name hex-server \
  -p 3000:3000 \
  -e NODE_ENV=development \
  -e SIDECAR_URL=http://localhost:4000 \
  hex/server

注意事项

• 生产环境部署建议参考terraform-hex-deployments仓库（[***]
• Docker镜像构建及部署的详细注意事项请查阅项目文档docs/DOCKER_IMAGES.md。
• 相关源码及配置文件可通过Hex项目Monorepo仓库获取（[***]