docs(wiki): document scripts/booth.sh in container-deployment
Add a "Booth operator wrapper" section (commands, the update flow, env handling, the volume/ledger safety notes) + a log entry. Claude-Session: https://claude.ai/code/session_01Xcm6ikLgGoCxxHrxtjkk5V
This commit is contained in:
+15
@@ -1606,3 +1606,18 @@ the exact rendered bytes; probe present/absent; `transportFromConfig` TCP back-c
|
||||
green (29). **Flagged open-questions #14**: confirm the on-site printer is USB and bake the
|
||||
**usblp + udev write-access** rule into the appliance image (provisioning, not app code; unverified on
|
||||
hardware). See [[printer-usb-transport]], [[rongta-printer]].
|
||||
|
||||
## [2026-06-24] build | Booth operator wrapper script — scripts/booth.sh
|
||||
The booth PC (Ubuntu) needs one command instead of the long
|
||||
`docker compose -f docker-compose.yml -f docker-compose.prod.yml --env-file .env …` line over the
|
||||
three compose files. Added **`scripts/booth.sh`** (+ root **`.env.example`**): **prod by default**
|
||||
(`ENV=dev` for the dev override); subcommands `up`/`down`/`restart`/`status`/`logs`/`pull`/`config`/
|
||||
`exec`, and the requested **`update`** = `compose pull` the moving branch tag → `up -d --remove-orphans`
|
||||
(recreates only digest-changed services, **named volumes/SQLite ledger preserved**) → `docker image
|
||||
prune -f`. Prod **refuses to run without `.env`** (no safe `JWT_SECRET` default); dev with no `.env`
|
||||
injects the documented benign local secret (the base file makes `JWT_SECRET` shell-required via
|
||||
`${JWT_SECRET:?}`, which the dev override's service-level default alone can't satisfy). `down` never
|
||||
passes `-v` (would wipe the signed [[append-only-event-chain|ledger]] volume); `help`/unknown-command
|
||||
short-circuit before any Docker/.env requirement. Verified: prod `config` renders Caddy:80 + internal
|
||||
server + pinned images + `fast_alpr`; dev `config` renders `:dev` images + `stub` + published ports.
|
||||
Documented in [[container-deployment]] ("Booth operator wrapper").
|
||||
|
||||
Reference in New Issue
Block a user