Ilia Denisov
a9087691a3
Five connected cleanups across the dev/CI infrastructure:
1. Drop tools/local-ci/. The standalone Gitea + act_runner stack was
the legacy "offline workflow validator"; the per-stage CI gate now
runs on gitea.lan and the directory was only retained as a
fallback. Removing it leaves no operational dependency: backend,
gateway, and game code have no references; documentation that
pointed at it (CLAUDE.md, docs/ARCHITECTURE.md, ui/docs/testing.md,
tools/dev-deploy/README.md, tools/local-dev/README.md) is updated
in this same change. Historical "Verified on local-ci run N"
markers in ui/PLAN.md are preserved unchanged.
2. Lift the pre-production single-migration rule. The rule forced
every schema delta into 00001_init.sql and required a manual
make clean-data wipe on every backward-incompatible change in
tools/dev-deploy/. Future schema deltas now land as additive
sequence-numbered files (00002_*.sql, …) that goose applies
automatically on backend startup; 00001_init.sql becomes an
immutable baseline. Authoring conventions live in
backend/internal/postgres/migrations/README.md. The chain may be
squashed back into a fresh 00001 as a deliberate one-time
operation before the first production deployment.
3. Document the deployment cadence. The dev environment is
single-tenant: pushes to feature/* run the test workflows
(go-unit, ui-test, integration) only; dev-deploy.yaml fires on
push to development. A workflow_dispatch override on
dev-deploy.yaml lets a developer preview a feature branch on the
shared dev environment before merge; the next merge into
development overwrites the manual deploy idempotently.
4. Scope compose-managed resources by an explicit
galaxy.stack=<local-dev|dev-deploy> label. Both compose files
stamp the label on every service, network, and named volume.
Makefiles in tools/local-dev/ and tools/dev-deploy/ filter their
engine-cleanup operations by (stack-label AND engine OCI title)
so they never touch unrelated workloads on the same daemon.
dev-deploy.yaml gains a pre-`compose up` step that reaps stale
exited/dead containers under the dev-deploy stack label.
5. Backend now stamps the same galaxy.stack=<value> label on every
engine container it spawns, sourced from a new BACKEND_STACK_LABEL
env var (empty → label not applied; legacy-safe). Both compose
files set it to their stack name (local-dev / dev-deploy). The
contract is recorded in docs/ARCHITECTURE.md under
"Container labels". A package-level test in
backend/internal/runtime exercises both the label-present and
label-absent paths.
No tests intentionally regressed: go test ./backend/internal/{config,
runtime,dockerclient} is green, both compose files validate cleanly,
and the backend, gateway, and game modules all build.
Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
110 lines
4.3 KiB
Makefile
110 lines
4.3 KiB
Makefile
.PHONY: help up down rebuild logs status clean-data health psql build-engine seed-ui
|
|
|
|
.DEFAULT_GOAL := help
|
|
|
|
REPO_ROOT := $(realpath $(CURDIR)/../..)
|
|
ENGINE_IMAGE := galaxy-engine:dev
|
|
STACK_LABEL := galaxy.stack=dev-deploy
|
|
ENGINE_LABEL := org.opencontainers.image.title=galaxy-game-engine
|
|
# Game-state root lives under the invoking user's home by default so
|
|
# `make up` works without sudo. Override `GALAXY_DEV_GAME_STATE_DIR`
|
|
# in the environment or `.env` to relocate (e.g. /var/lib/galaxy-dev/
|
|
# game-state in a production-shaped host). The value flows through to
|
|
# both the compose bind-mount and the backend's
|
|
# `BACKEND_GAME_STATE_ROOT`.
|
|
export GALAXY_DEV_GAME_STATE_DIR ?= $(HOME)/.galaxy-dev/game-state
|
|
|
|
COMPOSE := docker compose
|
|
|
|
help:
|
|
@echo "Long-lived Galaxy dev environment (https://*.galaxy.lan):"
|
|
@echo " make up Build images, ensure engine image, bring stack up"
|
|
@echo " make rebuild Force rebuild of backend / gateway images and bring up"
|
|
@echo " make build-engine Build $(ENGINE_IMAGE) from game/Dockerfile (no-op if present)"
|
|
@echo " make seed-ui Build ui/frontend and load into galaxy-dev-ui-dist volume"
|
|
@echo " make down Stop containers, keep named volumes"
|
|
@echo " make logs Tail all logs"
|
|
@echo " make status docker compose ps"
|
|
@echo " make health Probe the stack through the host Caddy"
|
|
@echo " make psql Open a psql shell as galaxy@galaxy_backend"
|
|
@echo " make clean-data Stop everything and wipe named volumes + game-state"
|
|
@echo ""
|
|
@echo "Requires:"
|
|
@echo " - external Docker network '$${GALAXY_EDGE_NETWORK:-edge}'"
|
|
@echo " (docker network create edge)"
|
|
@echo " - host Caddy proxying *.galaxy.lan into that network"
|
|
@echo " - game-state dir: $(GALAXY_DEV_GAME_STATE_DIR) (auto-created)"
|
|
|
|
up: build-engine
|
|
mkdir -p "$(GALAXY_DEV_GAME_STATE_DIR)"
|
|
$(COMPOSE) up -d --wait
|
|
|
|
rebuild: build-engine
|
|
$(COMPOSE) build --no-cache galaxy-backend galaxy-api
|
|
mkdir -p "$(GALAXY_DEV_GAME_STATE_DIR)"
|
|
$(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
|
|
|
|
# Build the UI frontend and load the resulting build/ directory into
|
|
# the named volume Caddy serves from. Used by the dev-deploy workflow
|
|
# and by anyone bringing the stack up by hand.
|
|
seed-ui:
|
|
@if [ ! -d $(REPO_ROOT)/ui/frontend/node_modules ]; then \
|
|
echo "installing UI dependencies…"; \
|
|
(cd $(REPO_ROOT)/ui && pnpm install --frozen-lockfile); \
|
|
fi
|
|
@echo "building UI (vite build)…"
|
|
(cd $(REPO_ROOT)/ui/frontend && \
|
|
VITE_GATEWAY_BASE_URL=https://api.galaxy.lan \
|
|
VITE_GALAXY_DEV_AFFORDANCES=true \
|
|
VITE_GATEWAY_RESPONSE_PUBLIC_KEY=$$(cat $(REPO_ROOT)/ui/frontend/.env.development \
|
|
| sed -n 's/^VITE_GATEWAY_RESPONSE_PUBLIC_KEY=//p') \
|
|
pnpm build)
|
|
@echo "loading build/ into galaxy-dev-ui-dist volume…"
|
|
docker volume create galaxy-dev-ui-dist >/dev/null
|
|
docker run --rm \
|
|
-v galaxy-dev-ui-dist:/dst \
|
|
-v $(REPO_ROOT)/ui/frontend/build:/src:ro \
|
|
alpine sh -c 'rm -rf /dst/* /dst/.??* 2>/dev/null; cp -a /src/. /dst/'
|
|
|
|
down:
|
|
$(COMPOSE) down
|
|
|
|
logs:
|
|
$(COMPOSE) logs -f --tail=100
|
|
|
|
status:
|
|
$(COMPOSE) ps
|
|
|
|
health:
|
|
@echo "Frontend (https://www.galaxy.lan):"
|
|
@curl -sS -o /dev/null -w " HTTP %{http_code}\n" https://www.galaxy.lan/ || echo " unreachable"
|
|
@echo "API healthz (https://api.galaxy.lan/healthz):"
|
|
@curl -sS -o /dev/null -w " HTTP %{http_code}\n" https://api.galaxy.lan/healthz || echo " unreachable"
|
|
|
|
psql:
|
|
$(COMPOSE) exec galaxy-postgres psql -U galaxy -d galaxy_backend
|
|
|
|
clean-data:
|
|
@echo "Stopping containers and engines, then wiping volumes + game-state…"
|
|
$(COMPOSE) down -v
|
|
@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
|
|
@if [ -d "$(GALAXY_DEV_GAME_STATE_DIR)" ]; then \
|
|
echo "wiping $(GALAXY_DEV_GAME_STATE_DIR)…"; \
|
|
docker run --rm -v "$(GALAXY_DEV_GAME_STATE_DIR):/state" alpine sh -c 'rm -rf /state/*' 2>/dev/null \
|
|
|| rm -rf "$(GALAXY_DEV_GAME_STATE_DIR)"/* 2>/dev/null || true; \
|
|
fi
|