Auto Expansion

Auto Expansion은 스토리지 사용량이 설정한 임계값에 도달하면 PVC(PersistentVolumeClaim)를 자동으로 확장해 디스크 부족 오류를 방지합니다. 수동으로 용량을 모니터링하고 리사이즈 작업을 하는 대신, Wave가 PVC 사용량을 지속적으로 추적하다가 애플리케이션이 공간 부족을 겪기 전에 확장을 실행합니다.

How Auto Expansion Works

Auto Expansion은 다음과 같은 지속적인 모니터링과 확장 주기로 동작합니다.

1. Monitor PVC Usage: 확장 작업은 설정 가능한 주기(보통 몇 분 간격)로 실행되며, 설정된 모든 PVC를 점검합니다
2. Compare Usage Against Threshold: 현재 사용률을 계산합니다: (used_bytes / capacity_bytes) × 100
3. Trigger Expansion: 사용률이 설정한 임계값(예: 80%)을 초과하면 확장이 트리거됩니다
4. Calculate Expansion Size: 퍼센트 기반 또는 고정 크기 방식 중 하나로 새 용량을 결정합니다
5. Apply Max Capacity Limit: 설정되어 있다면 최대 용량 범위를 넘지 않도록 확장 크기를 줄입니다
6. Verify StorageClass Support: PVC의 StorageClass에 allowVolumeExpansion: true가 설정되어 있는지 확인합니다
7. Execute Expansion: Kubernetes API를 호출해 PVC의 용량 요청을 새 값으로 업데이트합니다
8. Track Status: Kubernetes PVC의 condition과 할당된 리소스 상태를 통해 확장 진행 상황을 모니터링합니다
9. Log Results: 모든 확장 시도를 타임스탬프, 메트릭, 상태 정보와 함께 기록합니다

Configuration Settings

Auto Expansion은 PVC별로 다음 설정을 사용합니다.

Expansion Status Types

각 확장 시도는 다음 상태값을 거쳐 전이합니다.

Configuration Access

Wave 콘솔에서 Auto Expansion을 설정합니다.

1. Storage → Persistent Volume Claims로 이동합니다
2. 드롭다운에서 클러스터를 선택합니다
3. PVC 이름을 클릭해 상세 페이지를 엽니다
4. Auto Expansion 탭으로 이동합니다
5. Settings 버튼을 클릭합니다 (StorageClass가 확장을 지원해야 활성화됩니다)
6. 임계값, 확장 방식, 선택적으로 최대 용량을 설정합니다
7. OK를 클릭합니다

Auto Expansion 탭에는 다음 내용이 표시됩니다.

• PVC Information Card: 네임스페이스, 이름, 스토리지 클래스, 용량, volume expansion 허용 여부
• Current Usage: 실시간 사용률을 보여주는 진행률 바
• Configuration Card: 현재 설정, 활성화 상태, 생성/수정 타임스탬프
• Usage History Chart: 용량과 사용량 추이를 보여주는 시계열 시각화
• Auto Expansion Logs Table: 모든 확장 시도에 대한 상세 로그

Common Expansion Patterns

워크로드 특성에 맞춰 설정을 선택하세요.

🗄️ Database PVC (비례 성장)

데이터 크기와 스토리지 필요량이 비례하는 데이터베이스에 적합합니다.

Configuration:
  Threshold Percentage: 80%
  Expansion Method: Percentage
  Expansion Percentage: 50%
  Max Capacity: 512000 MiB (500 GiB)
 
Behavior:
  - 10 GiB at 80% usage → expands to 15 GiB
  - 15 GiB at 80% usage → expands to 22.5 GiB
  - Continues until 500 GiB limit reached
  - Prevents runaway costs with max capacity

이 패턴을 선택하는 이유:

• 데이터베이스는 대체로 기존 데이터 양에 비례해 증가합니다
• 퍼센트 확장은 데이터 크기에 자연스럽게 맞춰 확장됩니다
• 최대 용량 설정으로 예상치 못한 비용 급증을 막을 수 있습니다

📝 Log Storage (고정 증분 성장)

성장률이 예측 가능한 로그 파일이나 시계열 데이터에 적합합니다.

Configuration:
  Threshold Percentage: 85%
  Expansion Method: Fixed Size
  Expansion Size: 10240 MiB (10 GiB)
  Max Capacity: 204800 MiB (200 GiB)
 
Behavior:
  - Always adds exactly 10 GiB when threshold hit
  - Predictable capacity planning
  - Works regardless of current size
  - Cap at 200 GiB for cost control

이 패턴을 선택하는 이유:

• 로그 파일은 비교적 일정한 속도로 쌓입니다
• 고정 증분 방식은 용량 계획을 단순하게 만듭니다
• 시간에 따른 스토리지 비용을 예측하기 쉽습니다

💾 Cache Volume (공격적인 무제한 성장)

데이터를 축출(evict)할 수 있지만 용량이 클수록 성능에 도움이 되는 캐시에 적합합니다.

Configuration:
  Threshold Percentage: 75%
  Expansion Method: Percentage
  Expansion Percentage: 100%
  Max Capacity: (not set)
 
Behavior:
  - 10 GiB at 75% usage → doubles to 20 GiB
  - 20 GiB at 75% usage → doubles to 40 GiB
  - No maximum limit (grow as needed)
  - Application handles cache eviction

이 패턴을 선택하는 이유:

• 캐시 성능은 용량이 클수록 좋아집니다
• 공격적으로 두 배씩 늘리면 확장 빈도가 줄어듭니다
• 데이터 축출은 애플리케이션이 내부적으로 관리합니다
• 캐시 데이터는 중요도가 낮으므로 최대 용량을 설정하지 않습니다

Monitoring Expansion Activity

확장 이력과 현재 상태를 추적합니다.

Usage History Chart

시계열 차트에는 다음이 표시됩니다.

• Capacity Line: PVC 용량 추이를 보여주며, 확장이 발생할 때 계단식으로 증가합니다
• Usage Line: 실제 스토리지 소비량을 보여줍니다
• Visual Indicators: 확장 이벤트와 사용량 추이를 한눈에 파악할 수 있습니다
• Time Range: 조회 기간을 설정할 수 있습니다 (최근 24시간, 7일, 30일)

Expansion Logs Table

로그 테이블은 상세한 감사 추적을 제공합니다.

테이블은 다음 기능을 지원합니다.

• Sorting: 컬럼 헤더를 클릭해 원하는 필드로 정렬합니다
• Pagination: 페이지당 10개씩 과거 로그를 탐색합니다
• Color Coding: 상태 배지를 색상으로 구분합니다 (녹색=Completed, 노란색=InProgress, 빨간색=Failed)
• Human Readable Sizes: 용량을 GiB/TiB 단위로 읽기 쉽게 표시합니다

Troubleshooting

# Check current StorageClass
kubectl get storageclass <storage-class-name> -o yaml
 
# Update to enable expansion
kubectl patch storageclass <storage-class-name> -p '{"allowVolumeExpansion": true}'
 
# Verify the change
kubectl get storageclass <storage-class-name> -o jsonpath='{.allowVolumeExpansion}'

Best Practices

Related Documentation

• PV Lifecycle 개요: 전체 PV Lifecycle Management 시스템을 이해합니다
• 시작하기: Auto Expansion 단계별 설정 가이드
• Auto Clean Up: unused PV 감지와 정리 방법을 알아봅니다