Files
map-asset-gateway/scripts/service.bat
T
Harmon 73ad03fa59 Rewrite the gateway around health, retries, slicing and a Windows service
Scanner
- manifest lookup is now depth-bounded and prunes numeric zoom directories, so
  a scan no longer walks the whole tile payload
- rescans only report a version as updated when something actually changed
- overlapping runs are refused instead of interleaving their bookkeeping

Hot path
- token authorisation loads only that token grants and throttles the
  last_used_at write instead of touching it on every tile
- SQLite runs in WAL with a busy timeout and a real connection pool
- the catalog lookup used by /tiles no longer loads every basemap

Security
- the admin surface requires ADMIN_TOKEN (bearer) or ADMIN_USER/ADMIN_PASSWORD
  (basic), and the service refuses to bind off-host without credentials
- CORS is an explicit allow-list; newly minted tokens never reach a redirect URL
- client tokens are redacted from the access log

Operations
- resource health inspection flags a moved or deleted tile root before a 404
- pushes retry with backoff and can be re-queued by hand; the schedule lives in
  the database so a restart does not lose it
- access log plus /metrics counters

Image slicing
- tile_jobs drive the GDAL bundled with QGIS via scripts/gdal2tiles-qgis.bat
- layer_sources remembers what a layer is made of: submit one source to append
  a flight, or all of them to rebuild the layer as a VRT mosaic with no tile
  seams; the console exposes both, including a one-click rebuild
- slicing is available to integrations through a narrow slice token scope
  (submit, poll, idempotent by code, completion callback)

Console
- rebuilt around a fixed rail and single-view navigation with health and
  outstanding work leading, instead of one long scrolling page

Windows service
- native install/start/stop/status with crash recovery, auto-start and a
  rotating log file, so no NSSM wrapper is needed
- start-all.bat and stop-all.bat are removed: they killed the process by port
  with taskkill, which fought the service restart policy

Verified with 49 tests and live runs against real tile data and real GDAL.
2026-10-16 10:35:30 +08:00

68 lines
1.3 KiB
Batchfile

@echo off
setlocal
chcp 65001 >nul 2>&1
title Basemap Pusher Service
set "ROOT=%~dp0..\"
pushd "%ROOT%" >nul 2>&1
set "ROOT=%CD%\"
popd
set "EXE=%ROOT%bin\basemap-pusher.exe"
set "ENVFILE=%ROOT%config\service.env"
if not exist "%EXE%" (
echo Service binary not found: %EXE%
echo Build it first: scripts\build-api.bat
if "%NO_PAUSE%"=="" pause
exit /b 1
)
set "VERB=%~1"
if "%VERB%"=="" set "VERB=status"
if /i "%VERB%"=="install" goto do_install
if /i "%VERB%"=="uninstall" goto do_uninstall
if /i "%VERB%"=="start" goto do_start
if /i "%VERB%"=="stop" goto do_stop
if /i "%VERB%"=="restart" goto do_restart
if /i "%VERB%"=="status" goto do_status
echo Usage: service.bat ^<install^|uninstall^|start^|stop^|restart^|status^>
exit /b 2
:do_install
"%EXE%" --env-file "%ENVFILE%" install
goto finish
:do_uninstall
"%EXE%" uninstall
goto finish
:do_start
"%EXE%" start
goto finish
:do_stop
"%EXE%" stop
goto finish
:do_restart
"%EXE%" stop
"%EXE%" start
goto finish
:do_status
"%EXE%" status
goto finish
:finish
set "RC=%ERRORLEVEL%"
if not "%RC%"=="0" (
echo.
echo [FAIL] exit code %RC%.
echo install / uninstall / start / stop need an elevated shell ^(Run as Administrator^).
)
if "%NO_PAUSE%"=="" pause
exit /b %RC%