Skip to main content

Namespace layout

The cluster's namespace layout by tier, as kernel/namespaces.yaml declares it: the one list the installer creates from, the operator selects on and the lints check against.

1. kernel​

Namefunctionholds
kernel-gitopsgitopsArgo CD, argocd-image-updater
kernel-provisioningprovisioningCrossplane, its providers and functions
kernel-secretssecretsOpenBao, External Secrets Operator, Reloader
kernel-sealsealthe OpenBao transit seal; a separate RBAC and backup domain from the vault it unseals
kernel-datadatathe CNPG operator and kernel-postgres (Keycloak, its extensions, OpenFGA, the console)
kernel-authenticationauthenticationKeycloak, its configuration, the event listener
kernel-authorizationauthorizationOpenFGA; reachable from enforcement points only
kernel-controlcontrolthe operator, the director, the usher, the custodian, the registrar
kernel-edgeedgeEnvoy Gateway, both Gateway objects, cert-manager, external-dns, cloudflared
kernel-admissionadmissionKyverno and the baseline policies; node-apparmor, which keeps containerd's AppArmor profile from blocking signals inside a container
kernel-observabilityobservabilityHeadlamp (the cluster administrator's view of the cluster, with their own identity); the platform's monitoring and log forwarder when switched on

2. system​

Namefunctionholdswhen
system-postgresqlpostgresqlthe CNPG cluster tenant databases are provisioned on; the kernel's own is kernel-postgres, in kernel-data
system-mariadbmariadbMariaDB, for catalog apps that speak no other engine
system-cachecacheRedis
system-s3s3SeaweedFS, the object store apps take buckets from
system-authorizationauthorizationthe app instance of OpenFGA, with the components' authorization stores, and the arbiter, the one way into itrequires.services.authorization
system-turn-dmzturn-dmzthe TURN edge — STUNner's daemon, its load balancer, its certificate and the record of turn.<kernel domain>; it relays only to its own podsrequires.services.turn
system-mailmailPostfix (the MTA and the DKIM signer, with the per-tenant keys) and Dovecot (the mailbox store); nothing here has a load balancermail.serviceMode=system
system-mail-dmzmail-dmzthe mail edge — a proxy on :25, :587 and :993 that holds no mail, no user and no key — its load balancer, and the DNS records that point at itmail.serviceMode=system
system-llmllmthe LiteLLM proxy, its database, and the vLLM instances the claim listsllm.enabled=true

3. labelled​

Nametierfunction
kube-systemkernelplatform
metallb-systemkernelload-balancer