README: public front door for hiring managers #12

Merged
sirius merged 1 commit from wt/t_c9eac612 into master 2026-10-29 05:53:10 +00:00
Owner

Rewrites README.md as a public front door: what the cluster is, the three nodes, the stack, the public hostnames, and the six live Flux paths. Replaces the operator runbook that was there (incident asides, dead clusters/home/, retired Pi containers, 5-second 503s, the annotate recipe) with scannable tables and one architecture diagram. README only — no manifests, no live objects touched apart from the repo description.

Everything in the file was read live at 2026-10-29 01:23 EDT from 1b6441123cdf's base master (aa0f67fe33394bd565b1f07813ed4355fa926934). No version was carried over from docs/cluster-overview.md (that snapshot is stale and left untouched).

Measured state

kubectl get nodes -o wide

NAME        STATUS   ROLES                          AGE     VERSION   INTERNAL-IP   EXTERNAL-IP   OS-IMAGE                       KERNEL-VERSION                 CONTAINER-RUNTIME
linode      Ready    <none>                         2d11h   v1.36.4   10.10.0.5     <none>        Debian GNU/Linux 13 (trixie)   6.12.113+deb13-amd64 (amd64)   containerd://2.3.5
rpi         Ready    traffic,worker                 48d     v1.36.4   10.10.0.1     <none>        Debian GNU/Linux 13 (trixie)   6.18.39+rpt-rpi-2712 (arm64)   containerd://2.3.4
siriussec   Ready    control-plane,gateway,worker   48d     v1.36.4   10.10.0.2     <none>        Arch Linux                     6.18.50-2-lts (amd64)          containerd://2.3.5

Server version: v1.36.4

kubectl -n flux-system get kustomizations

apps               ./apps/home                               True   master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934
databases          ./infrastructure/databases/base           True   master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934
flux-system        ./clusters/homek8s                        True   master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934
gateway-api-crds   ./infrastructure/networking/gateway-api   True   master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934
infrastructure     ./infrastructure/home                     True   master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934
monitoring         ./monitoring/controllers/home             True   master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934

kubectl get hr -A

NAMESPACE     NAME                    AGE    READY   STATUS
kube-system   cilium                  44d    True    Helm upgrade succeeded for release kube-system/cilium.v20 with chart [email protected]
monitoring    kube-prometheus-stack   2d1h   True    Helm upgrade succeeded for release monitoring/kube-prometheus-stack.v15 with chart [email protected]

kubectl get httproute -A

NAMESPACE       NAME            HOSTNAMES                                                       AGE
forgejo         forgejo         ["forgejo.siriusdevops.com"]                                    48d
kube-system     hubble-ui                                                                       2d1h
monitoring      grafana                                                                         2d1h
piedmont        piedmont        ["piedmonthomesvc.com","www.piedmonthomesvc.com"]               29d
sirius-growth   sirius-growth   ["siriusgrowthsolutions.com","www.siriusgrowthsolutions.com"]   10d
siriusdevops    siriusdevops    ["siriusdevops.com","www.siriusdevops.com"]                     46d

kubectl get cluster -A

NAMESPACE       NAME     AGE   INSTANCES   READY   STATUS                     PRIMARY
forgejo         pg       48d   1           1       Cluster in healthy state   pg-1
sirius-growth   portal   9d    1           1       Cluster in healthy state   portal-1

kubectl get deploy -A

NAMESPACE            NAME                                       READY   UP-TO-DATE   AVAILABLE   AGE
cnpg-system          cnpg-controller-manager                    1/1     1            1           48d
flux-system          helm-controller                            1/1     1            1           44d
flux-system          kustomize-controller                       1/1     1            1           44d
flux-system          notification-controller                    1/1     1            1           44d
flux-system          source-controller                          1/1     1            1           44d
forgejo              forgejo                                    1/1     1            1           48d
forgejo              forgejo-runner-amd64                       1/1     1            1           40d
forgejo              forgejo-runner-arm64                       1/1     1            1           45h
forgejo              forgejo-runner-deploy-arm64                1/1     1            1           45h
kube-system          cilium-operator                            1/1     1            1           48d
kube-system          coredns                                    2/2     2            2           48d
kube-system          hubble-relay                               1/1     1            1           2d
kube-system          hubble-ui                                  1/1     1            1           2d
local-path-storage   local-path-provisioner                     1/1     1            1           48d
monitoring           blackbox-exporter                          1/1     1            1           2d
monitoring           kube-prometheus-stack-grafana              1/1     1            1           2d1h
monitoring           kube-prometheus-stack-kube-state-metrics   1/1     1            1           2d1h
monitoring           kube-prometheus-stack-operator             1/1     1            1           2d1h
piedmont             piedmont-contact                           1/1     1            1           28d
piedmont             piedmont-site                              1/1     1            1           29d
sirius-growth        sirius-growth-contact                      1/1     1            1           10d
sirius-growth        sirius-growth-portal                       1/1     1            1           9d
sirius-growth        sirius-growth-site                         1/1     1            1           10d
siriusdevops         siriusdevops-contact                       1/1     1            1           46d
siriusdevops         siriusdevops-site                          1/1     1            1           46d

