add-keycloakx: 실측으로 발견한 command/KC_HOSTNAME 필수값 반영
dev 클러스터 격리 네임스페이스에 실제 배포해 검증하는 과정에서 두 가지 누락을 발견했다: 1. command/args 기본값이 둘 다 빈 배열이라, 지정하지 않으면 컨테이너가 인자 없는 kc.sh(도움말 출력, exit 0)로 끝나 CrashLoopBackOff가 된다. 2. hostname-strict 기본값이 true라 KC_HOSTNAME 을 지정하지 않으면 "hostname is not configured" 로 기동이 실패한다. 두 값 모두 custom-values.yaml에 추가하고, BUILD-README/CUSTOM-README에 실측 근거를 남겼다. 이후 admin 부트스트랩(KC-SERVICES0077), DB 마이그레이션, admin REST API로 realm/client 생성까지 전부 정상 동작 확인. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
This commit is contained in:
@@ -7,6 +7,8 @@
|
||||
- keycloakx를 배포하려면 외부 postgresql이 필요하다(이 차트는 내장 DB를 지원하지 않는다 — 서브차트 의존성 없음).
|
||||
- `custom-values.yaml`의 `database.*` 를 배포된 DB 정보로 변경한다.
|
||||
- **`http.relativePath: "/"` 를 지우거나 값을 바꾸지 말 것.** 이 차트의 기본값은 구버전 WildFly Keycloak 호환을 위한 `"/auth"`다. `"/"`로 명시하지 않으면 Quarkus 네이티브 경로 규칙과 달라져, OIDC issuer URL(`/realms/{realm}`)이나 admin REST API(`/admin/realms/...`)를 경로 접미사 없이 호출하는 소비 앱들의 연동이 조용히 깨진다.
|
||||
- **`command`를 반드시 지정할 것.** 차트 기본값(`command: []`, `args: []`)만으로는 컨테이너가 인자 없는 `kc.sh`(도움말 출력, exit 0)로 끝나 CrashLoopBackOff가 된다(실측 확인). `custom-values.yaml`의 `command: ["/opt/keycloak/bin/kc.sh", "start"]`를 유지한다.
|
||||
- **`extraEnv`에 `KC_HOSTNAME`을 반드시 지정할 것.** 미지정 시 `hostname is not configured; either configure hostname, or set hostname-strict to false`로 기동이 실패한다(실측 확인, hostname-strict 기본값 true).
|
||||
|
||||
### 2) 배포 방법
|
||||
|
||||
@@ -40,6 +42,8 @@ database:
|
||||
existingSecretKey: password # 시크릿 안의 비밀번호 키 (기본값 "password")
|
||||
|
||||
extraEnv: |
|
||||
- name: KC_HOSTNAME # 필수 — 미지정 시 hostname-strict 검증으로 기동 실패
|
||||
value: keycloak.example.org
|
||||
- name: KC_DB_SCHEMA # public 이 아닌 전용 스키마를 쓸 때 지정
|
||||
value: keycloak
|
||||
- name: KC_BOOTSTRAP_ADMIN_USERNAME
|
||||
|
||||
Reference in New Issue
Block a user