Docs / Ship

Versions & rollback

Publish, roll out, promote and revert.

Publishing freezes a draft into an immutable version. Versions can be deployed to environments and rolled out gradually.

Rollout strategies

Instant: 100% of traffic moves to the new version.
Canary: a percentage of traffic, increased manually or on a schedule.
Shadow: the new version runs on real traffic but its output is discarded, for comparison.

Automatic rollback

Define rules on error rate, latency, cost or evaluation score. When a rule is breached during a rollout, traffic returns to the previous version and your team is notified.

rollout:
  strategy: canary
  steps: [10, 50, 100]
  interval: 30m
rollback:
  error_rate: "> 2%"
  p95_latency: "> 8s"
  eval_score: "< baseline - 5%"