kubectl get storageclass

NAME                   PROVISIONER                    RECLAIMPOLICY   VOLUMEBINDINGMODE      ALLOWVOLUMEEXPANSION   AGE
local-path (default)   rancher.io/local-path          Delete          WaitForFirstConsumer   false                  48d
local-static           kubernetes.io/no-provisioner   Retain          WaitForFirstConsumer   false                  47h

Ingress origin proved this run

From a WireGuard spoke that can reach the origin (curl -m 15):

forgejo.siriusdevops.com           200 0.114s
piedmonthomesvc.com                200 0.075s
www.piedmonthomesvc.com            200 0.075s
siriusgrowthsolutions.com          200 0.196s
www.siriusgrowthsolutions.com      200 0.151s
siriusdevops.com                   200 0.113s
www.siriusdevops.com               200 0.112s

Internal, bare IP with no Host header:

curl http://10.10.0.2:8081/  -> 302, redirect_url http://10.10.0.2:8081/login
curl http://10.10.0.2:8084/  -> 200

So http://10.10.0.2:8080 is kept as the origin claim, and both internal addresses are printed only because they answered as expected.

The mermaid block was parsed with mermaid@11 (mermaid.parse) and returned flowchart-v2.

Set differences

Live HTTPRoute hostnames (7) minus README hostnames = empty
README hostnames minus live HTTPRoute hostnames = empty
Live node names (linode, rpi, siriussec) minus README node names = empty

Scope

1b64411 README: rewrite the public front door from the live cluster
 README.md | 256 +++++++++++++++++++++++++++++++-------------------------------
 1 file changed, 126 insertions(+), 130 deletions(-)

git diff origin/master -- . ':(exclude)README.md' = 0 lines (empty).

Premises checked

Everything in the card's measured-state block matched the live cluster, so nothing had to be corrected. Two claims from the old README were dropped as unverifiable this run rather than carried forward: the site-CI "rolls the Deployment" sentence, and the wording around paaas.siriusdevops.com. docs/cluster-overview.md is still stale and was deliberately not edited.

Not merged.

