diff --git a/infra/nfs-storage.md b/infra/nfs-storage.md index 1884bca..ec78003 100644 --- a/infra/nfs-storage.md +++ b/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]] — 서버 목록