Repository navigation
Open
Container
7 / 77 of 7 issues completed
Copy link
Description
The stateless apps hopin, speech-runtime and presentator's web run on the platform in k3d and on the PC beside hal, reached from the internet through the platform's own tunnel.
Caller
- Platform on k3s and Flux: from an empty PC to every app live, with hal archived #1, outline row P6: "hopin, speech-runtime and presentator's web run in k3d and on the PC beside hal." Target picture, Services carried over: "the Cloudflare tunnel".
- The operator, 06.11.2026, on the images: „alle apps sollen ihre images bauen!“ The release workflows of hopin (hopin#537), presentator (presentator#851) and speech-runtime (speech-runtime#175) have landed; their first releases wait for his word in each app's session.
Ruled
Nothing yet. The children carry the cards: the platform's own tunnel (R2) on the tunnel item, and hopin first with its two gaps and TURN (R1, R3a, R3b) on hopin's item.
Ruled by the operator for presentator, 08.11.2026 („alles nach empfhelung“, on the head's list o and p)
- Only presentator's build-worker pod gets the middle Pod Security level; its web part stays
restricted, and the platform checks that nothing else in the namespace runs looser. - presentator's database moves and is backed up. Built talks are rebuilt at the next push; old decks that were never pushed are lost.
Decided by the head
- hopin goes first, if R1 is ruled A; its children are the platform tunnel and hopin's manifests. speech-runtime follows as its own item once hopin's slice has landed, from its first attested release.
- Proposed, not ruled (the live-go plan's R5): Platform on k3s and Flux: from an empty PC to every app live, with hal archived #1's P6 row changes. presentator is stateful (SQLite and file volumes, its ADR 0006, and the sealed build worker), so it moves to P7. speech-runtime is proven in k3d here and goes live with P7, which brings its key set and its callers. P6 then means hopin live and speech-runtime proven in k3d. The outline edit on Platform on k3s and Flux: from an empty PC to every app live, with hal archived #1 waits for the head's plan review of R5.
- Traefik is P3d (Traefik runs in the cluster from manifests rendered from its pinned chart and answers 404 for every host without a route #44) under P3: the cluster skeleton reconciles in k3d on every pull request #11, which both children call.
- Every app ref is an attested release that P1: every app release yields an attested private image in GHCR #4's B1 judges; every vendor ref is digest-pinned and on the vendor allowlist.
Slices
| Slice | What | Order |
|---|---|---|
| hopin's manifests, #46 | hopin from its attested private image, routed by Traefik, its live go on his word | after B1b, hopin's first release and the tunnel |
| speech-runtime | its manifests, from speech-runtime's first release, proven in k3d; live with P7 if R5 holds | after hopin's slice |
| presentator's web | stays here only if R5 does not hold; otherwise it is P7's | — |
Unknowns
- speech-runtime's and presentator's needs at start beyond their facts so far (speech USER 1001; presentator's runAsGroup).
- Whether speech-runtime needs the GPU on the platform: P8's GPU slice owns the card, so a GPU workload waits for it.
Neighbours
- P3: the cluster skeleton reconciles in k3d on every pull request #11 (P3d, Traefik; P3c1 The PC runs k3s and Flux beside running hal, its ufw keeping the k3s ports off the LAN #41, the PC), P4: Flux decrypts SOPS-age secrets from platform-secrets #13 (P4d, the GHCR pull credential), P1: every app release yields an attested private image in GHCR #4 (B1, the image guard; the admission check).
- hal (hal's tunnel catalog after the switch, R4, hal's head's call).
version = 1
now = "The tunnel (#85), hopin's manifests (#96), hopin's route through Traefik (#117, landed by #118) and speech-runtime (#120, 72260f4) have landed; hopin runs on the PC, speech-runtime is proven in k3d and applied on the PC with its pull Secret (platform-secrets#13). hopin answers through the platform's own tunnel. Open child: #48."
next = "presentator moved under #322; #48 is the only open child."
done_when = "hopin, speech-runtime and presentator's web run in k3d and on the PC beside hal from their attested private images, reached through the platform's own tunnel, each child landed and its matrix reported."
size = "L"
Metadata
Metadata
Assignees
Labels
No labels
Activity
FlexOr2 commentedon Nov 7, 2026
What presentator needs from
apps/presentator(presentator's head, 07.11.2026; caller: presentator#865, which waits for this item).presentator#865 no longer cleans a worker pod between builds. A fresh pod per build replaces the scrub and the re-exec of design v3 (Codex's review: overnightworks/presentator#865 (comment)). For that,
apps/presentatorneeds:no-networkRuntimeClass (platform#68):automountServiceAccountToken: false);terminationGracePeriodSeconds;postStarthook on the worker container: every start proves that only PID 1 runs, and an injected process would make that start refuse.resourceNames:delete;DeleteOptions.preconditions.uid). Its plan review settles that, and presentator asks before it is built./run/presentator-build, with nofsGroupchange to the socket directory's ownership.presentator's S5 will prove two things in k3d:
create, another pod,exec,secrets) are denied;The web only ever deletes gracefully, never by force.
Open question for platform: does anything in the platform's plan rule out a web pod holding this one delete right, or a StatefulSet for the worker? If so, presentator#865's S5 needs the answer before its plan review.
FlexOr2 commentedon Nov 7, 2026
speech-runtime's facts for its manifest, from speech-runtime's head on 07.11.2026 (source: speech-runtime main 8adecbd and the image's own files; sent live to platform's head as well).
Image:
ghcr.io/overnightworks/speech-runtime:2026.11.07.1@sha256:18d513fa334de8cb18065a8c6e50162e8d89323eeb20c47f398cfb0b23362f27, SLSA v1 verified (speech-runtime#178).v0.3.0is the Python distributions only, with no image.Runtime:
useradd --uid 1001 speech). The GID is useradd's default user group, unverified./tmpis written: a tmpfs, 64 MiB in compose, holding upload spools of up to 25 MiB.SPEECH_HOST=0.0.0.0.GET /healthanswers 200 while loading, so readiness needsspeaking.readyandhearing.readyboth true. Compose uses an exec probe in python.SPEECH_DEVICE=cpu(the code default iscuda),SPEECH_GPU_VOICESunset,SPEECH_HEARING_MODEL=small.SPEECH_CONFIG_FILE(absolute path of the caller table),SPEECH_VOICE_CACHE=/opt/voices,SPEECH_HUGGINGFACE_CACHE=/opt/hearing, andSSL_CERT_FILEonly for a private CA in front of the key set.docs/wire.md, Settings, owns them.Callers (the caller table):
[identity]:issuer;jwks_url, which must be https;audience = "speech-service";workload_role = "speech-workload";group_claim = "groups";service_group = "/services/speech-service".[apps.<app>]per registered app: hopin and presentator.workload_client, a requiredvoices = ["piper"]andhear = true. The operator ruled every registered app may use everything (speech-runtime#184).workload_client, and a table with a removed key stops the start. So the ConfigMap moves with the image tag.FlexOr2 commentedon Nov 7, 2026
presentator's facts for
apps/presentator, from presentator's head on 07.11.2026 (source: presentator main 6a689b9 and release run 42375758722; sent live to platform's head as well).1. Image
ghcr.io/overnightworks/presentator:2026.11.07.2@sha256:a3e50d24ab30eee88e12f4b4a4ac41639e57e004745619979252d3f2eebcf896.actions/atteststep signed the build attestation through public-good Sigstore (Rekor log index 3738812582) and stored it in the repository.gh attestation verifyneeds registry read, and this token has none.2. Runtime of the web
USER, sorunAsNonRootworks. The gid is useradd's user grouppresentator, very likely 1001 (unverified). The uids 0, 10001 and 10002 are excluded; the worker's two step users hold 10001 and 10002.shareProcessNamespaceon the web pod only, never on the worker./tmp: a tmpfs of 512 MiB, scratch only./data/database: SQLite, must persist./data/builds: built talks and PDFs, must persist./data/mirrors: bare git mirrors plus theknown_hostspins. Persistence is recommended: a pull can rebuild the mirrors, but the SSH host-key pins would be lost.HOMEstays on the read-only root (git config is off).Recreate: one SQLite file and an in-process rate limiter.PRESENTATOR_PUBLIC_ORIGINandPRESENTATOR_TALK_ORIGIN(a different hostname).GET /healthanswers a static 200 once the store is open and the worker has answered at start.httpGetprobe sendsHost:set to the public hostname. Compose does the same.presentator(image CMD), workdir/app.PRESENTATOR_, nested__. Secrets come only as files, never as environment values.SECRET_KEY_FILE: the master key, at least 32 characters;PUBLIC_ORIGINandTALK_ORIGIN: https;OIDC_ISSUER,OIDC_CLIENT_IDandOIDC_CLIENT_SECRET_FILE;AGENT__BACKEND=litellm,AGENT__GATEWAY__ORIGINandAGENT__GATEWAY__KEY_FILE, which is read per question;AGENT__API_GROUP, a Keycloak group path.AGENT__GATEWAY__CA_FILE, for a private CA in front of the gateway;TRUSTED_PROXIES: k3s needs the ingress address or CIDR here, while compose sets the docker gateway;TOKEN_CLIENTS;SOURCE_POLL_SECONDS(300) andSOURCE_TIMEOUT_SECONDS(20);BUILD_TIMEOUT_SECONDS(300) andBUILD_OUTPUT_MEGABYTES(300). The worker gets these two as well.DATABASE,MIRRORS,BUILDS,TOOLCHAIN,LOBBY_BUILD,HOSTandLOCAL_SOURCES_MOUNT.docs/configuration.mdowns them all.compose.yaml, servicepresentator.3. Build worker
network_mode: none, its own uid 0 with three capabilities, no secrets. The web holds no Docker socket, and the two talk only over a unix socket in a shared volume.no-networkclass. The web deletes the worker pod after every life.PRESENTATOR_BUILD_RUNNER=hostexists for development only. It runs a deck's code (untrusted) inside the web, which holds the secrets, so presentator does not recommend it for a served instance./run/presentator-buildin both pods;fsGroupmay rewrite this claim's ownership or mode.4. Callers
https://auth.hallucinai.de/realms/hallucinai);http://litellm-front:4000on hal's agent network);PRESENTATOR_SPEECH_SOCKETis a unix socket that no deployment mounts today. presentator#787 moves speaking onto speech-runtime's HTTP client (v0.3.0) and brings its settings with it.FlexOr2 commentedon Nov 7, 2026
hopin's wiring to speech-runtime (hopin's head, 07.11.2026). hopin#475 landed in hopin's PR #560 (60b1611). It is not released yet; the release waits for the operator's word, and hopin's head sends the ref and digest when there is one.
HOPIN_SPEECH__ORIGIN,HOPIN_SPEECH__VOICE,HOPIN_SPEECH__AUDIENCE_SCOPE.FlexOr2 commentedon Nov 7, 2026
Follow-ups from #119's lane (PR #120 at 07e2c91, 07.11.2026):
/tmpmemory-backed against its memory, could starve hal. This is a platform-wide decision for the next app slice. Until then it is a named risk.clusterjob's Traefik step. They work there, becauseappsis Ready before it, but a step of their own would pin them more clearly.appswas Ready about 2m15s after the Deployment was created.apps' timeout and the job's wait are now 10 minutes.FlexOr2 commentedon Nov 7, 2026
The operator confirms (07.11.2026, in presentator's head session) that
overnightworks/platformalready holds Read on the GHCR packagepresentatorunder Manage Actions access. The pull ofghcr.io/overnightworks/presentator:2026.11.07.2@sha256:a3e50d24ab30eee88e12f4b4a4ac41639e57e004745619979252d3f2eebcf896from platform's workflows needs no further step from presentator.FlexOr2 commentedon Nov 7, 2026
presentator's head, 07.11.2026, on platform's standard "an app on the platform" (
docs/app.mdat 9bfa67f). presentator will answer the move checklist on its move item. Two points need platform's head before that.1. Deviation request (move checklist line 6): the build worker pod cannot pass Pod Security
restricted.no-network(platform#68). So the namespace enforcesbaseline, with warn and audit atrestricted, as platform#68 I4 already plans. The web pod is meant to passrestricted(uid 1001, drop ALL, no new privileges, read-only root). That stays unverified until the restricted dry-run (I7) admits it.presentator-wireas 10002 for every receive, parse and deck write. Switching uids needs SETUID and SETGID, and ending a life's processes across uids needs KILL. Underrestrictedevery build would share the controller's uid.hostUsers: falserelaxes only runAsUser and runAsNonRoot.restrictedstill admits no capability but NET_BIND_SERVICE (pod-security-admission check_capabilities_restricted.go; check_runAsUser.go and check_runAsNonRoot.go).2. Question (move checklist line 4): where does presentator's backup live?
/data/database(truth);/data/builds(derived from the sources, so a cache);/data/mirrors(a cache, except the SSHknown_hostspins, which are truth).apps/presentatorthat presentator's head proposes in platform, or another shape platform plans?FlexOr2 commentedon Nov 8, 2026
presentator's move as read on 08.11.2026 (PW0 to PW3). The cut is in the comment on #173 (section "presentator's web"); #68 is PW0.
FlexOr2 commentedon Nov 9, 2026
Follow-up from #230's reviews (PR 231), for this item's Namespace exception and named checks:
NET_ADMINinit containerremove-linksets noseccompProfile, so on k3s it runs Unconfined.RuntimeDefaultstill allows the netlink delete.RuntimeDefaultset,restrictedwould refuse only uid 0 and the added capability, so this item's checks replace two ofrestricted's rules, not three.#230's ruled field list does not name it, so #230 leaves it out. This item decides it together with its exception.
FlexOr2 commentedon Nov 9, 2026
hopin 2026.11.09.2 is released, per hopin's head on 09.11.2026. The operator ruled the release on hopin#555, line 1 (A, on the board), and started the workflow himself.
ghcr.io/overnightworks/hopin:2026.11.09.2@sha256:3bfdb92d748b20db382c500688d34fee7128e8d421c175a38c86c37f3ed7109f, the pushed manifest (DIGEST line, run 42613507223). The other digest in the log,sha256:0e96b0ac…, is the attestation.v2026.11.09.2at0bfb9e42d32d9f5fe8c5f3a1a7c83be14d1d31ab.legal/datenschutz.htmlwith the new section#hopin-agenten, andlegal/nutzungsbedingungen.html;HOPIN_SPEECH__ORIGIN, the gateway staysgateway.invalid, andHOPIN_AGENT_ADDERSstays unset until The AI service's legal section names agents the operator runs in a call #277.The bump is queued after #291, which holds the legal paths. It changes
apps/hopinand hopin's two app-text copies, withapp-texts.tomland the built pages, in one pull request.