필사 모드: GPU Operator × KubeVirt 총정리 — 구성요소·설정·버전, 부분 MIG와 수동 MIG까지

오퍼랜드                     역할
─────────────────────────  ─────────────────────────────────────
driver                     NVIDIA 드라이버를 컨테이너로 로드
container-toolkit          런타임이 GPU를 컨테이너에 노출하게 설정
device-plugin              nvidia.com/gpu 리소스를 스케줄러에 광고
gpu-feature-discovery      GPU 모델·메모리·MIG 상태를 노드 라벨로
dcgm-exporter              사용률·온도·전력을 프로메테우스 메트릭으로
mig-manager                노드 라벨 기반 MIG 파티셔닝
node-feature-discovery     하드웨어 감지 (의존 컴포넌트)
validator                  각 단계 검증 잡
(sandbox 계열)             vfio-manager, vgpu-device-manager,
                           kubevirt-gpu-device-plugin — 5부에서

# ClusterPolicy 주요 필드 (발췌)
spec:
  driver:
    enabled: true          # 노드에 드라이버가 이미 있으면 false
    version: "580.65.06"   # 드라이버 버전 고정
  toolkit:
    enabled: true
  mig:
    strategy: mixed        # single | mixed
  migManager:
    enabled: true
    config:
      name: custom-mig-config   # 커스텀 MIG 프로필 ConfigMap
    env:
      - name: WITH_REBOOT       # CSP처럼 재부팅이 필요한 환경
        value: "true"
  devicePlugin:
    config:
      name: time-slicing-config # 시분할 설정도 ConfigMap으로
  sandboxWorkloads:
    enabled: false         # KubeVirt 연동 시 true (5부)

apiVersion: v1
kind: ConfigMap
metadata:
  name: custom-mig-config
  namespace: gpu-operator
data:
  config.yaml: |
    version: v1
    mig-configs:
      # 0번 GPU만 MIG, 1~7번은 그대로
      partial-mig:
        - devices: [0]
          mig-enabled: true
          mig-devices:
            "1g.10gb": 4
            "3g.40gb": 1
        - devices: [1, 2, 3, 4, 5, 6, 7]
          mig-enabled: false

# ① ClusterPolicy가 이 ConfigMap을 보도록 지정 (이미 설정했다면 생략)
kubectl patch clusterpolicies.nvidia.com/cluster-policy --type='json' \
  -p='[{"op":"replace","path":"/spec/migManager/config/name","value":"custom-mig-config"}]'

# ② 전략이 mixed인지 확인 — 프로필이 섞이므로 single로는 표현 불가
kubectl patch clusterpolicies.nvidia.com/cluster-policy --type='json' \
  -p='[{"op":"replace","path":"/spec/mig/strategy","value":"mixed"}]'

# ③ 노드에 프로필 적용
kubectl label nodes <노드> nvidia.com/mig.config=partial-mig --overwrite

# ④ 결과: 리소스가 이렇게 광고됩니다
#   nvidia.com/gpu: 7                ← MIG 안 한 7장
#   nvidia.com/mig-1g.10gb: 4        ← 0번에서 나온 조각들
#   nvidia.com/mig-3g.40gb: 1

# ① MIG 모드 켜기 (GPU 0번만) — 대상 GPU의 프로세스를 먼저 비워야 함
sudo nvidia-smi -i 0 -mig 1
# "Pending" 이 뜨면 GPU 리셋 또는 재부팅 필요:
sudo nvidia-smi --gpu-reset -i 0

# ② 만들 수 있는 GPU 인스턴스(GI) 프로필 확인
nvidia-smi mig -lgip
#  예: H100 80GB → 1g.10gb(ID 19), 2g.20gb(14), 3g.40gb(9), 7g.80gb(0) ...

# ③ GI 생성 — 3g.40gb 하나 + 1g.10gb 네 개, -C 는 컴퓨트 인스턴스(CI)까지 자동 생성
sudo nvidia-smi mig -i 0 -cgi 9,19,19,19,19 -C

# ④ 확인
nvidia-smi mig -lgi        # 생성된 GI 목록
nvidia-smi -L              # MIG 장치 UUID 목록 (MIG-xxxx 형식)

# ⑤ 특정 인스턴스에서 실행 — UUID로 지정
CUDA_VISIBLE_DEVICES=MIG-<uuid> python infer.py

# ⑥ 해제 — CI → GI 순서로 삭제 후 MIG 모드 끄기
sudo nvidia-smi mig -i 0 -dci && sudo nvidia-smi mig -i 0 -dgi
sudo nvidia-smi -i 0 -mig 0

컴포넌트          형태          역할
──────────────  ───────────  ─────────────────────────────────────
virt-operator    Deployment   KubeVirt 자체의 설치·업그레이드 관리
virt-controller  Deployment   클러스터 수준 VM 라이프사이클 (VMI 생성 등)
virt-handler     DaemonSet    노드 수준 데몬 — VMI 스펙과 libvirt 도메인 동기화
virt-launcher    Pod(VM당 1)  VM을 감싸는 파드 — 내부의 libvirtd가 QEMU/KVM 구동

apiVersion: kubevirt.io/v1
kind: KubeVirt
metadata:
  name: kubevirt
  namespace: kubevirt
spec:
  configuration:
    developerConfiguration:
      featureGates:
        - GPU                 # VM에 GPU 할당 허용
        - HostDevices
    permittedHostDevices:     # 어떤 호스트 장치를 VM에 넘길 수 있는가
      pciHostDevices:
        - pciVendorSelector: "10de:2331"     # NVIDIA H100 (vendor:device)
          resourceName: "nvidia.com/GH100_H100_PCIE"
          externalResourceProvider: true     # GPU Operator의 플러그인이 광고

helm install --wait gpu-operator \
  -n gpu-operator --create-namespace \
  nvidia/gpu-operator --version=v26.3.3 \
  --set sandboxWorkloads.enabled=true

값               노드의 용도            깔리는 오퍼랜드
──────────────  ────────────────────  ─────────────────────────────
container        일반 GPU 컨테이너      driver, device-plugin, ... (1부 구성)
vm-passthrough   VM에 GPU 통째로       vfio-manager (vfio-pci 바인딩),
                                       kubevirt-gpu-device-plugin
vm-vgpu          VM에 vGPU 조각        vgpu-manager, vgpu-device-manager

# VirtualMachine 스펙 발췌
spec:
  template:
    spec:
      domain:
        devices:
          gpus:
            - deviceName: nvidia.com/GH100_H100_PCIE
              name: gpu1