Ilia Denisov
0cae89cba2
Tests · Go / test (push) Successful in 1m59s
Stage 1 of the dev-as-prod-mirror rework. The auto-provisioned "Dev Sandbox" game and dummy users are removed so the dev contour starts empty like prod; the separate legacy-report loader stays as the test-data path. - delete backend/internal/devsandbox (package + tests) - drop the bootstrap call + DevSandboxConfig (struct, Config field, BACKEND_DEV_SANDBOX_* env, defaults, loader, validation) - strip BACKEND_DEV_SANDBOX_* from dev-deploy + local-dev compose and .env.example; the generic engine-recycle / prune-broken-engines logic stays (it serves real games) - update tooling docs (dev-deploy README + KNOWN-ISSUES, local-dev README + Makefile) and stale comments; DeleteGame and InsertMembershipDirect remain (exercised by lobby integration tests) No app behaviour change beyond not auto-creating the sandbox game.
128 lines
5.2 KiB
Makefile
128 lines
5.2 KiB
Makefile
.PHONY: help up down logs status rebuild clean psql logs-backend logs-gateway logs-mail build-engine stop-engines prune-broken-engines wait
|
|
|
|
.DEFAULT_GOAL := help
|
|
|
|
COMPOSE := docker compose
|
|
REPO_ROOT := $(realpath $(CURDIR)/../..)
|
|
ENGINE_IMAGE := galaxy-engine:local-dev
|
|
# Engine containers spawned by backend's runtime fall outside the
|
|
# compose project. We identify them by two labels:
|
|
# STACK_LABEL — backend stamps this on every engine it spawns from
|
|
# this stack (see BACKEND_STACK_LABEL env in the
|
|
# compose file);
|
|
# ENGINE_LABEL — image-level OCI title baked into the engine
|
|
# Dockerfile.
|
|
# Both filters together select exactly this stack's engine containers
|
|
# and never compose-managed services or unrelated workloads.
|
|
STACK_LABEL := galaxy.stack=local-dev
|
|
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 compose containers, leave engines + volumes intact"
|
|
@echo " make rebuild Force rebuild of backend / gateway images and bring up"
|
|
@echo " make build-engine Build the engine image $(ENGINE_IMAGE) used by running games"
|
|
@echo " make stop-engines Stop and remove only the per-game engine containers"
|
|
@echo " make prune-broken-engines Remove non-running engine containers Docker can't heal (run inside 'up')"
|
|
@echo " make clean Stop everything (incl. engines) and wipe volumes + 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 "Sign in with email-OTP; the fixed login code 123456 works when"
|
|
@echo "BACKEND_AUTH_DEV_FIXED_CODE is set in .env. No game is auto-provisioned —"
|
|
@echo "load a legacy report via the UI's DEV report loader to exercise the map."
|
|
|
|
up: build-engine prune-broken-engines
|
|
$(COMPOSE) up -d --wait
|
|
|
|
rebuild: build-engine prune-broken-engines
|
|
$(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:
|
|
$(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). They intentionally
|
|
# survive `make down` so the runtime reconciler can reattach on the
|
|
# next `make up` — killing them out of band makes the runtime
|
|
# cascade the game to `cancelled`. We only remove them as part of
|
|
# `clean`, where the whole DB is wiped anyway.
|
|
stop-engines:
|
|
@ids=$$(docker ps -aq \
|
|
--filter "label=$(STACK_LABEL)" \
|
|
--filter "label=$(ENGINE_LABEL)"); \
|
|
if [ -n "$$ids" ]; then \
|
|
echo "stopping engine containers for $(STACK_LABEL)…"; \
|
|
docker rm -f $$ids >/dev/null; \
|
|
fi
|
|
|
|
# Remove engine containers Docker can no longer heal on its own.
|
|
# After a host reboot, the per-game bind-mount source under
|
|
# /tmp/galaxy-game-state/<uuid> may have been wiped (macOS clears
|
|
# /private/tmp on reboot), so `restart: unless-stopped` cannot
|
|
# revive the container — Docker refuses to start it with a missing
|
|
# bind-mount source and leaves it stuck in `exited` / `created`
|
|
# state. This target prunes the husks before `compose up`; the
|
|
# backend's pre-bootstrap reconciler tick (`backend/cmd/backend/main.go`)
|
|
# then cascades the orphan runtime row to `removed` and the lobby
|
|
# cancels the game. Healthy `running` / `restarting` containers are
|
|
# left intact so a long-lived game survives normal up/down cycles.
|
|
prune-broken-engines:
|
|
@ids=""; \
|
|
for cid in $$(docker ps -aq \
|
|
--filter "label=$(STACK_LABEL)" \
|
|
--filter "label=$(ENGINE_LABEL)" 2>/dev/null); do \
|
|
state=$$(docker inspect -f '{{.State.Status}}' $$cid 2>/dev/null); \
|
|
case "$$state" in \
|
|
running|restarting) ;; \
|
|
*) ids="$$ids $$cid";; \
|
|
esac; \
|
|
done; \
|
|
if [ -n "$$ids" ]; then \
|
|
echo "removing non-running engine containers (post-reboot cleanup):$$ids"; \
|
|
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
|