Files
claude_mac/templates/deploy/PROCEDURE.md
T
Bastien Chanot 31443baa1b feat(skills): /deploy NEXT.sh session style + inline hand-back print
First-real-run UX feedback (EVAL-016): one command per line as typed in an
interactive session (ssh opens the box, following lines run on it, local
steps flagged), never folded ssh compounds; the hand-back prints the full
checklist in the conversation (and every re-hand-back reprints it). Step
defined as a block (header + command lines to next blank line), @delta
governs the block. Template restyled to match.
2026-07-05 15:33:38 +02:00

1.7 KiB

#!/usr/bin/env bash

=== deploy runbook (reference) — NOT run directly. Instantiated to NEXT.sh per delta. ===

Fixed steps run every deploy; # @delta: steps re-instantiate from the delta.

@config push_deploy_tags=false

NOTE grammar: glob=:each repeats the command per matching file (e.g. psql -f );

glob=:list runs once + lists matching files as VERIFY items; when=<pat,...> is conditional.

Style: one command per line, as typed in an interactive session — step 1 opens

the ssh session, later steps run ON the box; local steps say "(from your machine)".

1) connect + pull the desired branch (fixed)

ssh "$DEPLOY_HOST" cd "$APP_DIR" git pull # VERIFY: HEAD == target sha

2) backup BEFORE any forward-only migration

pg_dump "$DB" > ~/backups/pre-deploy-$(date +%F-%H%M).sql # VERIFY: dump size > 0

@delta:migrations glob=supabase/migrations/*.sql:list

3) apply NEW migrations (one command; the skill lists the delta migrations to VERIFY)

supabase migration up # VERIFY: "Applied" for each

@delta:rebuild when=docker-compose*.yml,Dockerfile,Dockerfile.*

4) rebuild + restart services (only if build inputs changed)

docker compose up -d --build # VERIFY: docker compose ps healthy

@delta:deps when=package.json,lock,requirements.txt,pyproject.toml

5) install deps (only if manifests changed)

cd app npm ci # VERIFY: exit 0

6) reload + smoke test

systemctl reload app

(from your machine)

curl -fsS https://$DEPLOY_HOST/health # VERIFY: HTTP 200