Files
govoplan/dev/production-like/README.md
T
zemion 7b0ab31adf
Dependency Audit / dependency-audit (push) Successful in 1m45s
Deployment Installer / deployment-installer (push) Successful in 7s
Security Audit / security-audit (push) Successful in 11m33s
Document GovOPlaN deployment profiles
2026-08-05 22:42:27 +02:00

2.0 KiB

Production-Like Development Profile

This profile runs the shared services that production depends on while keeping API, worker, scheduler, and WebUI code in the editable local repositories. It is the split source integration profile defined in docs/DEPLOYMENT_PROFILES.md. It does not exercise signed application images. Use an installer-generated evaluation Compose bundle for an immutable Dockerized whole-product rehearsal.

It provides:

  • PostgreSQL with a persistent Docker volume
  • Redis with append-only persistence
  • explicit ENABLED_MODULES
  • local durable file storage under runtime/production-like/files
  • a Celery worker process using the same queues as the API
  • a Celery beat process for durable retry and recovery schedules

Start it from the meta repository:

cd /mnt/DATA/git/govoplan
tools/launch/launch-production-like-dev.sh

The helper wrapper exposes repeatable lifecycle commands:

cd /mnt/DATA/git/govoplan
tools/launch/production-like-dev.sh validate-config
tools/launch/production-like-dev.sh seed
tools/launch/production-like-dev.sh start
tools/launch/production-like-dev.sh stop
tools/launch/production-like-dev.sh reset --yes

The launcher uses dev/production-like/.env when present, otherwise dev/production-like/.env.example. Copy the example when you want local port or password changes:

cp dev/production-like/.env.example dev/production-like/.env

The API, worker, and scheduler use:

DATABASE_URL=postgresql+psycopg://govoplan:govoplan-dev@127.0.0.1:55433/govoplan
REDIS_URL=redis://127.0.0.1:56379/0
CELERY_ENABLED=true

Stop the launched API/WebUI/worker/scheduler with Ctrl+C. The PostgreSQL and Redis containers keep running by default so the next launch is fast. To stop them too:

GOVOPLAN_STOP_PROFILE_DEPENDENCIES_ON_EXIT=1 tools/launch/launch-production-like-dev.sh

To remove all profile data:

cd /mnt/DATA/git/govoplan
tools/launch/production-like-dev.sh reset --yes