Skip to main content

Operations Runbook

Setup / build docs​

Di docs-site/docusaurus:

  • Install: npm install
  • Dev: npm run start
  • Build: npm run build
  • Serve static: npm run serve

Application operations (repo root)​

  • Env bootstrap: copy .env sesuai environment (verification required, file contoh tidak dievaluasi di sesi ini).
  • Migration discipline: jalankan migration secara berurutan; review alter migration pada tabel kritis.
  • Health probe: GET /ping?token=<PING_TOKEN> (lihat routes/web.php).

Deploy docs to Cloudflare Pages​

  • Build output: docs-site/docusaurus/build
  • Deploy command:
    • npx wrangler pages deploy build --project-name example2-docs-customa
  • Required env:
    • CLOUDFLARE_API_TOKEN
    • CLOUDFLARE_ACCOUNT_ID

Observability checkpoints​

  • App health via /ping
  • Error logs: storage/logs
  • Route-level auth failures (sanctum/web) di access/error logs infra

Rollback basics​

  • Docs rollback: redeploy build sebelumnya ke project Pages yang sama.
  • App rollback: gunakan strategy migration rollback + artifact versioning (harus align dengan pipeline deploy existing; verification required).