Skip to content

chore(deploy): gp.nano migration helper scripts and pre-flight checklist#23

Merged
javierdejesusda merged 1 commit into
mainfrom
chore/nano-migration-prep
May 8, 2026
Merged

chore(deploy): gp.nano migration helper scripts and pre-flight checklist#23
javierdejesusda merged 1 commit into
mainfrom
chore/nano-migration-prep

Conversation

@javierdejesusda
Copy link
Copy Markdown
Owner

Summary

Adds the operator-facing scripts and pre-flight checklist that finalise the gp.nano migration prep started in #22. With this in, the only manual work left for the actual migration is provisioning the gp.nano VPS in the Cubepath panel and following the runbook.

  • scripts/migrate-to-nano/bootstrap-host.sh — idempotent SSH-time bootstrap for a fresh gp.nano host (Docker engine + compose plugin, 2 GB swap, Dokploy installer). Single curl-pipe-bash invocation.
  • scripts/migrate-to-nano/verify-nano.sh — post-deploy smoke test (frontend 200, /health 200, chat 503, province forecast contains q50). Run against the Dokploy preview URL before DNS cutover, then again after.
  • scripts/migrate-to-nano/env-vars-checklist.md — exact env vars to carry from the gp.starter Dokploy panel, classified by whether mismatch is data-destructive (FIELD_ENCRYPTION_KEY, VAPID keys), session-invalidating (JWT_SECRET, NEXTAUTH_SECRET), or low-risk.
  • docs/deployment/nano.md — adds a "Pre-flight (24 h before cutover)" section, references the new scripts, and tightens the cutover steps to point at the verify script.

Test plan

  • Both shell scripts have execute bits in the index
  • No secrets in the repo
  • Pre-flight DNS-TTL reminder + env-var carry-over checklist surface the FIELD_ENCRYPTION_KEY data-integrity hazard explicitly

@javierdejesusda javierdejesusda merged commit 6c160ed into main May 8, 2026
3 checks passed
@javierdejesusda javierdejesusda deleted the chore/nano-migration-prep branch May 8, 2026 17:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant