Skip to Content
Apso is in public beta. Get started
GuidesDeploymentOverview

Deployment

Generated services can run through Apso Cloud or with the normal deployment process for NestJS, FastAPI, or Gin. Choose the path from your team’s ownership, network, compliance, database, and operations requirements.

Deployment pathsChoose where the backend runs.
Same repository
Your serviceFramework code + migrations + infrastructure
Managed path

Apso Cloud

Use Apso's deployment workflow for the service, database, migrations, and environment configuration.

apso deploy
Portable path

Your cloud

Deploy the generated application with Docker or your existing AWS, CI/CD, and observability stack.

docker build .
Hosting can change without changing the product contract or giving up the generated source.

Options

Choose the boundary

QuestionApso CloudSelf-hosted
Who operates the service deployment?Apso platform workflowYour infrastructure team
Where are runtime variables managed?Service Environment viewYour secret and configuration system
How is source delivered?Connected GitHub repositoryYour build pipeline or image registry
Who owns network and runtime policy?Platform according to the selected planYour team
Can the framework source be moved later?YesAlready in your repository

Required checks

  1. Validate .apsorc and regenerate.
  2. Review the generated diff.
  3. Run apso migrate and inspect database changes.
  4. Run framework tests and the production build.
  5. Configure runtime variables outside source control.
  6. Verify /health and /_docs after deployment.
  7. Exercise one authenticated read and write.
  8. Record the deployed commit and rollback process.

Framework builds

TargetTypical checks
TypeScriptnpm test and npm run build
Pythonpytest and python -m compileall app
Gogo test ./... and go build ./...

Use the generated project scripts as the source for its exact build and migration commands.

Last updated on