# hami v2.11.0

> AI & ML · 2026-11-04

A broad maintenance release that expands accelerator, scheduling, monitoring, remote-GPU, and deployment capabilities while correcting validation and performance issues. Operators should review changed defaults, the Kubernetes 1.23 requirement, stricter validation, dependency updates, and deprecated metrics before upgrading.

## Action needed
- **[breaking]** `HAMI-core` mounting removed
  - This release no longer mounts `HAMI-core` to the whole GPU allocation. Metrics are exported directly by NVML.
- **[breaking]** GPU count, memory, and core defaults
  - The default GPU count, memory, and cores are now set by default.
- **[breaking]** GPU core percentage range validation
  - GPU core percentage requests outside the range [0,100] are rejected.
- **[breaking]** Scheduler-owned allocation annotation validation
  - Pods created with scheduler-owned allocation annotations are denied.
- **[breaking]** Allocation size validation
  - The device plugin rejects allocations larger than the container requests.
- **[breaking]** Requesting annotations removed
  - Requesting annotations are removed.

## Check if affected
- **[breaking]** Caller authentication for `/refit`
  - Applies if you use `/refit`.
  - Caller authentication is now required on `/refit`.
- **[breaking]** `Kubernetes` 1.23 requirement
  - Applies if you do not depend on `Kubernetes` 1.23.
  - This release requires `Kubernetes` 1.23.
- **[breaking]** `device-config` defaults from `values.yaml`
  - Applies if you configure `device-config`.
  - Only values in `values.yaml` are used as defaults for `device-config`.
- **[breaking]** Namespace ResourceQuota checking in Fit
  - Applies if you configure namespace ResourceQuota.
  - Fit now checks the namespace ResourceQuota.
- **[breaking]** Hygon default core value
  - Applies if you run `hygon`.
  - The default core value for hygon is updated.
- **[breaking]** Invalid device count rejection
  - Applies if you run `biren` or `cambricon`.
  - Invalid device counts of zero or negative values are rejected across biren and cambricon.
- **[breaking]** NVIDIA fractional GPU memory validation
  - Applies if you run `nvidia`.
  - Fractional GPU memory percentages are rejected for NVIDIA devices.

## Plan ahead
- **[deprecated]** `hami_container_device_memory_bytes` metric deprecation
  - Applies if you use `hami_container_device_memory_bytes`.
  - The `hami_container_device_memory_bytes` metric is deprecated.
- **[deprecated]** `limit` label on `hami_resource_quota_used`
  - Applies if you use `hami_resource_quota_used`.
  - The `limit` label of the `hami_resource_quota_used` metric is deprecated.

## Other recorded changes
- 176 (defect_corrected 98, added 42, value_changed 23, constraint_changed 9, renamed 3, removed 1)

[Full analysis](https://ratatosk.io/en/releases/hami/v2.11.0)

[Original release notes](https://github.com/Project-HAMi/HAMi/releases/tag/v2.11.0)