SuperAPI AI 工具集

truefoundry-monitor

部署与运维

查看项目

更新于 10-16 09:54

技能介绍

用途:在 TrueFoundry 执行 tfy apply 或 tfy deploy 后跟踪发布进度,直至部署进入终态。用户说“监控”“观察部署”“部署完成了吗”“检查发布”时使用;deploy 技能成功执行后也会自动调用。不用于部署、列出应用或读取历史日志等场景,这些应分别交给 deploy、applications、logs 技能。

主要能力:轮询部署状态与过渡阶段,依据 state.isTerminalState 判断是否停止;成功时报告副本就绪数与端点 URL,并可对暴露的 HTTP 端口做一次健康检查;失败时拉取构建或 Pod 日志,识别 OOMKilled、CrashLoopBackOff、ImagePullBackOff、端口不匹配、就绪探针失败、构建错误等原因并给出修复建议。

必要信息:工作区 FQN(硬性规则,必须由用户确认,不可自动选取)与应用名称;若紧接部署调用,两者通常已从部署上下文获知。

使用方式:优先使用 MCP 工具 tfy_applications_list(filters={"workspace_fqn": "WORKSPACE_FQN", "application_name": "APP_NAME"});不可用时回退到直接 API,需将 TFY_API_SH 指向本技能 scripts/tfy-api.sh 的完整路径,例如 bash $TFY_API_SH GET '/api/svc/v1/apps?workspaceFqn=WORKSPACE_FQN&applicationName=APP_NAME'。轮询节奏:前 2 分钟每 15 秒、2 至 5 分钟每 30 秒、5 分钟后每 60 秒,10 分钟超时并给出当前状态与手动检查建议。

状态与行为规则:状态包括 INITIALIZED、BUILDING、BUILD_SUCCESS、BUILD_FAILED、ROLLOUT_STARTED、DEPLOY_SUCCESS、DEPLOY_FAILED、DEPLOY_FAILED_WITH_RETRY、PAUSED、FAILED、CANCELLED,其中 DEPLOY_FAILED_WITH_RETRY 为非终态,需继续轮询。监控一旦开始必须持续轮询到终态或超时,不得提前停止、不得询问用户是否继续;每次轮询之间简要说明等待内容。失败时不自动重试,只给出诊断与建议。

限制:仅覆盖上述监控与诊断流程;具体修复动作需用户决定并重新部署。其他平台、价格与更多平台细节暂未提供。