Rewrites `README.md` as a public front door: what the cluster is, the three nodes, the stack, the public hostnames, and the six live Flux paths. Replaces the operator runbook that was there (incident asides, dead `clusters/home/`, retired Pi containers, 5-second 503s, the annotate recipe) with scannable tables and one architecture diagram. README only — no manifests, no live objects touched apart from the repo description. Everything in the file was read live at 2026-10-29 01:23 EDT from `1b6441123cdf`'s base `master` (`aa0f67fe33394bd565b1f07813ed4355fa926934`). No version was carried over from `docs/cluster-overview.md` (that snapshot is stale and left untouched). ## Measured state `kubectl get nodes -o wide` ``` NAME STATUS ROLES AGE VERSION INTERNAL-IP EXTERNAL-IP OS-IMAGE KERNEL-VERSION CONTAINER-RUNTIME linode Ready <none> 2d11h v1.36.4 10.10.0.5 <none> Debian GNU/Linux 13 (trixie) 6.12.113+deb13-amd64 (amd64) containerd://2.3.5 rpi Ready traffic,worker 48d v1.36.4 10.10.0.1 <none> Debian GNU/Linux 13 (trixie) 6.18.39+rpt-rpi-2712 (arm64) containerd://2.3.4 siriussec Ready control-plane,gateway,worker 48d v1.36.4 10.10.0.2 <none> Arch Linux 6.18.50-2-lts (amd64) containerd://2.3.5 ``` Server version: `v1.36.4` `kubectl -n flux-system get kustomizations` ``` apps ./apps/home True master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934 databases ./infrastructure/databases/base True master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934 flux-system ./clusters/homek8s True master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934 gateway-api-crds ./infrastructure/networking/gateway-api True master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934 infrastructure ./infrastructure/home True master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934 monitoring ./monitoring/controllers/home True master@sha1:aa0f67fe33394bd565b1f07813ed4355fa926934 ``` `kubectl get hr -A` ``` NAMESPACE NAME AGE READY STATUS kube-system cilium 44d True Helm upgrade succeeded for release kube-system/cilium.v20 with chart [email protected] monitoring kube-prometheus-stack 2d1h True Helm upgrade succeeded for release monitoring/kube-prometheus-stack.v15 with chart [email protected] ``` `kubectl get httproute -A` ``` NAMESPACE NAME HOSTNAMES AGE forgejo forgejo ["forgejo.siriusdevops.com"] 48d kube-system hubble-ui 2d1h monitoring grafana 2d1h piedmont piedmont ["piedmonthomesvc.com","www.piedmonthomesvc.com"] 29d sirius-growth sirius-growth ["siriusgrowthsolutions.com","www.siriusgrowthsolutions.com"] 10d siriusdevops siriusdevops ["siriusdevops.com","www.siriusdevops.com"] 46d ``` `kubectl get cluster -A` ``` NAMESPACE NAME AGE INSTANCES READY STATUS PRIMARY forgejo pg 48d 1 1 Cluster in healthy state pg-1 sirius-growth portal 9d 1 1 Cluster in healthy state portal-1 ``` `kubectl get deploy -A` ``` NAMESPACE NAME READY UP-TO-DATE AVAILABLE AGE cnpg-system cnpg-controller-manager 1/1 1 1 48d flux-system helm-controller 1/1 1 1 44d flux-system kustomize-controller 1/1 1 1 44d flux-system notification-controller 1/1 1 1 44d flux-system source-controller 1/1 1 1 44d forgejo forgejo 1/1 1 1 48d forgejo forgejo-runner-amd64 1/1 1 1 40d forgejo forgejo-runner-arm64 1/1 1 1 45h forgejo forgejo-runner-deploy-arm64 1/1 1 1 45h kube-system cilium-operator 1/1 1 1 48d kube-system coredns 2/2 2 2 48d kube-system hubble-relay 1/1 1 1 2d kube-system hubble-ui 1/1 1 1 2d local-path-storage local-path-provisioner 1/1 1 1 48d monitoring blackbox-exporter 1/1 1 1 2d monitoring kube-prometheus-stack-grafana 1/1 1 1 2d1h monitoring kube-prometheus-stack-kube-state-metrics 1/1 1 1 2d1h monitoring kube-prometheus-stack-operator 1/1 1 1 2d1h piedmont piedmont-contact 1/1 1 1 28d piedmont piedmont-site 1/1 1 1 29d sirius-growth sirius-growth-contact 1/1 1 1 10d sirius-growth sirius-growth-portal 1/1 1 1 9d sirius-growth sirius-growth-site 1/1 1 1 10d siriusdevops siriusdevops-contact 1/1 1 1 46d siriusdevops siriusdevops-site 1/1 1 1 46d ``` `kubectl get storageclass` ``` NAME PROVISIONER RECLAIMPOLICY VOLUMEBINDINGMODE ALLOWVOLUMEEXPANSION AGE local-path (default) rancher.io/local-path Delete WaitForFirstConsumer false 48d local-static kubernetes.io/no-provisioner Retain WaitForFirstConsumer false 47h ``` ## Ingress origin proved this run From a WireGuard spoke that can reach the origin (`curl -m 15`): ``` forgejo.siriusdevops.com 200 0.114s piedmonthomesvc.com 200 0.075s www.piedmonthomesvc.com 200 0.075s siriusgrowthsolutions.com 200 0.196s www.siriusgrowthsolutions.com 200 0.151s siriusdevops.com 200 0.113s www.siriusdevops.com 200 0.112s ``` Internal, bare IP with no `Host` header: ``` curl http://10.10.0.2:8081/ -> 302, redirect_url http://10.10.0.2:8081/login curl http://10.10.0.2:8084/ -> 200 ``` So `http://10.10.0.2:8080` is kept as the origin claim, and both internal addresses are printed only because they answered as expected. The mermaid block was parsed with `mermaid@11` (`mermaid.parse`) and returned `flowchart-v2`. ## Set differences Live HTTPRoute hostnames (7) minus README hostnames = **empty** README hostnames minus live HTTPRoute hostnames = **empty** Live node names (`linode`, `rpi`, `siriussec`) minus README node names = **empty** ## Scope ``` 1b64411 README: rewrite the public front door from the live cluster README.md | 256 +++++++++++++++++++++++++++++++------------------------------- 1 file changed, 126 insertions(+), 130 deletions(-) ``` `git diff origin/master -- . ':(exclude)README.md'` = 0 lines (empty). ## Premises checked Everything in the card's measured-state block matched the live cluster, so nothing had to be corrected. Two claims from the old README were dropped as unverifiable this run rather than carried forward: the site-CI "rolls the Deployment" sentence, and the wording around `paaas.siriusdevops.com`. `docs/cluster-overview.md` is still stale and was deliberately not edited. Not merged.
sirius merged commit 5825714bcd into master 2026-10-29 05:53:10 +00:00
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set

Reference
sirius/homek8s!12
No description provided.