ubercadence/web Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

Cadence Web UI 镜像文档

概述

Cadence Web UI是Cadence工作流引擎的官方Web可视化组件，提供直观的图形化操作界面，用于监控、管理和调试工作流生命周期。该镜像需与Cadence服务器（ubercadence/server）配合使用，通过与后端服务通信，展示工作流数据、任务状态及系统指标，简化工作流管理复杂度。

核心功能

• 工作流实例管理：查看所有工作流实例列表，支持按状态（运行中、已完成、失败等）筛选，提供终止、重启、取消等操作
• 任务监控：实时展示活动任务、决策任务的状态分布（待处理/进行中/已完成/失败），支持查看任务详情及堆栈跟踪
• 历史记录可视化：以时间线形式展示工作流完整执行历史，包括事件顺序、任务调度、状态转换等关键节点，支持数据导出
• 系统指标仪表盘：集成Prometheus指标展示，包括工作流吞吐量、任务处理延迟、失败率等核心指标，支持自定义时间范围查询
• 命名空间管理：查看和管理Cadence命名空间，支持创建/删除命名空间（需后端权限）及配置命名空间参数
• 高级搜索功能：支持按工作流ID、业务ID、启动时间、状态等多维度组合搜索，提供复杂条件过滤

使用场景

• 开发调试：开发人员在本地/测试环境实时查看工作流执行过程，快速定位代码逻辑问题
• 生产监控：运维人员监控生产环境工作流运行状态，及时发现异常（如任务堆积、失败率上升）并干预
• 故障排查：工作流执行异常时，通过历史记录可视化和任务详情追溯故障原因（超时/依赖服务不可用等）
• 团队协作：团队成员共享访问权限，共同查看工作流状态，协作分析业务流程瓶颈

使用方法

前提条件

• 已部署Cadence服务器（ubercadence/server），且网络可被Web UI容器访问
• 确保Cadence服务器配置允许跨域请求（如需，可在服务器端设置cadence.service.allowCrossOrigin参数）

快速启动（Docker Run）

通过以下命令启动容器，连接到现有Cadence服务器：

bash
docker run -d \
  --name cadence-web \
  -p 8088:8088 \
  -e CADENCE_SERVICE_HOST=cadence-server-host \  # Cadence服务器主机名/IP（必填）
  -e CADENCE_SERVICE_PORT=7933 \                # Cadence服务器端口（默认7933）
  -e CADENCE_WEB_PORT=8088 \                    # Web UI监听端口（默认8088）
  ubercadence/web:latest

启动后访问 http://localhost:8088 即可打开Web UI界面

Docker Compose部署

推荐使用Docker Compose统一部署Cadence服务器和Web UI，确保网络互通：

yaml
version: '3.8'

services:
  cadence-server:
    image: ubercadence/server:latest
    ports:
      - "7933:7933"  # Cadence服务端口
      - "7934:7934"  # 管理端口
      - "7935:7935"  # metrics端口
    environment:
      - DB=sqlite
      - SQLITE_FILE=./cadence.db
    volumes:
      - ./cadence-data:/cadence/db

  cadence-web:
    image: ubercadence/web:latest
    ports:
      - "8088:8088"
    environment:
      - CADENCE_SERVICE_HOST=cadence-server  # 服务名直接解析（Docker网络内）
      - CADENCE_SERVICE_PORT=7933
    depends_on:
      - cadence-server

启动服务：

bash
docker-compose up -d

配置说明

核心环境变量

生产环境安全配置

1. 基本身份验证
   启用访问控制，限制Web UI访问：

   bash
   docker run -d \
     --name cadence-web \
     -p 8088:8088 \
     -e CADENCE_SERVICE_HOST=cadence-server \
     -e CADENCE_SERVICE_PORT=7933 \
     -e AUTH_ENABLED=true \
     -e AUTH_USERNAME=admin \
     -e AUTH_PASSWORD=your-secure-password \
     ubercadence/web:latest
   

2. TLS加密
   若后端启用TLS，需配置证书：

   bash
   docker run -d \
     --name cadence-web \
     -p 8088:8088 \
     -e CADENCE_SERVICE_HOST=cadence-server \
     -e CADENCE_SERVICE_PORT=7933 \
     -e TLS_ENABLED=true \
     -e TLS_CA_CERT_PATH=/certs/ca.crt \
     -v ./local-certs:/certs \
     ubercadence/web:latest
   

3. 网络隔离
   通过Docker网络或防火墙限制Web UI端口仅允许特定IP访问，避免公网直接暴露

常见问题

• 无法连接后端：检查CADENCE_SERVICE_HOST和CADENCE_SERVICE_PORT配置，确保容器网络互通（Docker Compose可通过服务名直接解析）
• 数据加载失败：检查Cadence服务器日志，确认跨域请求是否被拒绝（需在服务器配置cadence.service.allowCrossOrigin: true）
• 指标无数据：确保Cadence服务器启用Prometheus指标导出，通过PROMETHEUS_URL环境变量配置指标源地址