Skip to main content

Deployment Runbook

Deploy Strategy (recommendations)​

  1. Build backend artifacts + frontend assets.
  2. Run a controlled migration.
  3. Restart worker queue.
  4. Health check critical endpoints.

Pre-Deploy Checklist​

  • DB Backup
  • Backup storage files (storage/app)
  • Review migration fix/update/regenerate impact
  • Validate env vars (DB, mail, firebase, queue)
  • Run minimal + lint test

Backend Deploy Steps​

composer install --no-dev --optimize-autoloader
php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan migrate --force
npm ci
npm run production

Queue Operations​

php artisan queue:restart
# atau supervisor restart worker

Rollback Plan​

  1. php artisan migrate:rollback --step=1 (carefully migrate patch data).
  2. Restore DB backup if migration is irreversible.
  3. Restore storage if there are changes to important files.

Post-Deploy Validation​

  • Admin login successful.
  • List of SPB/PO/Open payments normally.
  • Endpoint API login + project list OK.
  • Queue processes jobs without failure.

Verification Notes​

  • Status: Partial
  • Scope: CI/CD pipeline is not defined in the repo; runbooks are currently manual procedures.
  • Action: Add deploy path attachments per environment (manual vs pipeline) when available.