# hami v2.11.0

> AI & ML · 2026-11-04

アクセラレーター、スケジューリング、監視、リモート GPU、デプロイ機能を広げる保守リリースで、正確性と性能に関する修正も含まれます。アップグレード前には、変更されたデフォルト値、厳格化された検証と互換性要件、依存関係の更新、非推奨メトリクスの確認が必要です。

## 要対応
- **[breaking]** `HAMI-core` の GPU 全体へのマウント廃止
  - GPU 全体の割り当てに `HAMI-core` をマウントしなくなり、メトリクスは `NVML` から直接エクスポートされます。
- **[breaking]** GPU 数、メモリ、コア数のデフォルト値を設定
  - GPU 数、メモリ、コア数のデフォルト値を設定しました。
- **[breaking]** GPU コア使用率の範囲外要求を拒否
  - 範囲 `[0,100]` 外の GPU コア使用率を要求した場合に拒否するようにしました。
- **[breaking]** スケジューラー管理の割り当てアノテーション付き Pod を拒否
  - スケジューラーが管理する割り当てアノテーションを付けて作成された Pod を拒否するようにしました。
- **[breaking]** コンテナ要求量を超える割り当てを拒否
  - コンテナの要求量を超える割り当てを拒否するようにしました。
- **[breaking]** 要求用アノテーションの削除
  - 要求用アノテーションを削除しました。

## 影響確認
- **[breaking]** `/refit` の呼び出し元認証を必須化
  - `/refit` を使用する場合に適用されます。
  - `/refit` の呼び出し元に対する認証を必須にしました。
- **[breaking]** `Kubernetes` 1.23 を必須化
  - `Kubernetes` 1.23 に依存していない場合に適用されます。
  - `Kubernetes` 1.23 を要件としました。
- **[breaking]** `device-config` のデフォルト値の扱いを変更
  - `device-config` を設定する場合に適用されます。
  - `device-config` のデフォルト値には `values.yaml` に記載された値だけを使用するようにしました。
- **[breaking]** Fit での namespace ResourceQuota 検査
  - namespace ResourceQuota を設定する場合に適用されます。
  - Fit で namespace ResourceQuota を確認するようにしました。
- **[breaking]** `hygon` のデフォルトコア値を更新
  - `hygon` を実行する場合に適用されます。
  - `hygon` のデフォルトのコア値を更新しました。
- **[breaking]** `biren` と `cambricon` の不正なデバイス数を拒否
  - `biren` または `cambricon` を実行する場合に適用されます。
  - `biren` と `cambricon` で、0 または負のデバイス数を拒否するようにしました。
- **[breaking]** `nvidia` の小数 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/ja/releases/hami/v2.11.0)

[元のリリースノート](https://github.com/Project-HAMi/HAMi/releases/tag/v2.11.0)