SuperAPI AI 工具集

turbo-operations

部署与运维

查看项目

更新于 10-15 21:53

技能介绍

用途:这是 Goldsky Turbo 流水线的运维速查参考,面向运行中的流水线做生命周期管理、监控与错误排查。交互式诊断请用 /turbo-doctor,新建流水线请用 /turbo-builder。

主要能力:

  1. 生命周期命令。列出流水线:goldsky turbo list;暂停:goldsky turbo pause <pipeline-name>;恢复:goldsky turbo resume <pipeline-name>;重启:goldsky turbo restart <pipeline-name>,加 --clear-state 可清除全部检查点从头重跑;删除:goldsky turbo delete <pipeline-name>。删除后重建会全新开始,不恢复检查点;要保留检查点应使用 apply 原地更新。
  2. 状态与模式。状态包括 running、starting、paused、stopped、error、completed。流式流水线支持暂停、恢复、重启;作业模式(job: true)为一次性批处理,从 start_at 处理到 end_block,完成后自动停止并在约 1 小时后自动清理,不支持暂停、恢复、重启,重新部署前必须先删除。
  3. 检查点行为。删除流水线会永久移除检查点;检查点与源名称、流水线名称绑定,重命名源或流水线都会重置检查点。
  4. 监控。查看实时数据:goldsky turbo inspect <name> -p;按节点过滤:goldsky turbo inspect <name> -n <node> -p;查看日志:goldsky turbo logs <name>,可加 --follow、--timestamps、--tail N、--since N。inspect 建议始终带 -p。
  5. 日志分析脚本:./scripts/analyze-logs.sh <pipeline-name>,可加 --tail 100。

常见错误与修复:connection refused 多为数据库不可达,检查网络/防火墙;authentication failed 为凭据错误,更新 secret;secret not found 需用 goldsky secret create 创建;SQL 语法错误需修正 YAML 中的 SQL 并重新部署;duplicate key 需保证转换主键唯一;script transform 错误检查脚本逻辑、空值处理与返回类型;dynamic_table 错误检查后端连接与表是否存在;WASM 执行失败检查脚本崩溃;handler timeout 可增大 timeout_ms 或修复端点。脚本转换常见问题包括未定义属性访问、返回类型不符、缺少返回字段、未定义 invoke(data)、BigInt 用法错误。动态表问题包括表不存在、无匹配、数据陈旧、内存压力(可改用 postgres 后端)。

限制:作业模式不支持暂停、恢复、重启;删除会丢失检查点;重命名源或流水线会重置检查点;部分错误需结合具体环境判断。更多错误模式见 data/error-patterns.json。