Dynamia ascend-device-plugin Chart 0.3.1
Release date: 2026-10-26
| Version | Previous | Current |
|---|---|---|
| Chart | 0.3.0 | 0.3.1 |
| appVersion | v1.4.3 | v1.4.3 |
Chart 0.3.1 is a deployment patch for 0.3.0. It completes the configuration and mounts needed by the existing v1.4.3 application. The application image and bundled libvnpu version remain unchanged. See Chart 0.3.0 for their open-source baselines, Enterprise extensions, and application changes.
HAMi Enterprise compatibility
| Feature or mode | Minimum HAMi Enterprise version | Companion requirements and upgrade guidance |
|---|---|---|
| Template-based hardware partitioning | v2.9.0-rc0 | The existing scheduler can be retained. |
hami-core static soft partitioning | v2.10.0-r2 | Retains the runtime authorization requirement introduced with application v1.4.3. This patch does not require another Enterprise upgrade when that requirement is already met. |
| Automatic memory expansion | v2.10.0-r2 | Retains single-vNPU ordinary-container scope, approval and admission requirements, and the companion Chart's Kubernetes 1.30 minimum. |
ENPU scheduling or hami-core compute oversell with deviceCoreScaling greater than 1 | v2.10.0-r5 | Requires the corresponding scheduler backend and resource-accounting support, with matching shared-device and node configuration. Updating the plugin Chart alone does not provide this companion functionality. |
Changes
Chart changes
- [Enterprise feature] Completes ENPU deployment mounts for
/usr/local/enpu/vcann-rt, the per-container configuration root (default/var/lib/hami-enpu), and read-only host process information at/host/proc. Adds the correspondingenpu.*environment and configuration values, withelasticas the default ENPU policy. Optional manager settings select the node-local manager and configuration directory. - [Enterprise feature] Adds the explicit
hamiVnpuModebackend selector and rendershamiCorePolicy,deviceCoreScaling, andenpuPolicyinto bundled device configuration. An empty selector retains the legacyhamiVnpuCore.enabledfallback; a node-level mode takes precedence. Invalid values fail rendering. - [Enterprise feature] Changes
hamiVnpuCore.coreUtilizationPolicyfromforcetodefaultand addshamiVnpuCore.defaultPolicy=spatial. Explicitforceanddisableretain precedence over scheduling-policy selection. This changes the default compute-control behavior even though the application version stays the same. - [Enterprise feature] Adds
hamiVnpuCore.deviceCoreScaling, defaulting to1, to configure advertised compute oversell. Values greater than1increase schedulable compute points; they do not increase physical compute capacity.
There is no application-version update in this patch. Multi-card control, the ENPU backend, and runtime authorization belong to application v1.4.3, described in the 0.3.0 release note.
Upgrade guidance
- Review compute-policy settings before upgrading. To retain the
0.3.0behavior, explicitly sethamiVnpuCore.coreUtilizationPolicy=force. To adopt the new defaults, usedefaultandspatial; check workloadNPU_CORE_UTILIZATION_POLICY, Podhuawei.com/npu-sched-policy, and nodehamiCorePolicyoverrides. Spatial control uses cooperative core budgets and does not guarantee proportional inference throughput. - With
config.create=false, update the HAMi-managed shared-device configuration and relevant node settings. Changing only this plugin Chart's bundleddeviceConfigdoes not change an external ConfigMap. UsehamiVnpuMode: enpuon ENPU nodes and explicitly selecthuawei.com/vnpu-mode: enpuon their workloads. Forhami-core, retain the matching mode and scheduling policy. Stop or reschedule affected workloads before changing a node's backend. - Before using ENPU or compute oversell, meet the
v2.10.0-r5companion requirement. SetdeviceCoreScalingconsistently in scheduler and plugin configuration, and leave it at1when oversell is not intended. ENPU's effective virtual-device count is capped at100per physical device; a container uses one physical DIE. - Follow the ENPU asset and workload prerequisites in the Ascend deployment guide, including compatible driver/runtime assets, the Ascend container-runtime handler, workload utilities, and node-local manager connectivity when using mem-swap. The bundled runtime provides basic soft partitioning; mem-swap needs a separately prepared supporting runtime and manager. The manager address must reach the plugin's own node.
- Retain the default image
ghcr.io/dynamia-ai/ascend-device-plugin:v1.4.3or its matching immutable digest. If the runtime-state migration required by0.3.0has already been completed, this Chart-only patch does not require repeating it. Deployments still using an older application must first follow the 0.3.0 migration steps.
Apply the configuration through the existing Helm release, confirm that the DaemonSet rolls out and the plugin reloads it, then verify device registration and the selected backend before recreating workloads.
Values reference
The parameter descriptions below are preserved from the README bundled with Chart 0.3.1. The original values.yaml from that package defines its defaults.
Expand values table
| Key | Type | Default | Description |
|---|---|---|---|
| config.create | bool | false | Create the bundled device configuration ConfigMap for an installation without HAMi. Leave disabled when HAMi owns the device configuration. |
| config.deviceConfigMapName | string | "hami-scheduler-device" | Name of the device configuration ConfigMap created when config.create=true. |
| config.existingDeviceConfigMapName | string | "hami-scheduler-device" | HAMi-managed device configuration ConfigMap to reuse when config.create=false. The ConfigMap must be in the release namespace. |
| daemonSet.args[0] | string | "--config_file" | |
| daemonSet.args[1] | string | "/device-config.yaml" | |
| daemonSet.args[2] | string | "--v=4" | |
| daemonSet.args[3] | string | "--node_config_file" | |
| daemonSet.args[4] | string | "/node-config.yaml" | |
| daemonSet.name | string | "hami-ascend-device-plugin" | Device plugin DaemonSet name. |
| deviceSplitCount | int | 10 | Number of virtual devices advertised per physical Ascend NPU in hami-core or enpu mode when this chart creates the device configuration. A positive node-level vDeviceCount overrides it; ENPU caps the count at 100. |
| enpu.configRoot | string | "/var/lib/hami-enpu" | Host directory for per-container ENPU configs. |
| enpu.defaultPolicy | string | "elastic" | Default ENPU scheduling policy. |
| enpu.exposeAllDevices | bool | false | Expose all davinci devices; keep false for device isolation. |
| enpu.managerConfigRoot | string | "" | Manager config_dir or its vcann-rt subdirectory; empty uses configRoot. |
| enpu.managerURL | string | "" | Optional node-local enpu-manager REST endpoint. |
| enpu.monitorPath | string | "/usr/local/enpu/vcann-rt/tools/enpu-monitor" | Host path to enpu-monitor. |
| enpu.preloadPath | string | "/usr/local/enpu/vcann-rt/ld.so.preload" | Host path to ld.so.preload. |
| enpu.runtimePath | string | "/usr/local/enpu/vcann-rt/lib/libvruntime.so" | Host path to libvruntime.so. |
| enpu.systemdDetectVirtPath | string | "" | Optional host binary; prefer providing it in the workload image. |
| fullnameOverride | string | "" | Override the fully qualified resource name. |
| hamiVnpuCore.coreUtilizationPolicy | string | "default" | Default utilization override for containers without NPU_CORE_UTILIZATION_POLICY. default permits hamiCorePolicy (spatial by default); explicit force and disable retain precedence. |
| hamiVnpuCore.defaultPolicy | string | "spatial" | Default hami-core compute policy: spatial, dynamic, fixed, or overdraft. Pod huawei.com/npu-sched-policy and node hamiCorePolicy override it. |
| hamiVnpuCore.deviceCoreScaling | float | 1 | hami-core compute oversell ratio. The plugin advertises Devcore = round(100 * deviceCoreScaling) so HAMi can admit more than 100% of -core on one card. Values below 1 are not supported. |
| hamiVnpuCore.enabled | bool | false | Enable hami-vnpu-core in the bundled device configuration when config.create=true. This mode requires the HAMi scheduler. |
| hamiVnpuMode | string | "" | Default backend: template, hami-core (alias hamiCore), or enpu. Empty uses template, or hami-core if the deprecated hamiVnpuCore.enabled is true. Node mode takes priority. |
| image.digest | string | "" | Optional immutable OCI manifest digest. When set, it takes precedence over image.tag. |
| image.pullPolicy | string | "IfNotPresent" | Kubernetes image pull policy. |
| image.repository | string | "ghcr.io/dynamia-ai/ascend-device-plugin" | Container image repository. |
| image.tag | string | "" | Container image tag. Defaults to the chart appVersion when empty. |
| nameOverride | string | "" | Override the chart name used in resource names. |
| nodeConfig | string | "nodes: []" | Per-node hami-vnpu-core configuration written to the node ConfigMap. |
| nodeConfigMap.create | bool | true | Create the per-node configuration ConfigMap. |
| nodeConfigMap.name | string | "hami-device-node-config" | Per-node configuration ConfigMap name. |
| nodeSelector.ascend | string | "on" | Node label value used to schedule the device plugin. |
| rbac.name | string | "hami-ascend" | Name shared by the chart-managed RBAC resources. |
| resources.limits.cpu | string | "500m" | |
| resources.limits.memory | string | "500Mi" | |
| resources.requests.cpu | string | "500m" | |
| resources.requests.memory | string | "500Mi" | |
| runtimeClass.create | bool | true | Create the Ascend RuntimeClass. |
| runtimeClass.handler | string | "ascend" | Container runtime handler used by the RuntimeClass. |
| runtimeClass.name | string | "ascend" | RuntimeClass resource name. |
| serviceAccount.create | bool | true | Create a ServiceAccount for the device plugin. |
| serviceAccount.name | string | "hami-ascend" | ServiceAccount name. |
| vnpuMonitor.enabled | bool | false | Expose device plugin metrics and create optional Prometheus Operator resources. |
| vnpuMonitor.prometheusRule.create | bool | true | Create a PrometheusRule when vnpuMonitor.enabled=true. |
| vnpuMonitor.prometheusRule.groupLabels.vendor | string | "ascend" | |
| vnpuMonitor.prometheusRule.groupName | string | "ascend-vnpu" | Recording-rule group name. |
| vnpuMonitor.prometheusRule.interval | string | "15s" | Recording-rule evaluation interval. |
| vnpuMonitor.prometheusRule.labels.release | string | "prometheus" | |
| vnpuMonitor.prometheusRule.labels.role | string | "recording-rules" | |
| vnpuMonitor.prometheusRule.labels.vendor | string | "ascend" | |
| vnpuMonitor.prometheusRule.name | string | "hami-ascend-vnpu-monitor" | PrometheusRule resource name. |
| vnpuMonitor.prometheusRule.namespace | string | "monitoring" | Namespace for the PrometheusRule. |
| vnpuMonitor.service.name | string | "hami-ascend-device-plugin-metrics" | Headless Service that exposes the device plugin metrics port. |
| vnpuMonitor.serviceMonitor.create | bool | true | Create a ServiceMonitor when vnpuMonitor.enabled=true. |
| vnpuMonitor.serviceMonitor.interval | string | "15s" | Prometheus scrape interval. |
| vnpuMonitor.serviceMonitor.labels.release | string | "prometheus" | |
| vnpuMonitor.serviceMonitor.name | string | "hami-ascend-vnpu-monitor" | ServiceMonitor resource name. |
| vnpuMonitor.serviceMonitor.namespace | string | "monitoring" | Namespace for the ServiceMonitor. |
| vnpuMonitor.serviceMonitor.path | string | "/metrics" | Metrics HTTP path. |