deploy · git:20260922.a4bd47b · 2026-09-22 · sha256 ca8ee1e2f3b830b1

deploy git:20260922.a4bd47bA

Immutable. This exact content never changes and is served at /api/v1/blob/ca8ee1e2f3b830b1.

No tool to install first
claude plugin marketplace add https://markdownregistry.com/mp/a/art_gh7673nvn4bzvmpp/ca8ee1e2f3b830b1526765d3a6ee245bbaf269d79486c8687698f2bcb6b5c3b4.json

Then /plugin install deploy@markdownregistry-gh7673nvn4bzvmpp in Claude Code. It installs this exact version, the one graded A here, pinned to the commit it was graded at, and leaves it there.

---
name: deploy
description: >-
  Deploy a Fly.io-hosted app safely and verify the rollout. Trigger on
  "deploy", "ship it to prod", or after merging work that must go
  live. Covers the push-to-main pipeline, the local flyctl fallback, the
  release_command gotcha, and post-deploy verification.
---

# Deploy (Fly.io)

## Default path: push to main

For apps wired to CI (deploy = push to main), the deploy IS the
push. Run the pre-push-review gate first, push, then watch CI through to the
Fly release.

## Manual path: local flyctl

```bash
fly deploy -a <app> --remote-only
fly status -a <app>          # all machines should reach `started`
```

**Known gotcha**: machines can get stuck in state `created` when the app has
a `release_command`. Fix: deploy via local flyctl without
the release_command (comment it out of fly.toml for the deploy, run the
migration manually), then restore.

## Post-deploy verification (always)

1. `fly status -a <app>`: every machine `started`, latest version.
2. `fly logs -a <app>` for the first minute: no crash loops, no tracebacks.
3. Curl the health endpoint AND one real feature endpoint; check the JSON,
   not just 200.
4. If the deploy included a model/artifact change: confirm the served model
   version/registry entry, and refreeze snapshots if serving behavior
   changed.

## Rollback

- Code: `fly releases -a <app>` then `fly deploy --image <previous-image>`.
- Models: use the model-registry restore flow (R2 models/archive/<version>/ +
  restore workflow) instead of redeploying code.