add-keycloakx/7.2.2: keycloakx 7.2.2 추가, keycloak/18.4.0 제거 (이슈 #1)

codecentric/keycloak(18.4.0, WildFly 기반, appVersion 17.0.1-legacy)이
bitnami/postgresql 서브차트를 조건부 의존성으로 포함해 bitnami 무료 배포
정책 변경 문제가 그대로 전이됐다. codecentric은 이 WildFly 차트를 더 이상
갱신하지 않고 Quarkus 기반 Keycloak(17+)용 별도 차트 keycloakx를 제공하며,
keycloakx는 서브차트 의존성이 전혀 없어(Chart.yaml에 dependencies 없음)
문제가 근본적으로 해소된다.

실제 소비자가 없어(문서 예시 표 한 줄 외 참조 없음) phased 전환 없이
keycloak/18.4.0을 같은 커밋에서 제거했다.

custom-values.yaml 작성 시 확인한 핵심 사항 — 이 차트의 http.relativePath
기본값이 구버전 WildFly Keycloak 호환용 "/auth"라, 명시적으로 "/"로
오버라이드해야 한다(안 하면 OIDC issuer/admin API 경로가 소비 앱들의
경로 접미사 없음 가정과 어긋난다). database.existingSecret/existingSecretKey
로 kubernetes.io/basic-auth 시크릿을 그대로 참조 가능함도 helm template로
확인했다.

Closes #1

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
wbsong111
2026-08-06 16:09:51 +09:00
parent e527131fd0
commit 611e971295
99 changed files with 1805 additions and 7432 deletions
@@ -0,0 +1,63 @@
image:
repository: quay.io/keycloak/keycloak
tag: "26.6.4"
# keycloakx 기본값은 "/auth"(구 WildFly 기반 codecentric/keycloak 호환용). Keycloak
# 26(Quarkus) 네이티브 기본값은 "/"이며, /auth 를 그대로 두면 OIDC issuer/admin API
# 경로가 다른 앱들의 가정(경로 접미사 없음)과 어긋난다.
http:
relativePath: "/"
ingress:
enabled: true
ingressClassName: apisix
annotations:
cert-manager.io/cluster-issuer: "root-ca-issuer"
rules:
- host: keycloak.example.org
paths:
- path: /
pathType: Prefix
tls:
- hosts:
- keycloak.example.org
secretName: keycloak-tls
proxy:
enabled: true
mode: forwarded
resources:
requests:
cpu: 100m
memory: 500Mi
limits:
cpu: 2000m
memory: 1500Mi
# 외부 postgresql 사용. vendor/hostname/port/database/username 값을 배포된 DB로 변경.
# 비밀번호는 password 평문 대신 existingSecret(kubernetes.io/basic-auth 시크릿의
# password 키, 기본 existingSecretKey)을 쓰는 것을 권장.
database:
vendor: postgres
hostname: keycloak-postgresql
port: 5432
database: keycloak
username: keycloak
existingSecret: keycloak-db
existingSecretKey: password
# KC_DB_SCHEMA: Keycloak Quarkus 정식 config 옵션(db-schema) — public 이 아닌 전용
# 스키마를 쓸 때 지정.
# KC_BOOTSTRAP_ADMIN_USERNAME/PASSWORD: Keycloak 25+ 의 admin 계정 부트스트랩
# 메커니즘(구버전 KEYCLOAK_ADMIN/KEYCLOAK_ADMIN_PASSWORD 대체). master realm이
# 완전히 비어있는 최초 부팅에만 동작 — 재설치 시 비밀번호가 갱신되지 않는 것이 정상.
extraEnv: |
- name: KC_DB_SCHEMA
value: keycloak
- name: KC_BOOTSTRAP_ADMIN_USERNAME
value: admin
- name: KC_BOOTSTRAP_ADMIN_PASSWORD
value: Paasadm1234!
- name: TZ
value: Asia/Seoul