Ilia Denisov
82c4f70156
Backend's runtime spawns the engine container outside the compose project, so `docker compose down` left a `galaxy-game-…` container running. Add a `stop-engines` target that finds them by their OCI image-title label (set in game/Dockerfile) and remove forcibly; make `down` and `clean` depend on it. `clean` additionally wipes the per-game state directory under /tmp/galaxy-game-state. Add a troubleshooting note for the related symptom: when the browser holds a keypair from a previous DB and `make clean` recreates everything, the lobby renders "no games yet" until the user clears site data or opens an incognito window. The dev user keeps the same email but receives a fresh user_id, which the old keypair cannot authenticate against. Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
88 lines
3.2 KiB
Makefile
88 lines
3.2 KiB
Makefile
.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
|