Developer Guide / Deployment & Infra

Deployment & Infra

Running, scaling, monitoring and backing up the platform.

The platform ships as Docker images orchestrated by Docker Compose, with an infrastructure service for health monitoring and scaling.

Images and compose

mvn clean package -Pdocker -DskipTests     # build all images
docker-compose up --build                  # start the stack

Infrastructure service

magicvarsh-infra-service powers the in-app Infrastructure screen, which has tabs for Health Monitor, Instances, Deploy Service and API Docs. Operators can watch service health, view running instances, deploy services and reach API docs from one place. The dashboard also surfaces a live Service Registry and a 'Services Up' count.

The Infrastructure screen (Health Monitor / Instances / Deploy).
The Infrastructure screen (Health Monitor / Instances / Deploy).

Dev infrastructure tooling

ToolPortPurpose
Eureka dashboard8761Service registry health
pgAdmin5050PostgreSQL browser
MailHog8025Catch-all dev SMTP
Swagger UIvia gatewayPer-service API docs

Backup & restore

Because each service owns a PostgreSQL schema, data is backed up at the database level. Standard PostgreSQL backup and restore (for example scheduled dumps of the database volume) capture the full platform state, and a restore returns it to that point in time. Combine database backups with the in-app Trash for everyday recovery of individual items.

i
A full reset including database volumes is docker-compose down -v — use with care, as it deletes data.