portworx/temporalio-admin-tools

Temporal Admin Tools Image for PDS SM 镜像文档

镜像概述

本镜像为PDS SM环境提供Temporal管理工具，集成Temporal官方管理工具集，用于Temporal集群的日常管理与运维操作。通过该镜像可便捷执行集群监控、工作流控制、命名空间配置等管理任务，简化PDS SM环境下Temporal集群的运维流程。

核心功能与特性

• 集群状态监控：实时查看Temporal集群健康状态、服务节点信息及资源使用情况
• 工作流管理：支持工作流实例查询、终止、重试及历史数据查看
• 命名空间配置：提供命名空间创建、修改、删除及权限管理功能
• 数据运维：支持集群数据备份、恢复及数据清理操作
• 配置管理：管理Temporal集群的动态配置参数，如超时设置、并发控制等

适用场景

• PDS SM环境下Temporal集群的日常管理与监控
• Temporal工作流异常排查与问题定位
• 集群配置调整与优化
• 定期数据备份与灾难恢复演练
• 多命名空间环境的权限与资源分配管理

使用方法

基本使用

通过docker run命令启动镜像，需指定Temporal集群连接信息：

bash
docker run --rm -e TEMPORAL_HOST=your-temporal-service -e TEMPORAL_PORT=7233 pds-sm-temporal-admin-tools:latest

常用命令示例

• 查看集群状态：

  bash
  docker run --rm -e TEMPORAL_HOST=your-temporal-service pds-sm-temporal-admin-tools:latest cluster health
  

• 列出所有命名空间：

  bash
  docker run --rm -e TEMPORAL_HOST=your-temporal-service pds-sm-temporal-admin-tools:latest namespace list
  

• 创建命名空间：

  bash
  docker run --rm -e TEMPORAL_HOST=your-temporal-service pds-sm-temporal-admin-tools:latest namespace create --name pds-sm-namespace --retention 7d
  

环境变量配置

持久化配置

如需保存常用配置，可挂载本地配置文件：

bash
docker run --rm -v /local/config:/config -e TEMPORAL_CONFIG_PATH=/config/temporal.yaml pds-sm-temporal-admin-tools:latest

配置文件格式参考Temporal官方管理工具配置规范。

注意事项

• 确保镜像版本与PDS SM环境中的Temporal集群版本兼容
• 生产环境使用时需配置适当的认证与授权机制
• 执行数据修改操作（如删除命名空间）前建议先进行数据备份
• 长时间运行管理任务时，建议使用--detach模式并挂载日志目录以便审计