Repository navigation
Description
hopin's Deployment and Service run from its attested private GHCR ref in the namespace hopin, pulled through the Secret ghcr-pull and started from the Secret hopin's files, applied by the Kustomization apps after platform-secrets, and proven in the job cluster on pull requests and on main. No route and no trusted proxy yet: those are S5b's.
Caller
- hopin runs on the platform from its attested private image, routed by Traefik #46, decision 11's S5a, the first of its two pull requests ("S5a, hopin runs: decisions 1, 2, 4 to 7, and 3 without
HOPIN_TRUSTED_PROXIES"). S5b, the route, the NetworkPolicy andHOPIN_TRUSTED_PROXIES, stays on hopin runs on the platform from its attested private image, routed by Traefik #46 and lands after this slice and The platform's own Cloudflare tunnel runs cloudflared in k3s in front of Traefik #45's S4b.
Ruled
Copied verbatim; each bullet names its own source.
- From hopin runs on the platform from its attested private image, routed by Traefik #46's section Ruled (as of 07.11.2026), whose sources each bullet names (Q6, Q8 and Q9: Platform on k3s and Flux: from an empty PC to every app live, with hal archived #1 (comment)):
- Platform on k3s and Flux: from an empty PC to every app live, with hal archived #1, invariant 1, line A (the operator, 06.11.2026): „A => einfach sagen wenn soweit ist! …“. Card R1 below is ruled other (06.11.2026), and Platform on k3s and Flux: from an empty PC to every app live, with hal archived #1's invariant 1 now says that apps go live one by one, as a test, hopin first, without waiting for the cutover; that replaces "live stays on hal until the cutover". P3: the cluster skeleton reconciles in k3d on every pull request #11's invariants carry the live build: host cells run on the PC beside running hal.
- Q6 on P4: Flux decrypts SOPS-age secrets from platform-secrets #13 (the operator, 06.11.2026, „ja passt alles!“): his own classic PAT with only
read:packagesand an expiry is the pull credential on the PC. - Q8 and Q9 (same comment): the image pin changes only through a pull request he merges, and
apps/is the layout. - The bump path (the operator, 06.11.2026, on P1: every app release yields an attested private image in GHCR #4): the release's last job opens the bump pull request through the organisation's GitHub App, and Dependabot's docker ecosystem is not used for app images. This item's Deployment
image:field is what that pull request edits. - Only a
v*tag goes live (hal ruling of 16.10.2026, as P1: every app release yields an attested private image in GHCR #4 records it).
- From Platform on k3s and Flux: from an empty PC to every app live, with hal archived #1's invariant 1, its last bullet (as of 07.11.2026): Apps go live one by one, as a test. Each app moves its traffic to the platform as soon as its slices are ready, hopin first, without waiting for the cutover: the apps have no users yet. This replaces “live stays on hal until the cutover” in the ruled card below. The operator, 06.11.2026, on hopin runs on the platform from its attested private image, routed by Traefik #46's first card: „3b) all zusammen oder von mir aus erst hopin für den test“; „warum nich alle? es tut nicht weh die apps haben keine user! also was ist los? sind die apps vorbereite? einfach fucking test go und wir sehen ob alle apss gehen oder nicht?“
- R1, hopin runs on the platform from its attested private image, routed by Traefik #46's expectation line 1 (hopin first), ruled other on 2026-11-06 via chat,
card_hashsha256:8960adee1aae9c2db3bcff298eaf0f4c182df2425071e5cf52bfd5d1bd4aacbc, the operator's words: „3b) all zusammen oder von mir aus erst hopin für den test“; „warum nich alle? es tut nicht weh die apps haben keine user! also was ist los? sind die apps vorbereite? einfach fucking test go und wir sehen ob alle apss gehen oder nicht?“ (06.11.2026) - R3a, hopin runs on the platform from its attested private image, routed by Traefik #46's expectation line 2 (the two named gaps), ruled A on 2026-11-06 via chat,
card_hashsha256:e93e9404b19136bc98374686d76b21ca469c556e9f9f56b74944ac152b62c680, its contract: hopin goes live on the platform with two named gaps until P7. The public sign-in works, since hopin reaches Keycloak over the internet. Keycloak's back-channel logout cannot reach the platform's hopin (Keycloak calls it only on hal_backchannel_hopin, and the zone blocks the path publicly), so a Keycloak sign-out or a removal from /apps/hopin ends a platform session only at its 12-hour lifetime. The quiz game master reads unavailable (HOPIN_AGENT__GATEWAY__ORIGIN: http://gateway.invalid, nolitellm_keyfile), which the live go's drive observes. No host port, NodePort, hostNetwork or bridge to hal's Keycloak or LiteLLM is built. P7 closes both gaps; the gaps are named on Platform on k3s and Flux: from an empty PC to every app live, with hal archived #1's P6 and P7 rows. - R3b, hopin runs on the platform from its attested private image, routed by Traefik #46's expectation line 3 (TURN stays on), ruled A on 2026-11-06 via chat,
card_hashsha256:26a1093ff7a42bb61d9431e23af34e4557664258e6acd8fc5e41c343e21bea86, its contract:HOPIN_TURN_PROVIDER: cloudflarewithHOPIN_TURN_KEY_ID_FILEandHOPIN_TURN_API_TOKEN_FILEunder /run/secrets; the operator copies hal's two TURN values into the Secret hopin in platform-secrets (O5). hal's copy leaves with hal (P11).
Decisions
#46's decisions 1 (without the Ingress and the NetworkPolicy), 2, 3 without HOPIN_TRUSTED_PROXIES, 4 to 7 and 12 hold for this slice. They live on #46 and are not copied here. Decision 6's ref is hopin's first attested release, ghcr.io/overnightworks/hopin:2026.11.06.2@sha256:aaa309151f36d714fe49d8a285f85c4942b4e145e0befd32472167978c496ae6 (#46's journal, 06.11.2026); the builder re-reads it.
Done when
Copied verbatim from #46's Done when: the lines this slice holds. S8's route half and its card clause are S5b's and #46's: this slice's AGENTS.md lines are the Layout line for apps/hopin/ and the cluster line on the private pull.
- S1 Flux reconciles the Kustomization
appsafterplatform-secrets, withwait: trueand atimeout. Aplatform-secretsthat is not Ready holdsappsback with Flux's dependency reason. - S2 In the job, hopin's Deployment pulls its attested ref through the Secret
ghcr-pull, which the job made from its own token, and becomes Available with one Ready pod. The namespace enforcesrestrictedand carries the prune annotation. The container'simageIDrelates to the pinned digest as P3d's E4 established. Withoutghcr-pullthe pull fails. - S3 (S5a) hopin starts from the Secret
hopin's files under/run/secretswith no LiteLLM key and no trusted proxy. A missing session secret stops the start, naming the setting and no value, andclusterturns red. - S8
AGENTS.mdnamesapps/and the route,quality hygiene .printshygiene: clean, and the cards R1, R3a and R3b are ruled. - S9 Reverting S5a's workload while its Secrets stay keeps the Namespace
hopin, andplatform-secretsstays Ready (H15).
Scenario matrix
Copied verbatim from #46's matrix: the rows this slice drives. At this slice's landing, H14 reads H1 to H3; H8 to H11 are S5b's. This slice's driven cells are H4, H5, H6 and H15.
Material risk (secrets in the pod, a private pull credential, the client-address trust): the first review drives the matrix, then the cross-provider gate. Driven cells run on scratch pull requests of the lane, closed after with their branches deleted. Host cells run on the PC beside running hal, under #1's invariant 1.
| Cell | What is driven | Expected observable | Proven by |
|---|---|---|---|
| H1 | S1 and S2, pull request | apps Ready after platform-secrets; hopin Available with one Ready pod, strategy Recreate |
CI |
| H2 | S2, pull request | the Deployment's ref is one string; images (B1) is green on it |
CI |
| H3 | S2, pull request | the container's imageID against the pinned digest, by the relationship P3d's E4 found |
CI |
| H4 | S3, scratch: the job's artifact without session_secret |
the pod is not Ready; its log names session_secret_file and no value; apps and cluster red |
driven |
| H5 | S2, scratch: the artifact without ghcr-pull |
the pull fails with the registry's refusal (the package is private); apps red |
driven |
| H6 | S1, scratch: the artifact's encryption broken | platform-secrets not Ready; apps reports its dependency not ready |
driven |
| H7 | S2 and S3, the diff | the security context without runAsUser, /tmp, the Secret mount, the probe, the settings (the gateway origin and its comment, no trusted proxy in S5a), no litellm_key, imagePullSecrets, the Namespace's two markers |
diff review |
| H14 | S1 to S6, push to main | cluster green with H1 to H3 and H8 to H11's observables |
CI, read at landing |
| H15 | S9, scratch, in one job run: the tree with S5a reconciled, then the GitRepository moved to a commit that reverts S5a's manifests (the Deployment, the Service, apps and the Namespace hopin) while the job's artifact keeps the Secrets hopin and ghcr-pull; then the same once more with the Namespace's prune annotation removed and #45's annotation guard skipped |
first: hopin's Deployment gone, the Namespace hopin and its Secrets still there, namespaces and platform-secrets Ready at the new revision; then the control: the Namespace deleted, and platform-secrets not Ready naming the missing namespace |
driven |
Files
As #46's Files and Size name them for S5a, about 150 lines in five files:
apps/hopin/hopin.yaml(new): the Deployment and the Service.clusters/pc/apps.yaml(new): the Kustomizationapps.infrastructure/namespaces/namespaces.yaml: the Namespacehopin, with the restricted label and the prune annotation.quality/config.toml:[[root.allow]]forapps/, reason: Flux's documented layout, ruled Q9 on platform#1..github/workflows/ci.yml, jobcluster:packages: read, the Secretshopinandghcr-pullin the job's artifact, and the assertions.AGENTS.md: the Layout line forapps/hopin/; theclusterline on the private pull.
Verification: CI on the pull request and the landing push; images green on the ref; quality hygiene . printing hygiene: clean; the driven cells H4, H5, H6 and H15.
Neighbours
- The platform's own Cloudflare tunnel runs cloudflared in k3s in front of Traefik #45's S4a creates
infrastructure/namespaces/namespaces.yaml, the Kustomizationnamespacesand the annotation guard this slice joins, so it lands first. - hopin runs on the platform from its attested private image, routed by Traefik #46 holds S5b, the PC cell H13 after O3 and O5, and every other line; O9's second half is the operator's merge of this slice's pull request.
version = 1
now = "Cut from #46 (decision 11's S5a) on 07.11.2026. B1b judged its ref v2026.11.06.2 green, Traefik landed and O8 is done; #45's S4a, whose namespaces layer this slice joins, has not landed."
next = "Build once #51 (AD1a) has landed, whose namespaces layer it joins; land after #45's S4a, merging main, whose prune-annotation guard it meets."
done_when = "Flux reconciles the Kustomization apps after platform-secrets with wait: true and a timeout, held back with Flux's dependency reason while platform-secrets is not Ready; in the job, hopin's Deployment pulls its attested ref through the Secret ghcr-pull made from the job's own token and becomes Available with one Ready pod, in a namespace that enforces restricted and carries the prune annotation, its imageID at the pinned digest by E4's relationship, and without ghcr-pull the pull fails; hopin starts from the Secret hopin's files under /run/secrets with no LiteLLM key and no trusted proxy, and a missing session secret stops the start, naming the setting and no value, and turns cluster red; reverting this slice's workload while its Secrets stay keeps the Namespace hopin and platform-secrets Ready; AGENTS.md names apps/ and the private pull, quality hygiene . prints hygiene: clean, and H1 to H7, H14's H1 to H3 and H15 are reported."
scope = [".github/workflows/ci.yml", "AGENTS.md", "apps/hopin/hopin.yaml", "clusters/pc/apps.yaml", "infrastructure/namespaces/namespaces.yaml", "quality/config.toml"]
size = "M"
whole = "S5a does not split further: the Deployment, its Kustomization, its root declaration, its Namespace and the private pull that lets it start have no caller apart, and AGENTS.md describes them in the same change."
Activity
hopin's pod gets no Service links, whose HOPIN_PORT would replace its…