Base Stack Files
Base Stack Files
Overview
minipaas code init writes the environment descriptor and a small base stack next to it.
| File | Contents |
|---|---|
minipaas.yaml | Compose file list, Docker target, namespace, and vars |
compose.apps.yaml | Services collected from the source Compose files with swarm overrides |
compose.common.yml | <namespace>_network (internal) and <namespace>_public overlay networks |
compose.postgres.yml | postgres:17.4 with a named volume and POSTGRES_PASSWORD_FILE |
compose.caddy.yml | caddy:2.9.1-alpine on a manager with data and config volumes |
caddy.json | Empty Caddy server that code route fills in |
Details
compose.common.ymldefines the two overlay networks; services incompose.apps.yamlare moved to<namespace>_network.compose.postgres.ymlexpects the password secret mounted at/run/secrets/postgres_password; create it withdeploy secretand attach it topostgres.compose.caddy.ymlconstrains Caddy to a manager node and publishes container port80on host port8000; see Caddy and TLS.- Image tags can be pinned with the
POSTGRES_IMAGE_TAGandCADDY_IMAGE_TAGvars inminipaas.yaml. - The files are ordinary Compose files: edit them or leave them out of
compose.fileswhen they are not needed.
Next Steps
- minipaas.yaml: full descriptor reference.
- CLI Usage: environment layout and commands.
- Reference: variables and compatibility.