.PHONY: help up down logs status rebuild clean psql logs-backend logs-gateway logs-mail build-engine stop-engines wait .DEFAULT_GOAL := help COMPOSE := docker compose REPO_ROOT := $(realpath $(CURDIR)/../..) ENGINE_IMAGE := galaxy-engine:local-dev # Label set by the engine `Dockerfile` runtime stage; used to find # engine containers spawned by backend's runtime that fall outside # `docker compose down`'s scope. ENGINE_LABEL := org.opencontainers.image.title=galaxy-game-engine help: @echo "Local development stack for the Galaxy UI:" @echo " make up Build (if needed) and bring up the stack, wait until healthy" @echo " make down Stop containers (incl. spawned engines), keep volumes" @echo " make rebuild Force rebuild of backend / gateway images and bring up" @echo " make build-engine Build the engine image $(ENGINE_IMAGE) used by the dev sandbox" @echo " make stop-engines Stop and remove only the per-game engine containers" @echo " make clean Stop and wipe volumes (postgres data, engines, game state)" @echo " make logs Tail all logs" @echo " make logs-backend Tail only the backend logs" @echo " make logs-gateway Tail only the gateway logs" @echo " make logs-mail Tail only the mailpit logs" @echo " make status docker compose ps" @echo " make psql Open a psql shell as galaxy@galaxy_backend" @echo "" @echo "After 'make up', point the UI at the stack with:" @echo " pnpm -C ui/frontend dev" @echo "and open http://localhost:5173 (UI) plus http://localhost:8025 (Mailpit)." @echo "" @echo "Default login for the auto-provisioned dev sandbox: dev@local.test" @echo "(see BACKEND_DEV_SANDBOX_EMAIL in .env). Login code: 123456." up: build-engine $(COMPOSE) up -d --wait rebuild: build-engine $(COMPOSE) build --no-cache backend gateway $(COMPOSE) up -d --wait build-engine: @if docker image inspect $(ENGINE_IMAGE) >/dev/null 2>&1; then \ echo "$(ENGINE_IMAGE) already built; skipping (use 'docker rmi $(ENGINE_IMAGE)' to force a rebuild)."; \ else \ echo "building $(ENGINE_IMAGE)…"; \ docker build -t $(ENGINE_IMAGE) -f $(REPO_ROOT)/game/Dockerfile $(REPO_ROOT); \ fi down: stop-engines $(COMPOSE) down clean: stop-engines $(COMPOSE) down -v @if [ -d /tmp/galaxy-game-state ]; then \ echo "wiping /tmp/galaxy-game-state…"; \ docker run --rm -v /tmp/galaxy-game-state:/state alpine sh -c 'rm -rf /state/*' 2>/dev/null || rm -rf /tmp/galaxy-game-state/* 2>/dev/null || true; \ fi # Spawned engine containers run outside the compose project (the # backend's runtime creates them on demand), so `compose down` does # not see them. We discover them by the engine image's # OCI title label, set by game/Dockerfile. stop-engines: @ids=$$(docker ps -aq --filter label=$(ENGINE_LABEL)); \ if [ -n "$$ids" ]; then \ echo "stopping engine containers…"; \ docker rm -f $$ids >/dev/null; \ fi logs: $(COMPOSE) logs -f --tail=100 logs-backend: $(COMPOSE) logs -f --tail=200 backend logs-gateway: $(COMPOSE) logs -f --tail=200 gateway logs-mail: $(COMPOSE) logs -f --tail=200 mailpit status: $(COMPOSE) ps psql: $(COMPOSE) exec postgres psql -U galaxy -d galaxy_backend