commit 1dc00d7fe40a2b4dca12f42d03daabfc2b315c06 Author: Shard Date: Wed Apr 1 13:33:26 2026 +0000 Add Keycloak k8s baseline (namespace keycloak, external DB, ingress, realm groups) diff --git a/keycloak/README.md b/keycloak/README.md new file mode 100644 index 0000000..f88f939 --- /dev/null +++ b/keycloak/README.md @@ -0,0 +1,25 @@ +# Keycloak Infrastructure (Kubernetes) + +- Namespace: `keycloak` +- Hostname: `auth.aeternalisgames.com` +- Ingress: nginx + cert-manager (`letsencrypt-godaddy`) +- External DB: `172.10.1.127:5432`, database `keycloak` +- Helm chart: Bitnami Keycloak + +## Install/Upgrade + +```bash +helm repo add bitnami https://charts.bitnami.com/bitnami +helm repo update +kubectl create namespace keycloak --dry-run=client -o yaml | kubectl apply -f - +kubectl -n keycloak create secret generic keycloak-admin-credentials \ + --from-literal=admin-password='' --dry-run=client -o yaml | kubectl apply -f - +kubectl -n keycloak create secret generic keycloak-db-credentials \ + --from-literal=db-password='' --dry-run=client -o yaml | kubectl apply -f - +helm upgrade --install keycloak bitnami/keycloak -n keycloak -f values.yaml +``` + +## Realm Bootstrap (initial) +- Realm: `aeternalis` +- Groups: `card_creator`, `cdn-admin`, `moderator`, `auditor`, `art-controller`, `card-admin`, `sound-admin`, `sound-creator`, `player` +- MFA: optional (TOTP + WebAuthn available) diff --git a/keycloak/bootstrap-notes.md b/keycloak/bootstrap-notes.md new file mode 100644 index 0000000..39781e4 --- /dev/null +++ b/keycloak/bootstrap-notes.md @@ -0,0 +1,29 @@ +# Bootstrap Notes (2026-04-01) + +- Namespace: `keycloak` +- Host: `auth.aeternalisgames.com` +- External DB: `172.10.1.127:5432`, db `keycloak`, user `SOR-DBA` +- Admin user: `dingo-bg` +- Admin password stored in: + - `keycloak/keycloak-admin-credentials` (`admin-password`) + - `shard/keycloak-breakglass-admin` (`username`,`host`,`password`) + +## Initial Realm +- Realm: `aeternalis` +- Registration disabled +- Groups created: + - `card_creator` + - `cdn-admin` + - `moderator` + - `auditor` + - `art-controller` + - `card-admin` + - `sound-admin` + - `sound-creator` + - `player` + +## Next Steps +1. Add ArgoCD app for `infrastructure/keycloak` (GitOps ownership) +2. Configure clients: Gitea, ArgoCD, Nextcloud, SOR +3. Configure group-to-role mapping per app +4. Cut over one app at a time with local-admin fallback diff --git a/keycloak/values.yaml b/keycloak/values.yaml new file mode 100644 index 0000000..ae1ab82 --- /dev/null +++ b/keycloak/values.yaml @@ -0,0 +1,49 @@ +replicaCount: 3 + +image: + registry: docker.io + repository: bitnamilegacy/keycloak + tag: 26.2.5-debian-12-r0 + +auth: + adminUser: dingo-bg + existingSecret: keycloak-admin-credentials + passwordSecretKey: admin-password + +proxy: edge +httpRelativePath: / + +production: true + +resources: + requests: + cpu: 500m + memory: 1Gi + limits: + cpu: 2 + memory: 2Gi + +externalDatabase: + host: 172.10.1.127 + port: 5432 + user: SOR-DBA + database: keycloak + existingSecret: keycloak-db-credentials + existingSecretPasswordKey: db-password + +ingress: + enabled: true + ingressClassName: nginx + hostname: auth.aeternalisgames.com + path: / + pathType: Prefix + annotations: + cert-manager.io/cluster-issuer: letsencrypt-godaddy + tls: true + +postgresql: + enabled: false + +metrics: + enabled: true +