# hami v2.7.1

2026-01-23 · [릴리스 노트 원문](https://github.com/Project-HAMi/HAMi/releases/tag/v2.7.1) · [전체 정리](https://ratatosk.io/ko/releases/hami/v2.7.1)

보안 1 · 호환성 변경 2 · 중요 수정 8 · 의존성 갱신 1 · 기타 12

## 보안 (1)

### Docker 빌드의 `nvidia-mig-parted` 보안 수정

- 영향 대상: `docker/Dockerfile`, `docker/Dockerfile.hamimaster` 또는 `docker/Dockerfile.withlib`에서 빌드한 이미지 (추정)
- [CVE-2025-23266](https://www.cve.org/CVERecord?id=CVE-2025-23266)

이 빌드에서는 이전에 취약점의 영향을 받은 `nvidia-mig-parted` v0.10.0을 설치했습니다. 이제 수정된 버전인 v0.12.2를 설치합니다.

> * fix: upgrade nvidia-mig-parted to v0.12.2 to solve security issues by @Shouren in https://github.com/Project-HAMi/HAMi/pull/1388

## 호환성 변경 (2)

### Cambricon 리소스 할당 키 철자 수정

- 영향 대상: Cambricon 디바이스 구현을 사용하는 HAMi 설정 (추정)

코드와 테스트에서 기존에는 `CAMBRICON_DSMLU_ASSIGHED`를 사용했지만, 이제 둘 다 `CAMBRICON_DSMLU_ASSIGNED`를 사용합니다.

> * fix: fix typos by @DSFans2014 in https://github.com/Project-HAMi/HAMi/pull/1434

### Iluvatar 차트 지원 기본 비활성화

- 영향 대상: Iluvatar GPU를 사용하거나 설정하는 HAMi 설치 환경

이전 차트에서는 일반적인 Iluvatar 리소스 이름을 제공했지만, 이제 모델별 리소스에 `devices.iluvatar.customresources`를 제공합니다. 기존 `iluvatar-name`, `iluvatar-memory`, `iluvatar-cores` 플래그는 `enable-iluvatar`로 대체됩니다.

근거: “This PR improves support for Iluvatar GPUs, including device plugin (gpu-manager) adaptation, scheduling policy compatibility, and resource isolation and sharing capabilities.” https://github.com/Project-HAMi/HAMi/pull/1399

> * Improved support for iluvatar GPUs by @qiangwei1983 in https://github.com/Project-HAMi/HAMi/pull/1399

## 중요 수정 (8)

### 종료된 파드의 디바이스 쿼터 정리 수정

- 영향 대상: 디바이스의 쿼터 사용량이 추적되는 파드

레플리카 수가 1에서 0으로 바뀌면 스케줄러가 삭제 이벤트보다 업데이트 이벤트를 먼저 처리할 수 있었습니다. 이 경우 파드 매니저에서 파드를 먼저 삭제해 디바이스 쿼터 사용량이 정리되지 않았습니다. 이제 스케줄러는 파드 매니저에서 파드를 삭제하기 전에 파드에 기록된 디바이스의 쿼터 사용량을 제거합니다.

> **Fix: Calculation error for quotas by @luohua13 in https://github.com/Project-HAMi/HAMi/pull/1400**

### GPU 플러그인 제거 후 헬스 체크 수정

- 영향 대상: 스케줄러가 `hami.io/node-handshake` 어노테이션을 확인하는 GPU 노드

GPU 노드에서 디바이스 플러그인을 제거하면, 스케줄러와 플러그인이 어노테이션에 서로 다른 prefix 값을 갱신했기 때문에 `CheckHealth`가 `true, true`를 반환했습니다. 이제 헬스 체크는 `util.HandshakeAnnos[devType]`를 통해 어노테이션을 읽습니다.

> * Fix: After removing the device plugin from the gpu node, it can still… by @luohua13 in https://github.com/Project-HAMi/HAMi/pull/1456

### vLLM 관련 문제 대응을 위한 HAMi-core 업데이트

- 영향 대상: 가상 GPU 인덱스 1만 노출한 HAMi vGPU에서 실행되는 vLLM 0.9.2

이 구성에서는 vLLM이 메모리 프로파일링 중 실패하고 `host pid is error!` 메시지를 출력한 뒤 시작을 중단했습니다.

> **Update HAMi-core to fix vllm-related issues: #1381 # 1461 by @archlitchi in https://github.com/Project-HAMi/HAMi/pull/1478**

### `Resourceqota` 하드 쿼터 해제 수정

- 영향 대상: `Resourceqota` 커스텀 리소스

하드 쿼터를 해제했지만 커스텀 리소스가 남아 있을 때, 업데이트 핸들러는 새 오브젝트를 사용해 쿼터 데이터를 삭제하려 했고, 그 결과 기존 쿼터가 해제되지 않았습니다. 이제 스케줄러는 업데이트된 오브젝트를 사용해 쿼터 데이터를 추가하기 전에 이전 오브젝트를 사용해 쿼터 데이터를 삭제합니다.

> **Fix: Calculation error for quotas by @luohua13 in https://github.com/Project-HAMi/HAMi/pull/1400**

### Helm ClusterRoleBinding role 참조 이름 수정

- 영향 대상: release 이름이나 차트 이름이 `hami`가 아닌 Helm 차트 설치

이러한 설치 구성에서는 고정된 `roleRef.name`이 ClusterRole 이름과 일치하지 않아 ClusterRoleBinding이 실패했습니다.

> * Fix: failed clusterrolebinding when change release name or chart name by @FouoF in https://github.com/Project-HAMi/HAMi/pull/1380

### `ReleaseNodeLock`에 nil `pod` 검사 추가

- 영향 대상: `ReleaseNodeLock`을 호출하는 코드 (추정)

일부 경우 nil `pod`를 `ReleaseNodeLock`에 전달하면 panic이 발생할 수 있었습니다.

> * fix: check pod nil in `ReleaseNodeLock` by @DSFans2014 in https://github.com/Project-HAMi/HAMi/pull/1372

### 팟 맵의 얕은 복사본을 반환하는 `GetScheduledPods()`

- 영향 대상: HAMi 스케줄러 (추정)

스케줄러의 팟 맵에서 순회와 쓰기가 동시에 발생해 치명적인 오류가 발생했습니다.

> * Fix concurrent map iteration and map write fatal error. by @litaixun in https://github.com/Project-HAMi/HAMi/pull/1452

### `nodeManager.ListNodes()`의 동시 맵 접근 수정

- 영향 대상: `nodeManager.ListNodes()`를 호출하는 HAMi 스케줄러 코드 (추정)

노드 맵을 동시에 읽고 쓰면 치명적 오류가 발생할 수 있었습니다. 이전에는 `ListNodes()`가 내부 맵을 반환했지만, 이제는 복사한 노드 정보를 반환하며 `NodeInfo`가 nil이거나 `Node`가 nil인 항목은 제외합니다.

> * Fix concurrent map read write fatal error. by @litaixun in https://github.com/Project-HAMi/HAMi/pull/1476

## 의존성 갱신 (1)

그 외 1건 · 보안 언급 없음

- `* Fix release CI by @archlitchi in https://github.com/Project-HAMi/HAMi/pull/1373`

## 기타 (12)

- 릴리스 워크플로에서 주석 처리된 HAMI 이미지 빌드 단계 제거
- E2E 테스트 스크립트의 `go.mod` 기준 Ginkgo 버전 사용
- Pod 삭제 처리가 완료될 때까지 기다리는 스케줄러 리소스 쿼터 테스트
- HAMi 진단 및 메트릭 설명의 맞춤법 수정
- 프로젝트 문서, 예제, 테스트 및 주석 전반의 철자 수정
- NVIDIA 헬퍼 이름 수정
- CI 및 NVIDIA MIG 테스트 업데이트
- `DeviceUsage`에 파드 정보 추가
- NVIDIA GPU NUMA 노드 정보 수집 방식의 sysfs 전환
- 노드와 파드 어노테이션 패치에 `MergePatchType` 사용
- 벤더별 사용자 지정 스케줄링 실패 사유 지원
- HAMi Helm 차트 기본 이미지 태그를 `v2.7.1`로 변경

---

정리 내용은 AI가 작성하므로 틀릴 수 있으며, 보증 없이 제공합니다.
