From 8e68b1d60318c2aab182ab3b0469ced35f461172 Mon Sep 17 00:00:00 2001
From: wbsong111 <wbsong@paasup.io>
Date: Thu, 23 Apr 2026 16:32:52 +0900
Subject: [PATCH] Update CUSTOM-README.md

---
 .../flink-cdc-session/0.1.0/CUSTOM-README.md  | 36 ++++++++++++-------
 1 file changed, 24 insertions(+), 12 deletions(-)

diff --git a/manifests/helm/flink-cdc-session/0.1.0/CUSTOM-README.md b/manifests/helm/flink-cdc-session/0.1.0/CUSTOM-README.md
index 3c4d647..3166c90 100644
--- a/manifests/helm/flink-cdc-session/0.1.0/CUSTOM-README.md
+++ b/manifests/helm/flink-cdc-session/0.1.0/CUSTOM-README.md
@@ -33,7 +33,17 @@ helm upgrade flink-cdc-session ./ \
 
 ## 2. custom-values.yaml 설명
 
-### 1) 체크포인트 저장소
+### 1) ServiceAccount / RBAC
+
+| Name | 설명 | 기본값 |
+|------|------|--------|
+| `serviceAccount.create` | ServiceAccount 생성 여부 | `true` |
+| `serviceAccount.name` | SA 이름. 비어있으면 Release.Name 사용 | `""` |
+| `rbac.create` | Role / RoleBinding 생성 여부 | `true` |
+
+> `rbac.create: true` 시 JobManager가 TaskManager(Deployment)를 관리하기 위한 RBAC 권한이 함께 생성됩니다.
+
+### 2) 체크포인트 저장소
 
 | Name | 설명 | 기본값 |
 |------|------|--------|
@@ -44,7 +54,7 @@ helm upgrade flink-cdc-session ./ \
 | `checkpointStorage.s3.pathStyleAccess` | Path-style 접근 여부 (MinIO는 `"true"`) | `"true"` |
 | `checkpointStorage.s3.existingSecret` | 자격증명 Secret 이름 | `minio-credentials` |
 
-### 2) Ingress 설정
+### 3) Ingress 설정
 
 | Name | 설명 | 기본값 |
 |------|------|--------|
@@ -53,14 +63,16 @@ helm upgrade flink-cdc-session ./ \
 | `ingress.className` | IngressClass 이름 | `kong` |
 | `ingress.annotations` | Ingress 어노테이션 | cert-manager + Kong HTTPS 설정 |
 
-### 3) Truststore (사설 CA 환경)
+### 4) Truststore (사설 CA 환경)
 
 | Name | 설명 | 기본값 |
-|------|------|--------|
+| --- | --- | --- |
 | `truststore.enabled` | 외부 JKS 사용 여부 | `true` |
-| `truststore.secretName` | truststore Secret 이름 | `flink-truststore` |
+| `truststore.secretName` | 기존 Secret 이름 지정. 비어있으면 `{release-name}-flink-truststore` 자동 사용 | `""` |
 
-### 4) Job 설정
+> `truststore.secretName: flink-truststore` 처럼 기존 Secret을 지정하면 chart가 Secret을 새로 생성하지 않고 재사용합니다.
+
+### 5) Job 설정
 
 | Name | 설명 | 기본값 |
 |------|------|--------|
@@ -68,7 +80,7 @@ helm upgrade flink-cdc-session ./ \
 
 > **주의**: Session Cluster가 RUNNING 상태가 된 후 `job.enabled: true`로 upgrade하세요.
 
-### 5) Flink 클러스터 리소스 (values.yaml에서 조정)
+### 6) Flink 클러스터 리소스 (values.yaml에서 조정)
 
 | Name | 설명 | 기본값 |
 |------|------|--------|
@@ -79,7 +91,7 @@ helm upgrade flink-cdc-session ./ \
 | `taskManager.cpu` | TaskManager CPU | `1` |
 | `taskManager.taskSlots` | TaskManager 슬롯 수 | `2` |
 
-### 6) PostgreSQL 소스 (values.yaml에서 조정)
+### 7) PostgreSQL 소스 (values.yaml에서 조정)
 
 | Name | 설명 | 기본값 |
 |------|------|--------|
@@ -90,7 +102,7 @@ helm upgrade flink-cdc-session ./ \
 | `postgres.slotName` | Replication slot 이름 | `flink_cdc_slot` |
 | `postgres.tables` | CDC 대상 테이블 목록 | `testdb.public.orders,testdb.public.users` |
 
-### 7) Iceberg 싱크 (values.yaml에서 조정)
+### 8) Iceberg 싱크 (values.yaml에서 조정)
 
 | Name | 설명 | 기본값 |
 |------|------|--------|
@@ -147,11 +159,11 @@ kubectl get flinkdeployment -n flink-test
 # Pod 상태 확인
 kubectl get pods -n flink-test
 
-# Job 로그 확인
-kubectl logs -n flink-test job/submit-cdc
+# Job 로그 확인 (release name: flink-cdc-session, job.name: submit-cdc)
+kubectl logs -n flink-test job/flink-cdc-session-submit-cdc
 
 # Flink Web UI (포트포워딩)
-kubectl port-forward svc/flink-cdc-session-rest 8081:8081 -n flink-test
+kubectl port-forward svc/flink-cdc-session-session-rest 8081:8081 -n flink-test
 ```
 
 ## 5. 삭제