# hami v2.7.1

2026-01-23 · [元のリリースノート](https://github.com/Project-HAMi/HAMi/releases/tag/v2.7.1) · [全体のまとめ](https://ratatosk.io/ja/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 ノードからデバイスプラグインが削除された際、スケジューラーとプラグインがアノテーションに異なるプレフィックス値を設定していたため、`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

### HAMi-core の更新による vLLM 関連問題への対応

- 影響対象: HAMi vGPU 上で仮想 GPU インデックス 1（`CUDA_VISIBLE_DEVICES=1`）のみを公開している 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 reference 名の修正

- 影響対象: リリース名またはチャート名が `hami` 以外の Helm chart インストール

これらのインストールでは、固定の `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` または `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 イメージビルド手順の削除
- `go.mod` の Ginkgo バージョンを使用する E2E テストスクリプト
- Pod の削除処理を待つスケジューラーのリソースクォータテスト
- HAMi の診断メッセージとメトリクス説明のスペル修正
- プロジェクトのドキュメント、例、テスト、コメント全体にわたるスペル修正
- NVIDIA ヘルパー名の修正
- CI と NVIDIA MIG テストの更新
- `DeviceUsage` に Pod 情報を追加
- NVIDIA GPU の NUMA ノード取得を sysfs に切り替え
- Node と Pod のアノテーションパッチでの `MergePatchType` の使用
- ベンダー独自のスケジューリング失敗理由に対応
- HAMi Helm chart のデフォルトイメージタグを `v2.7.1` に変更

---

整理した内容は AI が作成するため誤っている可能性があり、無保証で提供されます。
