Skip to content

hopin runs from its attested private image, pulled through ghcr-pull, with its secrets as files #82

Closed

Description

@FlexOr2

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

Ruled

Copied verbatim; each bullet names its own source.

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 apps after platform-secrets, with wait: true and a timeout. A platform-secrets that is not Ready holds apps back 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 enforces restricted and carries the prune annotation. The container's imageID relates to the pinned digest as P3d's E4 established. Without ghcr-pull the pull fails.
  • S3 (S5a) hopin starts from the Secret hopin's files under /run/secrets with no LiteLLM key and no trusted proxy. A missing session secret stops the start, naming the setting and no value, and cluster turns red.
  • S8 AGENTS.md names apps/ and the route, quality hygiene . prints hygiene: clean, and the cards R1, R3a and R3b are ruled.
  • S9 Reverting S5a's workload while its Secrets stay keeps the Namespace hopin, and platform-secrets stays 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 Kustomization apps.
  • infrastructure/namespaces/namespaces.yaml: the Namespace hopin, with the restricted label and the prune annotation.
  • quality/config.toml: [[root.allow]] for apps/, reason: Flux's documented layout, ruled Q9 on platform#1.
  • .github/workflows/ci.yml, job cluster: packages: read, the Secrets hopin and ghcr-pull in the job's artifact, and the assertions.
  • AGENTS.md: the Layout line for apps/hopin/; the cluster line 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

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."

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions