# hami v2.11.0

> AI & ML · 2026-11-04

가속기, 스케줄링, 모니터링, 원격 GPU, 배포 기능을 넓히고 정확성과 성능 문제를 폭넓게 바로잡은 유지보수 릴리스입니다. 업그레이드 전 변경된 기본값과 더 엄격해진 검증 및 호환성 조건, 의존성 변경, 더 이상 권장되지 않는 메트릭을 확인해야 합니다.

## 조치 필요
- **[breaking]** `HAMI-core` 마운트 제거
  - 전체 GPU 할당에 `HAMI-core`를 마운트하지 않고, 메트릭을 `NVML`에서 직접 내보냅니다.
- **[breaking]** GPU 수와 메모리 및 코어 기본값 설정
  - GPU 수, 메모리, 코어를 기본값으로 설정합니다.
- **[breaking]** GPU 코어 비율 범위 검증
  - GPU 코어 비율이 `[0,100]` 범위를 벗어난 요청을 거부합니다.
- **[breaking]** 스케줄러 소유 할당 주석이 있는 파드 거부
  - 스케줄러가 소유한 할당 주석이 있는 파드 생성을 거부합니다.
- **[breaking]** 컨테이너 요청량 초과 할당 거부
  - 컨테이너 요청량보다 큰 할당을 거부합니다.
- **[breaking]** 요청 주석 제거
  - 요청 주석을 제거합니다.

## 영향 확인
- **[breaking]** `/refit` 호출자 인증 요구
  - `/refit`을 사용하는 경우에 적용됩니다.
  - 호출자 인증을 요구합니다.
- **[breaking]** `Kubernetes` 1.23 요구
  - `Kubernetes` 1.23에 의존하지 않는 경우에 적용됩니다.
  - `Kubernetes` 1.23을 요구합니다.
- **[breaking]** `device-config` 기본값 적용 방식 변경
  - `device-config`를 설정하는 경우에 적용됩니다.
  - `values.yaml`의 값만 `device-config`의 기본값으로 사용합니다.
- **[breaking]** `Fit`의 네임스페이스 `ResourceQuota` 확인
  - 네임스페이스 `ResourceQuota`를 설정한 경우에 적용됩니다.
  - `Fit`에서 네임스페이스 `ResourceQuota`를 확인합니다.
- **[breaking]** `hygon` 기본 코어 값 변경
  - `hygon`을 실행하는 경우에 적용됩니다.
  - `hygon`의 기본 코어 값을 업데이트합니다.
- **[breaking]** 잘못된 장치 수 요청 거부
  - `biren` 또는 `cambricon`을 실행하는 경우에 적용됩니다.
  - `biren`과 `cambricon`에서 장치 수가 0이거나 음수인 요청을 거부합니다.
- **[breaking]** GPU 메모리 소수 비율 요청 거부
  - `nvidia`를 실행하는 경우에 적용됩니다.
  - GPU 메모리 비율의 소수값 요청을 거부합니다.

## 미리 준비
- **[deprecated]** `hami_container_device_memory_bytes` 사용 중단 예고
  - `hami_container_device_memory_bytes`를 사용하는 경우에 적용됩니다.
  - `hami_container_device_memory_bytes` 메트릭을 더 이상 권장하지 않습니다.
- **[deprecated]** `hami_resource_quota_used`의 `limit` 레이블 사용 중단 예고
  - `hami_resource_quota_used`를 사용하는 경우에 적용됩니다.
  - `hami_resource_quota_used` 메트릭의 `limit` 레이블을 더 이상 권장하지 않습니다.

## 그 밖에 기록된 변경
- 176 (defect_corrected 98, added 42, value_changed 23, constraint_changed 9, renamed 3, removed 1)

[분석 자세히 보기](https://ratatosk.io/ko/releases/hami/v2.11.0)

[원본 릴리스 노트](https://github.com/Project-HAMi/HAMi/releases/tag/v2.11.0)