hcltechaiforce/aiforce-tcwa

AI Force Tools and Connectors Web App (TCWA) 镜像文档

镜像概述

该Docker镜像为AI Force平台提供微前端服务，核心功能是交付Tools and Connectors Web App (TCWA)。作为平台的前端模块，它负责工具与连接器功能的展示及交互，支持与AI Force生态系统的集成。

核心功能与特性

• 端口暴露：默认暴露3000端口，提供Web应用访问入口
• 健康检查：实现/check_health端点，支持编排器监控服务状态
• 故障恢复：支持on-failure重启策略，提升服务稳定性
• 日志管理：通过json-file驱动实现日志轮转，优化日志存储

使用场景

适用于AI Force平台环境中需要集成工具和连接器功能的场景，可作为独立微前端模块部署，也可嵌入到更大的平台架构中，满足健康检查和自动恢复需求。

使用方法与配置说明

基本部署命令

bash
docker run -d \
  -p 3000:3000 \
  --restart on-failure \
  --log-driver json-file \
  --name tcwa-service \
  [镜像名称]:[标签]

参数说明

• 端口映射：-p 3000:3000 将容器3000端口映射至主机，确保外部可访问
• 重启策略：--restart on-failure 配置容器在运行失败时自动重启
• 日志驱动：--log-driver json-file 启用json-file日志驱动，支持日志轮转（具体轮转参数需通过Docker daemon配置）
• 容器命名：--name tcwa-service 指定容器名称，便于管理

健康检查验证

服务启动后，可通过以下命令验证健康状态：

bash
curl http://localhost:3000/check_health

返回成功响应表示服务正常运行。

docker-compose配置示例

yaml
version: '3'
services:
  tcwa:
    image: [镜像名称]:[标签]
    ports:
      - "3000:3000"
    restart: on-failure
    logging:
      driver: "json-file"
      options:
        max-size: "10m"  # 日志文件最大大小
        max-file: "3"    # 保留日志文件数量