Obelica Docs
Migrazioni

Template migrazione app

Scheda tecnica da compilare prima di migrare una app

Identity

  • App name:
  • Current hosting:
  • Target path: /opt/obelica/apps/<app-name>
  • Current domain:
  • Target domain:
  • Temporary test domain:
  • Repository:
  • Owner/contact:

Stack

  • Framework:
  • Runtime:
  • Package manager:
  • Build command:
  • Start command:
  • Dockerfile present:
  • Node version:

Data

  • Database:
  • ORM:
  • Migration command:
  • Seed command:
  • Persistent volumes:
  • Upload/storage provider:
  • External APIs:

Environment

Public config variables:

# Name only, no values

Secret variables:

# Name only, no values

Secret file target:

/opt/obelica/secrets/apps/<app-name>.env

Deployment

  • Compose file:
  • Internal app port:
  • Traefik router name:
  • Health endpoint:
  • Smoke test command:

Backup

  • DB dump command:
  • Files/storage backup:
  • Restore notes:

Migration plan

  1. Backup current state.
  2. Prepare DNS test record.
  3. Build image locally/on server.
  4. Start app on test domain.
  5. Run DB migrations.
  6. Smoke test.
  7. Switch DNS.
  8. Verify production.
  9. Keep old deployment available for rollback.

Rollback

  • DNS rollback target:
  • Vercel rollback steps:
  • DB rollback notes:
  • Expected downtime:

Go/no-go checklist

  • Build passes.
  • App starts under Docker.
  • HTTPS works through Traefik.
  • Database connects.
  • Migrations tested.
  • Auth/admin tested.
  • Uploads/storage tested.
  • External APIs tested.
  • Backup exists.
  • Rollback path known.
  • Docs updated.

On this page