hcltechaiforce/aiforce-aewa

aiforce-aewa 镜像文档

镜像概述

aiforce-aewa是AI Force平台的微前端服务，用于提供Agent Execution Web App（AEWA）。该服务设计用于容器化环境，支持健康探测与日志管理，作为AI Force平台的核心组件之一，实现代理执行流程的可视化、控制与监控。

核心功能与特性

基础信息

• 镜像名称：aiforce-aewa:
• 暴露端口：3000
• 健康检查端点：GET /check_health（用于编排器健康探测）
• 重启策略：on-failure（失败时自动重启，增强服务弹性）
• 日志配置：采用json-file驱动，支持日志轮转（单个文件大小10MB，保留3个文件）
• 网络要求：需加入aiforce-net网络
• 标签：
  • service: "MFE - Agent Execution Service"
  • version: "<aiforce-aewa-tag>"（与镜像标签一致）

使用场景

• 作为AI Force平台的关键组件，部署于容器化环境
• 提供代理执行流程的可视化界面
• 支持对代理执行过程的实时控制与状态监控
• 适用于需要健康探测与日志治理的生产环境

使用方法与配置说明

前提要求

• 应用必须在 /check_health 路径提供健康检查路由
• 容器需在aiforce-net网络内，确保上游服务或代理可通过3000端口访问

Docker Run 部署示例

bash
docker run -d \
  --name aiforce-aewa \
  --restart on-failure \
  --network aiforce-net \
  -p 3000:3000 \
  --log-driver json-file \
  --log-opt max-size=10m \
  --log-opt max-file=3 \
  --label service="MFE - Agent Execution Service" \
  --label version="<aiforce-aewa-tag>" \
  aiforce-aewa:<aiforce-aewa-tag>

Docker Compose 配置示例

yaml
version: '3.8'
services:
  aiforce-aewa:
    image: docker.xuanyuan.run/aiforce-aewa:<aiforce-aewa-tag>
    container_name: aiforce-aewa
    restart: on-failure
    networks:
      - aiforce-net
    ports:
      - "3000:3000"
    logging:
      driver: "json-file"
      options:
        max-size: "10m"
        max-file: "3"
    labels:
      - "service=MFE - Agent Execution Service"
      - "version=<aiforce-aewa-tag>"

networks:
  aiforce-net:
    external: true

健康检查验证

部署后可通过以下命令验证健康检查端点：

bash
curl http://<容器IP或主机IP>:3000/check_health

预期返回健康状态响应（具体响应格式取决于应用实现）。