Runtime Modes¶

Purpose¶

Explain how local and deployment runtime mode topologies differ and how to validate behavior across both.

When To Use This Page¶

• setting up environment-specific workflows
• debugging differences between local and deploy behavior
• validating release readiness after local implementation

Mode Comparison¶

Runtime Topology¶

flowchart LR
    subgraph Local["Local"]
      LA["app"] --> LDB["db"]
      LA --> LR["redis"]
      LR --> LC["celery"]
    end

    subgraph Deploy["Deploy"]
      PX["proxy"] --> DA["app"]
      DA --> DDB["db"]
      DA --> DR["redis"]
      DR --> DC["celery"]
    end

Validation Workflow¶

1. Bring up local runtime mode and run checks.
2. Execute smoke suite.
3. Bring up deployment runtime mode and repeat checks.
4. Compare critical route/auth/task behavior.

# local
docker compose up -d --build
docker compose run --rm app python manage.py check

# deployment runtime mode
docker compose -f docker-compose-deploy.yml up -d --build
docker compose -f docker-compose-deploy.yml run --rm <deploy-app-service> python manage.py check

Common Failure Modes¶