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>
This commit is contained in:
2026-11-12 22:07:24 -05:00
co-authored by Claude Opus 5.5
parent 05c7568ec1
commit 8eb6e587fb
17 changed files with 644 additions and 2 deletions
+34
View File
@@ -0,0 +1,34 @@
# Tidewall dedicated server configuration. Read with --config=PATH; each line is one
# of the server's command-line options without the leading dashes (see
# src/server/server_config.gd for all of them). Options given on the command line
# after --config win over these.
# Take players over the network. Without this the server plays a bot-only match.
listen
# UDP port players connect to. LAN discovery answers on this port plus one.
port = 24650
# Fill each match's empty places with bots (any number above 0 turns it on).
bots = 1
# bot-difficulty = mixed
# The name shown in server browsers.
name = Tidewall server
# Register with a list server so people outside the LAN can find this one.
# list = lists.example.org:24660
# Don't answer LAN discovery broadcasts.
# no-lan
# Answer GET /health on this TCP port, on loopback unless health-bind says otherwise.
health-port = 24650
# health-bind = 127.0.0.1
# A progress line in the log every this many ticks (30 a second). 0 for none.
log-every = 9000
# A fixed seed makes every match on the island sequence repeatable. Leave it out for a
# fresh one each start.
# seed = 12345