Turbo Operations

goldsky-io/goldsky-agent/skills/turbo-operations

作者 goldsky-ioaa52f88312de無授權條款12 個星標收錄於 2026年10月9日更新於 2026年10月9日儲存庫今天更新

Turbo pipeline operations reference — lifecycle commands (pause, resume, restart, delete), pipeline states, checkpoint behavior, streaming vs job-mode differences, CLI syntax for `inspect`/`logs`, TUI shortcuts, and error pattern lookup. Triggers on: 'how do I pause/restart/delete', 'will deleting lose my data', 'what does this error mean', 'inspect TUI shortcuts'. For interactive diagnosis of a broken pipeline, use /turbo-doctor.

包含腳本DevOps & Cloud

AI 產生的概覽

Turbo 管線生命週期指令、監控、檢查點與常見錯誤模式的參考手冊。

功能: 此技能是操作 Turbo 管線的查詢參考。它記錄了管線狀態、串流與作業模式的生命週期差異、暫停、恢復、重新啟動和刪除等生命週期指令、檢查點行為，以及包括 inspect 和 logs 在內的監控指令。它也提供錯誤模式表和一个輔助指令碼，用於分析管線日誌中的常見錯誤並提出發現與建議。
適用情境: 當你需要查詢如何暫停、恢復、重新啟動或刪除 Turbo 管線，了解刪除是否會遺失資料，解讀管線錯誤訊息，或尋找 inspect 與 TUI 快速鍵時使用。它是參考手冊，而非互動式診斷工具。
執行需求: 需要 Goldsky CLI 來執行文件中的指令，並需要存取 Turbo 專案。它附帶可執行 shell 指令碼 scripts/analyze-logs.sh 和 JSON 錯誤模式資料檔；執行指令碼需要 shell 環境和管線日誌存取權限。

Turbo Pipeline Operations

Lifecycle commands, monitoring, and error reference for running Turbo pipelines. This is a lookup reference — for interactive troubleshooting of a broken pipeline, use /turbo-doctor. For building new pipelines, use /turbo-builder.

Pipeline States

State	Description
running	Pipeline is actively processing data
starting	Pipeline is initializing
paused	Pipeline is paused (replicas set to 0)
stopped	Pipeline is not running (manually stopped)
error	Pipeline encountered an error
completed	Job-mode pipeline finished processing range

Streaming vs Job Mode Lifecycle

Operation	Streaming Pipeline	Job-Mode Pipeline (`job: true`)
List	Shows as `running`/`paused`	Shows as `running`/`completed`
Pause	Supported	Not supported
Resume	Supported	Not supported
Restart	Supported	Not supported — use delete + apply
Delete	Supported	Supported (auto-cleanup ~1hr after done)
Apply	Updates in place	Must delete first, then re-apply

Job-Mode Pipeline Lifecycle

Job-mode pipelines (job: true) are one-time batch processes:

Start — process data from start_at to end_block
Run — process the bounded data range
Complete — automatically stop when range is processed
Auto-cleanup — ~1 hour after completion, automatically removed

Cannot pause, resume, or restart. Must delete before redeploying.

Lifecycle Commands

List Pipelines

Pause a Pipeline

Temporarily stop processing without deleting. Preserves all state for later resumption.

Resume a Pipeline

Restore a paused pipeline. Can only resume a paused pipeline.

Restart a Pipeline

Trigger a pod restart for a running or paused pipeline.

bash

goldsky turbo restart <pipeline-name># To clear all checkpoints and reprocess from the beginning:goldsky turbo restart <pipeline-name> --clear-state

goldsky turbo restart <pipeline-name># To clear all checkpoints and reprocess from the beginning:goldsky turbo restart <pipeline-name> --clear-state

Delete a Pipeline

Permanently remove a pipeline. All checkpoints are lost. Data already written to sinks is preserved.

Delete and Recreate (Fresh Start)

Checkpoint Behavior

Deleting a pipeline removes its checkpoints permanently
Recreating with the same name starts fresh (no checkpoint recovery)
To preserve checkpoints, use apply to update instead of delete/recreate
Checkpoint state is tied to source names — renaming a source resets its checkpoint
Checkpoint state is tied to pipeline names — renaming a pipeline resets all checkpoints

Monitoring Commands

Action	Command
List pipelines	`goldsky turbo list`
View live data	`goldsky turbo inspect <name> -p`
Inspect specific node	`goldsky turbo inspect <name> -n <node> -p`
View logs	`goldsky turbo logs <name>`
Follow logs	`goldsky turbo logs <name> --follow`
Logs with timestamps	`goldsky turbo logs <name> --timestamps`
Last N lines	`goldsky turbo logs <name> --tail N`
Logs since N seconds ago	`goldsky turbo logs <name> --since N`

`goldsky turbo inspect` Flags

Always use -p. Always include it in every inspect command you suggest.

Log Analysis Script

Use the helper script to quickly analyze pipeline logs:

The script checks for common error patterns and reports findings with recommendations.

Common Error Patterns

Detailed error patterns and solutions are in data/error-patterns.json.

Error Pattern	Likely Cause	Fix
`connection refused`	Database unreachable	Check network/firewall settings
`authentication failed`	Wrong credentials	Update secret with correct credentials
`secret not found`	Missing secret	Create secret with `goldsky secret create`
`SQL syntax error`	Invalid transform SQL	Fix SQL in YAML and redeploy
`duplicate key`	Primary key collision	Ensure unique primary key in transform
`script transform error`	TypeScript runtime failure	Check script logic, null handling, return types
`dynamic_table` error	Backend connection issue	Verify dynamic table secret/table exists
`WASM execution failed`	Script crash in sandbox	Debug script — check for undefined access
`handler timeout`	External HTTP endpoint slow	Increase `timeout_ms` or fix handler endpoint

Script Transform Issues

Issue	Fix
`undefined` property access	Add null checks: `input.field ?? ''`
Wrong return type	Ensure returned object matches `schema` exactly
Missing return fields	All `schema` fields must be present in returned object
`invoke is not a function`	Ensure script defines `function invoke(data)`
BigInt errors	Use `BigInt()` constructor, not direct number literals

Dynamic Table Issues

Issue	Fix
Table not found	Create the table in PostgreSQL before deploying
No matches from check	Verify data exists in the backing table
Stale data	For postgres backend, verify rows are actually there
Memory pressure	Large in_memory tables → switch to postgres backend

Troubleshooting Quick Reference

Symptom	Likely Cause	Quick Fix
No data flowing	`start_at: latest`	Wait for new data or use `earliest`
Auth failed	Wrong credentials	Update secret with correct password
Connection refused	Network/firewall	Check host, whitelist Goldsky IPs
Storage exceeded	Neon free tier (512MB)	Upgrade plan or clear data
SQL error	Bad transform syntax	Validate YAML first
Pipeline not found	Name mismatch	Run `goldsky turbo list` to check names
Permission denied	Role insufficient	Verify Editor or Admin role in the project
`pipeline already exists`	Job-mode stale	Delete first, then re-apply
Cannot pause/resume job	Job-mode limitation	Job pipelines don't support pause/resume
Cannot restart job	Job-mode limitation	Delete + re-apply instead
Can't connect to inspect	Pipeline not running	Check status with `goldsky turbo list`
Logs are empty	Pipeline just started	Wait for data or check `start_at`
TUI disconnects	Pipeline interrupted	Auto-reconnects within 30 min; check status

/turbo-doctor — Interactive diagnostic skill for pipeline issues
/turbo-builder — Build and deploy new pipelines
/turbo-pipelines — YAML configuration and architecture reference

來源與署名

來源：goldsky-io/goldsky-agent位於skills/turbo-operations提交aa52f88

授權條款：無授權條款

內容歸原作者所有。SourceWeft 從公開儲存庫中收錄這些內容。

檢舉或申請下架

Flag	Short	Description
`--print`	`-p`	Print records to stdout
`--topology-node-keys`	`-n`	Comma-separated node keys to filter (e.g. a transform name)
`--buffer-size`	`-b`	Max records to keep in buffer (default: 10000)

Turbo Operations

Turbo Pipeline Operations

Pipeline States

Streaming vs Job Mode Lifecycle

Job-Mode Pipeline Lifecycle

Lifecycle Commands

List Pipelines

Pause a Pipeline

Resume a Pipeline

Restart a Pipeline

Delete a Pipeline

Delete and Recreate (Fresh Start)

Checkpoint Behavior

Monitoring Commands

`goldsky turbo inspect` Flags

Log Analysis Script

Common Error Patterns

Script Transform Issues

Dynamic Table Issues

Troubleshooting Quick Reference

Related

來源與署名

更多來自 goldsky-io/goldsky-agent 的技能

Turbo Transforms

Turbo Builder

Subgraph Migrate

Subgraph Builder

Onchain Automation

Mirror

更多DevOps & Cloud技能

Playwright Devops

M5 Onboard

Yeet

Runbook

Incident Response

Deploy Checklist

Turbo Operations

Turbo Pipeline Operations

Pipeline States

Streaming vs Job Mode Lifecycle

Job-Mode Pipeline Lifecycle

Lifecycle Commands

List Pipelines

Pause a Pipeline

Resume a Pipeline

Restart a Pipeline

Delete a Pipeline

Delete and Recreate (Fresh Start)

Checkpoint Behavior

Monitoring Commands

goldsky turbo inspect Flags

Log Analysis Script

Common Error Patterns

Script Transform Issues

Dynamic Table Issues

Troubleshooting Quick Reference

Related

來源與署名

更多來自 goldsky-io/goldsky-agent 的技能

Turbo Transforms

Turbo Builder

Subgraph Migrate

Subgraph Builder

Onchain Automation

Mirror

更多DevOps & Cloud技能

Playwright Devops

M5 Onboard

Yeet

Runbook

Incident Response

Deploy Checklist

`goldsky turbo inspect` Flags