Saltar a contenido

apogee Docker lifecycle and infra:*

These commands wrap docker-compose for the generated project, plus a set of add:* / remove:* shortcuts that edit docker-compose.yml for you.

Lifecycle

Command Equivalent Notes
apogee up docker-compose up -d Starts all services in the background
apogee down docker-compose down Stops services. Add --volumes to drop data
apogee build docker-compose build Rebuilds images
apogee stop docker-compose stop Stops without removing
apogee restart docker-compose restart
apogee rebuild down + build + up Full reset of containers (keeps volumes by default)
apogee logs docker-compose logs -f app Follow app logs. Pass --service <name> for another
apogee status / apogee ps docker-compose ps List service states
apogee shell docker-compose exec app bash Drops into the app container
apogee env:list — Lists environment variables resolved from .env

Database lifecycle

Command Description
apogee db-context-create <name> Creates a new Alembic migration for the given context
apogee db-context-migrate Runs all pending migrations
apogee db-context-seed Runs seeders (if defined under infrastructure/seeds/)

These commands use a programmatic Alembic runner provided by apogee-core — no alembic.ini editing needed.

add:* — provision infrastructure services

Each add:* command edits docker-compose.yml, adds the service, exposes the right ports, sets sensible defaults, and updates .env.example.

Bash
apogee add:postgres        # already there by default; use to swap versions
apogee add:mysql
apogee add:mongo
apogee add:redis
apogee add:qdrant          # vector store — used by apogee-ai-rag
apogee add:rabbitmq
apogee add:elasticsearch

Then re-run:

Bash
apogee rebuild

remove:* — opposite of add:*

Bash
apogee remove:redis

Removes the service from docker-compose.yml and warns if the codebase still depends on it.

infra:* — diagnostics

Bash
apogee infra:status        # health of all services
apogee infra:ports         # which ports are bound by which service
  • Modules overview — links to detailed docs of each module that uses these services (RAG, auth, AI providers).