Files
tidewall/Makefile
T
claudeandClaude Opus 5.5 8eb6e587fb N7: Dedicated server packaging, health endpoint and graceful shutdown
- packaging/server/tidewall-server: a wrapper that turns SIGTERM and SIGINT
  into a clean stop through the server's new --stop-file, since the engine
  can't catch signals. The server tells everyone it shut down, logs its
  statistics and exits 0; the wrapper kills it only after 15 s.
- --config=PATH reads options from a file (packaging/server/server.cfg);
  options after it on the command line win.
- --health-port answers GET /health with JSON (phase, players, tick, uptime)
  on loopback by default. HealthServer is non-blocking and bounded.
- packaging/docker: a debian:13 image that checks the engine against
  tools/engine.sha512, imports the game at build time, runs as an unprivileged
  user, and works with a read-only root and a small /tmp. compose.yaml is
  project and container tidewall-server, read-only, no capabilities.
- packaging/systemd: a hardened unit with a dynamic user.
- make server-package-check: compose up, healthy, non-root, read-only, a real
  headless client joins over UDP into the drop, then SIGTERM stops it cleanly.

This also covers H7 (graceful shutdown on SIGTERM).

Closes #38
Closes #70

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-12 22:07:24 -05:00

90 lines
3.3 KiB
Makefile

# Tidewall build entry points. Everything runs headless with the repo-local engine.
GODOT := tools/godot.sh
.PHONY: check import parse test test-selfcheck smoke capture-test terrain-capture binaries verify-engine bot-matches match match-captures client-check client-captures discovery-check fuzz soak soak-selfcheck server-package-check
## Everything that must pass before a push.
check: verify-engine binaries parse test test-selfcheck smoke
verify-engine:
@$(GODOT) --verify
binaries:
@tools/check_binaries.sh
## Refreshes Godot's global class cache, so class_name lookups resolve.
import:
@$(GODOT) --import --quit >/dev/null 2>&1 || true
parse: import
@$(GODOT) --script res://tools/parse_all.gd
test: import
@tools/run_tests.sh
## Proves the test runner detects each kind of failure.
test-selfcheck: import
@tools/test_selfcheck.sh
## Boots the headless server for 1,000 ticks and checks exit codes, logs and timing.
smoke: import
@tools/smoke.sh
## Plays 20 bot-only matches and checks each has a winner, few bots drown and easy
## bots do worst. Takes about ten minutes, so it isn't part of `check`.
## BOT_MATCH_SEEDS and BOT_MATCH_FIRST change how many seeds and where they start.
bot-matches: import
@tools/bot_matches.sh
## Plays one whole offline match, lobby to results, with a scripted player and 23 bots,
## then replays its command log and checks the replay ends in the same state.
## MATCH_SEED picks the seed.
match: import
@tools/match.sh
## Renders each stage of the match `make match` last played. Needs Docker.
match-captures: import
@tools/match_captures.sh
## Joins a real client process to a real server process over loopback UDP and checks
## it gets from the lobby into the match. About a minute, in real time.
client-check: import
@tools/client_check.sh
## Feeds FUZZ_MESSAGES (default 1,000,000) malformed messages to every network parser.
FUZZ_MESSAGES ?= 1000000
FUZZ_SEED ?= 1
fuzz: import
@nice -n 15 $(GODOT) --script res://tools/fuzz_parsers.gd -- --messages=$(FUZZ_MESSAGES) --seed=$(FUZZ_SEED)
## Finds a real game server on the LAN (over loopback) and through a real list server.
discovery-check: import
@tools/discovery_check.sh
## Renders what a network client sees on the barge, gliding and landed. Needs Docker.
client-captures: import
@for stage in barge glide landed; do tools/capture.sh client_$$stage captures/client_$$stage.png; done
## Renders the capture test scenes in the offscreen container. Needs Docker.
capture-test: import
@tools/capture_selfcheck.sh
## Renders the terrain crack check and its control in the offscreen container. Needs Docker.
terrain-capture: import
@tools/terrain_capture_check.sh
## The 24-client network soak: a real server and 24 headless clients behind a relay that
## adds latency, jitter and loss, for SOAK_MATCHES (default 2) whole matches in real
## time, about half an hour. Checks for desyncs, errors, leaks and the tick budget.
soak: import
@tools/soak.sh
## About a minute: proves the soak catches a client whose world has drifted.
soak-selfcheck: import
@SOAK_SELFCHECK=1 tools/soak.sh
## Builds the server image with packaging/docker/compose.yaml, starts it, joins it with a
## headless client and stops it with SIGTERM. Needs Docker. About a minute and a half.
server-package-check: import
@tools/server_package_check.sh