jakman85andClaude Opus 4.8
a108d5ab98
Operator directive: don't diverge architecture to avoid asking for credentials; provision them upfront via SOPS and keep the existing (unified) graph. Roadmap reconciliation: Phase 2 = Network/Storage/TLS/DNS/Ingress, so cert-manager/externaldns/gateway (the credential-gated pieces) ARE Phase 2; monitoring is Phase 4. Earlier A2/rollout scope was inverted by credential-avoidance. Reverts (credential-driven): remove clusters/dev/rollout/ + the $patch:delete's; restore unified base graph (dev = ../base + cluster-vars + SOPS decryption, R-ENV-02 intact); restore monitoring files (Phase 4). Kept non-credential improvements: tofu for_each/rejoin, Kyverno parametrization + webhook excludes. platform/kustomization.yaml now phased (single shared list): Phase-2 set = kyverno, cilium, longhorn, cert-manager, externaldns, gateway; later components commented with phase markers. SOPS activated: .sops.yaml at repo root; bootstrap/sops/secret-templates/*.yaml.example for all secrets (cloudflare x2, grafana, alertmanager-smtp, keycloak, oauth2-proxy, pia); bootstrap/sops/CREDENTIALS.md checklist; pre-wired commented cloudflare-api-token lines in cert-manager + externaldns; filled non-secret ACME email. Agents never touch real secret values (operator encrypts). Validated: kubectl kustomize dev(unified)/prod/platform(Phase-2 only), templates inert, make -C ci gate PASS. Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
platform/cert-manager
cert-manager — trusted TLS via Let's Encrypt, ACME DNS-01 (Cloudflare).
- Governing ADR: ADR-0006 — TLS: cert-manager + Let's Encrypt (DNS-01)
- Spec: docs/08 — TLS & Certificates, docs/09 — DNS & Ingress
- Serves: R-TLS-01/02/03, R-DNS-01
- Owner: WS-SEC
What this stub is
Flux HelmRelease + two ClusterIssuers (letsencrypt-staging, letsencrypt-prod — both
mandated by ADR-0006). DNS-01 against the keithjackson.dev zone validates domain control without
exposing the service (works for internal-only services, R-TLS-03) and enables the wildcard
*.home.keithjackson.dev cert defined in ../gateway.
Contract (Issuer + Gateway TLS)
Part of the "Issuer + Gateway TLS" interface (roadmap/workstreams.md, WS-SEC + WS-NET): the wildcard
Certificate (in gateway/) references the issuer named by ${ACME_CLUSTER_ISSUER} and its secret
is consumed by the Gateway HTTPS listener.
Secrets
The Cloudflare API token is referenced by name (cloudflare-api-token) and committed
SOPS-encrypted (WS-SEC, OQ-4, ADR-0007). No plaintext token in git.
TODO (later phases)
- OQ-4 (resolved to Cloudflare): WS-SEC provisions the scoped Cloudflare token, SOPS-encrypted.
- Set the ACME account email.
- Phase 2 (WS-SEC): issue the wildcard cert; prove a trusted, non-self-signed cert at
*.home.keithjackson.dev(R-TLS-01/03, Phase-2 exit gate).