From 2a3077eee0b471f298aa0eadff8a45316097fb33 Mon Sep 17 00:00:00 2001
From: wbsong111 <wbsong@paasup.io>
Date: Tue, 28 Oct 2025 08:54:38 +0900
Subject: [PATCH] Update resource document

---
 doc/change-bitnami-image.md                  |   2 +-
 doc/complete-chart-resources-with-volumes.md | 122 +++++++++++++++++++
 2 files changed, 123 insertions(+), 1 deletion(-)

diff --git a/doc/change-bitnami-image.md b/doc/change-bitnami-image.md
index 77c3e93..51d3b5a 100644
--- a/doc/change-bitnami-image.md
+++ b/doc/change-bitnami-image.md
@@ -5,7 +5,7 @@
  bitnami의 이미지 제공 방식이 변경되어 기존 chart를 사용하는 repository가 변경되었습다. 본 문서에는 bitnami 이미지를 사용하는 차트의 목록과 변경해야 할 `values.yaml`을 정리하였습니다.
 
 
- ## 1. airflow
+## 1. airflow
 **Apache Airflow - 워크플로우 오케스트레이션**
 
 ** bitnami 사용 컴포넌트 **
diff --git a/doc/complete-chart-resources-with-volumes.md b/doc/complete-chart-resources-with-volumes.md
index 77afe76..93f8d6b 100644
--- a/doc/complete-chart-resources-with-volumes.md
+++ b/doc/complete-chart-resources-with-volumes.md
@@ -1906,7 +1906,129 @@ routerSpec:
 ```
 
 ---
+## Operator 기반 리소스 정의
 
+### Kafka Cluster (Strimzi Operator 사용)
+**Apache Kafka 클러스터 - 분산 스트리밍 플랫폼**
+
+| 컴포넌트 | Small | Medium | Large |
+|----------|-------|--------|-------|
+| **Controller** | 500m/1Gi → 1000m/2Gi | 1000m/2Gi → 2000m/4Gi | 2000m/4Gi → 4000m/8Gi |
+| **Broker** | 1000m/2Gi → 2000m/4Gi | 2000m/4Gi → 4000m/8Gi | 4000m/8Gi → 8000m/16Gi |
+| **Topic Operator** | 100m/128Mi → 200m/256Mi | 250m/256Mi → 500m/512Mi | 500m/512Mi → 1000m/1Gi |
+| **User Operator** | 100m/128Mi → 200m/256Mi | 250m/256Mi → 500m/512Mi | 500m/512Mi → 1000m/1Gi |
+
+**볼륨 사이즈 권장사항:**
+| 컴포넌트 | Small | Medium | Large |
+|----------|-------|--------|-------|
+| **Controller Storage** | 5Gi | 10Gi | 20Gi |
+| **Broker Storage** | 20Gi | 50Gi | 100Gi |
+
+**권장 사용 시나리오:**
+- Small: 개발/테스트 환경 (< 10 토픽)
+- Medium: 중간 처리량 (10-100 토픽)
+- Large: 고처리량 프로덕션 (100+ 토픽)
+
+**Kafka CR 설정 예시**
+```yaml
+apiVersion: kafka.strimzi.io/v1beta2
+kind: KafkaNodePool
+metadata:
+  name: controller
+spec:
+...
+  resources:
+    requests:
+      cpu: 500m
+      memory: 1Gi
+    limits:
+      cpu: 1
+      memory: 2Gi
+  storage:
+    type: jbod
+    volumes:
+      - id: 0
+        type: persistent-claim
+        size: 5Gi
+        kraftMetadata: shared
+        class: longhorn
+---
+apiVersion: kafka.strimzi.io/v1beta2
+kind: KafkaNodePool
+metadata:
+  name: broker
+spec:
+...
+  resources:
+    requests:
+      cpu: 500m
+      memory: 1Gi
+    limits:
+      cpu: 1
+      memory: 2Gi
+  storage:
+    type: jbod
+    volumes:
+      - id: 0
+        type: persistent-claim
+        size: 5Gi
+        kraftMetadata: shared
+        class: longhorn
+---
+apiVersion: kafka.strimzi.io/v1beta2
+kind: Kafka
+metadata:
+  name: my-cluster
+spec:
+...
+  entityOperator:
+    topicOperator:
+      resources:
+        requests:
+          memory: 128Mi
+          cpu: 100m
+        limits:
+          memory: 256Mi
+          cpu: 200m
+    userOperator:
+      resources:
+        requests:
+          memory: 128Mi
+          cpu: 100m
+        limits:
+          memory: 256Mi
+          cpu: 200m
+```
+
+### Kafka Connect (Strimzi Operator 사용)
+**Kafka 커넥터 - 데이터 파이프라인**
+
+| 컴포넌트 | Small | Medium | Large |
+|----------|-------|--------|-------|
+| **Kafka Connect** | 500m/1Gi → 1000m/2Gi | 1000m/2Gi → 2000m/4Gi | 2000m/4Gi → 4000m/8Gi |
+
+**권장 사용 시나리오:**
+- Small: 소규모 데이터 파이프라인 (< 5 커넥터)
+- Medium: 중간 규모 데이터 통합 (5-20 커넥터)
+- Large: 대규모 데이터 스트리밍 (20+ 커넥터)
+
+**KafkaConnect CR 설정 예시**
+```yaml
+apiVersion: kafka.strimzi.io/v1beta2
+kind: KafkaConnect
+metadata:
+  name: my-connect
+...
+  resources:
+    requests:
+      cpu: 500m
+      memory: 1Gi
+    limits:
+      cpu: 1000m
+      memory: 2Gi
+```
+
+---
 ## 리소스 요약 테이블
 
 ### 카테고리별 리소스 분류