Manaurum Platform v2
Publishing and migrations
A deploy creates a versioned source snapshot and updates the hosted runtime. Changing data and activating code are separate steps.
Contracts reviewed: · SDK version: 2.6.1
Deploy and visibility
The CLI validates and packages your source at the archive root; Core validates the manifest and SQL, builds the image, runs per-tenant migrations, then updates Swarm and Traefik, checks readiness and activates the version last. A migration failure blocks the runtime update; earlier tenant schema changes remain. Inspect the terminal deploy job result. private targets the home tenant, allow_list lists tenant IDs, and public allows the Store installation flow subject to policy and review. Existing installs keep their grants; new declarations do not automatically widen them.
Migrations are forward-only
Place files in migrations/ in lexical order. Applied files are tracked by filename and SHA-256; do not edit one that has already run. Validate every file with manaurum app validate-migration. Additive DDL passes; destructive DDL needs migration.breaking: true. This flag widens validation and does not request tenant approval. The runner continues the fan-out after a tenant failure, but does not activate the version if any tenant failed. Earlier tenant changes are not undone. Inspect result.per_tenant_status and fix forward with a new file. Unknown statements, role/GUC/transaction statements, COPY, DO and files over 64 KB are refused even with the flag.
Rollback is a background job
Use list-versions and rollback with the required --app-id. Rollback returns a job ID; unlike deploy, the CLI does not poll it to completion. Follow the returned job before assuming success. Swarm and routing update before the current-version pointer. Rollback does not reverse migrations: old code may be incompatible with the new schema and needs a forward migration. Secrets are set with manaurum app set-secret NAME VALUE --app-id APP_ID; never bake runtime credentials into an image.
manaurum app list-versions --app-id my-tracker
manaurum app rollback 0.0.1 --app-id my-tracker