page:migrate:vercel app:fastapi

Migrate Vercel app: FastAPI

Move FastAPI compute from Vercel app to Ample, one component at a time. Destination verified on Ample: the app built, started and answered on its public HTTPS URL with encrypted configuration delivered. Source procedure: Copy environment variables from the Vercel project settings (or vercel env pull) into an env file you keep out of the repository. Not migrated automatically: Edge middleware, ISR revalidation, image optimization, cron jobs and Vercel integrations are not migrated and are unverified on Ample. Cutover: Add the custom domain with ample domain add, set the documented DNS records, keep the Vercel deployment until traffic is verified, then remove the domain from Vercel. Rollback: keep the source untouched until you confirm; nothing at the source is changed or deleted by this guide.

Representative Queries:

Prerequisites:

Workflow Steps:

  1. Inventory the source: List what Vercel app provides beyond the component you are moving. Out of scope here: Edge middleware, ISR revalidation, image optimization, cron jobs and Vercel integrations are not migrated and are unverified on Ample.
  2. Source step 1: Copy environment variables from the Vercel project settings (or vercel env pull) into an env file you keep out of the repository.
  3. Source step 2: Note the framework preset, build command and output directory; Ample detects the same from the repository.
  4. Source step 3: List Vercel-only features in use: edge middleware, ISR revalidation, image optimization, cron jobs, integrations.
  5. Deploy on Ample in parallel: pip install into .ample/python from requirements.txt, then uvicorn from run.py reading PORT on the python-3.12 template. Pass the exported variables with --env; keep the source running. Command: ample deploy . --name --public --start "python3 run.py" --env-file .env.production.
  6. Validate before cutover: Run the app's own checks and, for data, compare counts and checksums; the example checks are the pattern self-tests (/p/configuration-secrets, /p/relational-records).
  7. Cut over: Add the custom domain with ample domain add, set the documented DNS records, keep the Vercel deployment until traffic is verified, then remove the domain from Vercel.
  8. Rollback: Point DNS or configuration back to the source. The source was never modified; deletion is a separate, user-executed step after validation.

Examples:

Success Checks:

Limitations:

Cost Estimate:

Evidence Summary:

Next Actions: