Skip to main content

Pipeline management

Apply a pipeline

Deploy a pipeline from a YAML configuration file:
goldsky turbo apply my-pipeline.yaml
This command will:
  • Validate your pipeline configuration
  • Create or update the pipeline in your current project
  • Start processing data according to your configuration
If there were existing pipelines with the same name, the checkpoints from those pipelines will be reused.

Options

FlagDescription
-i, --inspectOpen the inspect TUI after successful deployment to monitor live data
# Deploy and immediately start inspecting live data
goldsky turbo apply my-pipeline.yaml -i
To have a pipeline restart from scratch, you will have to rename the pipeline or rename the specific source node to avoid using the existing checkpoints.

List pipelines

View all pipelines in your current project:
goldsky turbo list

Delete a pipeline

Remove a pipeline by name:
goldsky turbo delete my-pipeline
Or delete using the YAML file:
goldsky turbo delete -f my-pipeline.yaml

Validate a pipeline

Check your pipeline configuration without deploying:
goldsky turbo validate my-pipeline.yaml
This is useful for:
  • Catching syntax errors before deployment
  • Verifying source and sink configurations
  • Testing transform logic

Viewing logs

Monitor your pipeline’s execution with the logs command:
# View recent logs (default: last 10 lines)
goldsky turbo logs my-pipeline

# Show last 50 lines
goldsky turbo logs my-pipeline --tail 50

# Show logs from last hour
goldsky turbo logs my-pipeline --since 3600

# Include timestamps
goldsky turbo logs my-pipeline --timestamps
Use --follow to monitor your pipeline in real-time, especially useful when debugging or watching data flow through transforms.

Inspecting live data

Open an interactive TUI to view live data flowing through your pipeline:
# Inspect all nodes in a pipeline
goldsky turbo inspect my-pipeline

# Filter to specific topology nodes
goldsky turbo inspect my-pipeline -n source1,transform1

# Adjust buffer size for more history
goldsky turbo inspect my-pipeline -b 50000

Options

FlagDescription
-n, --topology-node-keysComma-separated list of nodes to filter
-b, --buffer-sizeMaximum records to keep in buffer (default: 10000)

Keyboard shortcuts

KeyAction
Tab / Switch between topology node tabs
j k / Scroll up/down
g / GJump to top/bottom
/Search records
n / NNext/previous search match
dToggle pipeline definition view
wOpen in web dashboard
qQuit
The TUI automatically reconnects if the pipeline is updated or temporarily unavailable, with a 30-minute timeout for persistent connection failures.
For detailed information about Live Inspect, including all keyboard shortcuts and features, see the Live Inspect guide.

Managing projects and secrets

The Turbo Pipelines CLI integrates with the Goldsky CLI for project management

Projects

# List all projects you are a member of
goldsky project list
To log into a project you will need to generate an API key and run the golsky login command

Secrets

Secrets are used to store sensitive configuration like database credentials:
# Create a secret
goldsky secret create MY_POSTGRES_SECRET

# List secrets
goldsky secret list

# Delete a secret
goldsky secret delete MY_POSTGRES_SECRET
Secrets are referenced in your pipeline YAML using the secret_name field. See the Pipeline Configuration guide for examples.