Resolve OQ-4: scoped Cloudflare API token for DNS-01 + ExternalDNS

Operator chose Option A. cert-manager solves ACME DNS-01 and ExternalDNS
manages *.home.keithjackson.dev records via a scoped Cloudflare token
(Zone.DNS.Edit, keithjackson.dev), stored SOPS-encrypted. Operator provides
the token once (new prereq T-2.4p); T-2.4/T-2.5 unblocked. Only OQ-BKP
(off-cluster DR backup target, Phase 4) remains open.

Updated: docs 00,08,09; task board.

Co-Authored-By: Claude Opus 4.8 (1M context) <[email protected]>
This commit is contained in:
jakman85andClaude Opus 4.8 committed 2026-08-15 23:02:59 -05:00
1 parent 192ce31bef
commit cde2f2330c
4 files changed
+37 -38

No files matched your search

+5 -9
View File
@@ -62,9 +62,9 @@ A wildcard `*.keithjackson.dev` matches only **one** label deep — it covers `h
but **not** `plex.home.keithjackson.dev`. Consequences:
- **`internal` services need no public record** — PiHole resolves `<svc>.home.keithjackson.dev` to
the internal Gateway VIP (split-horizon). This is the majority of services.
- **`public` services** need a public record for `<svc>.home.keithjackson.dev`. That is provided by
either a one-time `*.home.keithjackson.dev` → public-IP record, or by **ExternalDNS via the DNS
API** — both hinge on OQ-4 (see [08](08-tls-and-certificates.md)).
- **`public` services** need a public record for `<svc>.home.keithjackson.dev`. Per OQ-4 (resolved),
**ExternalDNS manages these automatically** via the scoped Cloudflare API token — no manual record
editing (see [08](08-tls-and-certificates.md)).
## Interaction with default-deny
@@ -81,9 +81,5 @@ not let other in-cluster services reach it unless an explicit allow rule exists.
## Resolved
- **OQ-1** — single SOHO edge (manual port-forward only); ingress VIP via **Cilium L2 announcement**.
## Open questions
- **OQ-4** — DNS challenge/record access: Cloudflare **API token** (automated ExternalDNS + DNS-01)
vs **acme-dns delegation** (one-time CNAME, no standing credential). Determines whether public
`*.home.keithjackson.dev` records and ACME challenges are automated or partly manual. See
[08](08-tls-and-certificates.md).
- **OQ-4** — scoped **Cloudflare API token** drives ExternalDNS (records) and cert-manager DNS-01
(certs) automatically; see [08](08-tls-and-certificates.md).