Add iSCSI StorageClass (democratic-csi) docs

infra/nfs-storage.md

@@ -1,7 +1,7 @@
 ---
-title: NFS StorageClass (NAS)
+title: NAS StorageClass (NFS + iSCSI)
 updated: 2026-04-05
-tags: [infra, k3s, storage, nfs, synology]
+tags: [infra, k3s, storage, nfs, iscsi, synology]
 ---
 
 ## 개요
@@ -96,7 +96,45 @@ kr2에서 NAS NFS가 `hard` 마운트 + NAS 연결 끊김으로 load 1959까지
 
 모든 NFS 마운트는 `soft,timeo=50,retrans=3` 필수.
 
+## iSCSI StorageClass (democratic-csi)
+
+Synology NAS의 iSCSI를 K3s 블록 스토리지로 사용. democratic-csi가 PVC 생성/삭제 시 자동으로 iSCSI Target + LUN을 관리.
+
+| 항목 | 값 |
+|------|-----|
+| StorageClass | `synology-iscsi` |
+| CSI Driver | democratic-csi (Helm) |
+| Namespace | `democratic-csi` |
+| iSCSI Portal | 192.168.205.100:3260 |
+| Base IQN | `iqn.2000-01.com.synology:NAS.k3s.` |
+| LUN 타입 | BLUN (Btrfs thin provisioning) |
+| Volume | /volume1 |
+| 인증 | kaffa 계정 (HTTPS API) |
+| 자동 관리 | PVC 생성 → Target+LUN 생성, PVC 삭제 → Target+LUN 삭제 |
+
+### Helm 설치
+
+values 파일: `/tmp/democratic-csi-values.yaml` (kr1)
+
+```bash
+export KUBECONFIG=/etc/rancher/k3s/k3s.yaml
+helm repo add democratic-csi https://democratic-csi.github.io/charts/
+helm install synology-iscsi democratic-csi/democratic-csi \
+  --namespace democratic-csi --create-namespace \
+  -f /tmp/democratic-csi-values.yaml
+```
+
+### 전체 StorageClass 요약
+
+| StorageClass | 방식 | 용도 | HA |
+|---|---|---|---|
+| longhorn | 로컬 NVMe 블록 | DB, 고성능 블록 | 노드 간 레플리카 |
+| synology-iscsi | NAS iSCSI 블록 | 블록 스토리지 (NAS) | RAID5 |
+| nfs | NAS NFS 파일 | 파일, 웹소스, RWX | RAID5 |
+| local-path | 로컬 디스크 | 캐시, 임시 | 없음 |
+
 ## 관련 문서
 
 - [[backup]] — 백업 파이프라인 (NAS 활용)
+- [[storage-plan]] — NVMe NAS + 2.5G iSCSI 기획
 - [[infra-hosts]] — 서버 목록