HAMi Enterprise 2.9.0-rc1

Chart version	Declared appVersion	Release date
2.9.0-rc1	2.9.0-rc1	2026-05-27

This is a patch release. Changes below are compared with HAMi Enterprise v2.9.0-rc0.

Software changes

Fixes the mapping between NVIDIA device annotations and regular containers in Pods that contain init containers. When device-allocation information is passed through the Downward API, the annotation position for a regular container now accounts for the number of init containers. This prevents an init-container position from being used for a regular container.

This fix applies to deployments with nvidia.useDownward: true in the device configuration, which the device configuration generated by this Chart enables by default. This release still skips GPU device annotations on init containers themselves; it does not provide complete support for GPU use in init containers.

Chart changes

• The scheduler's ClusterRole adds get, list, and watch permissions for deviceclasses, resourceclaims, resourceclaimtemplates, and resourceslices in the resource.k8s.io API group. This resolves permission errors when kube-scheduler watches these resources. It only adds scheduler permissions; it does not enable dra.enabled, which remains disabled by default.
• The default global.imageTag is updated to v2.9.0-rc1. The default image repository for the scheduler extender, NVIDIA device plugin, and monitor container remains ghcr.io/dynamia-ai/hami.
• The Chart remains named hami, the package is hami-2.9.0-rc1.tgz, and the default schedulerName remains hami-scheduler.

Upgrade notes

If you manage scheduler RBAC yourself, add read-only permissions for the four resource types listed above. Deployments where the Chart manages RBAC receive the updated permissions during upgrade.

For NVIDIA workloads with init containers, check the device-allocation annotations and actual visible devices on newly created Pods after upgrading. The scheduler upgrade does not automatically rerun device allocation for existing Pods.

Obtain the package through the agreed delivery channel. See the Chart and appVersion mapping or the software center.

Values reference

The following parameter descriptions are taken from the README bundled with the Chart 2.9.0-rc1 release package and are preserved as published. Use this version's values.yaml as the source of default configuration.

Expand values table

Global Configuration

Parameter	Description	Default Value
global.imageRegistry	Global Docker image registry	""
global.imagePullSecrets	Global Docker image pull secrets	[]
global.imageTag	Image tag	"v2.8.0"
global.gpuHookPath	GPU Hook path	/usr/local
global.labels	Global labels	{}
global.annotations	Global annotations	{}
global.managedNodeSelectorEnable	Whether to enable managed node selector	false
global.managedNodeSelector.usage	Managed node selector usage	"gpu"
nameOverride	Name override	""
fullnameOverride	Full name override	""
namespaceOverride	Namespace override	""

Resource Name Configuration

NVIDIA GPU Resources

Parameter	Description	Default Value
resourceName	GPU resource name	"nvidia.com/gpu"
resourceMem	GPU memory resource name	"nvidia.com/gpumem"
resourceMemPercentage	GPU memory percentage resource name	"nvidia.com/gpumem-percentage"
resourceCores	GPU core resource name	"nvidia.com/gpucores"
resourcePriority	GPU priority resource name	"nvidia.com/priority"

Cambricon MLU Resources

Parameter	Description	Default Value
mluResourceName	MLU resource name	"cambricon.com/vmlu"
mluResourceMem	MLU memory resource name	"cambricon.com/mlu.smlu.vmemory"
mluResourceCores	MLU core resource name	"cambricon.com/mlu.smlu.vcore"

Hygon DCU Resources

Parameter	Description	Default Value
dcuResourceName	DCU resource name	"hygon.com/dcunum"
dcuResourceMem	DCU memory resource name	"hygon.com/dcumem"
dcuResourceCores	DCU core resource name	"hygon.com/dcucores"

Metax GPU Resources

Parameter	Description	Default Value
metaxResourceName	GPU resource name	"metax-tech.com/sgpu"
metaxResourceCore	GPU core resource name	"metax-tech.com/vcore"
metaxResourceMem	GPU memory resource name	"metax-tech.com/vmemory"
metaxsGPUTopologyAware	GPU topology awareness	"false"

Enflame GCU Resources

Parameter	Description	Default Value
enflameResourceNameVGCU	vGCU resource name	"enflame.com/vgcu"
enflameResourceNameVGCUPercentage	vGCU percentage resource name	"enflame.com/vgcu-percentage"

Kunlunxin XPU Resources

Parameter	Description	Default Value
kunlunResourceName	XPU resource name	"kunlunxin.com/xpu"

Scheduler Configuration

Parameter	Description	Default Value
schedulerName	Scheduler name	"hami-scheduler"
scheduler.nodeName	Define node name, scheduler will schedule to this node	""
scheduler.overwriteEnv	Whether to overwrite environment variables	"false"
scheduler.defaultSchedulerPolicy.nodeSchedulerPolicy	Node scheduler policy	binpack
scheduler.defaultSchedulerPolicy.gpuSchedulerPolicy	GPU scheduler policy	spread
scheduler.metricsBindAddress	Metrics bind address	":9395"
scheduler.forceOverwriteDefaultScheduler	Whether to force overwrite default scheduler	true
scheduler.livenessProbe	Whether to enable liveness probe	false
scheduler.leaderElect	Whether to enable leader election	true
scheduler.replicas	Number of replicas	1

Kube Scheduler Configuration

Parameter	Description	Default Value
scheduler.kubeScheduler.enabled	Whether to run kube-scheduler container in scheduler pod	true
scheduler.kubeScheduler.image.registry	Kube scheduler image registry	"registry.cn-hangzhou.aliyuncs.com"
scheduler.kubeScheduler.image.repository	Kube scheduler image repository	"google_containers/kube-scheduler"
scheduler.kubeScheduler.image.tag	Kube scheduler image tag	""
scheduler.kubeScheduler.image.pullPolicy	Kube scheduler image pull policy	IfNotPresent
scheduler.kubeScheduler.image.pullSecrets	Kube scheduler image pull secrets	[]
scheduler.kubeScheduler.extraNewArgs	Extra new arguments	["--config=/config/config.yaml", "-v=4"]
scheduler.kubeScheduler.extraArgs	Extra arguments	["--policy-config-file=/config/config.json", "-v=4"]

Extender Configuration

Parameter	Description	Default Value
scheduler.extender.image.registry	Scheduler extender image registry	"docker.io"
scheduler.extender.image.repository	Scheduler extender image repository	"projecthami/hami"
scheduler.extender.image.tag	Scheduler extender image tag	""
scheduler.extender.image.pullPolicy	Scheduler extender image pull policy	IfNotPresent
scheduler.extender.image.pullSecrets	Scheduler extender image pull secrets	[]
scheduler.extender.extraArgs	Scheduler extender extra arguments	["--debug", "-v=4"]

Admission Webhook Configuration

Parameter	Description	Default Value
scheduler.admissionWebhook.enabled	Whether to enable admission webhook	true
scheduler.admissionWebhook.customURL.enabled	Whether to enable custom URL	false
scheduler.admissionWebhook.customURL.host	Custom URL host	127.0.0.1
scheduler.admissionWebhook.customURL.port	Custom URL port	31998
scheduler.admissionWebhook.customURL.path	Custom URL path	/webhook
scheduler.admissionWebhook.reinvocationPolicy	Reinvocation policy	Never
scheduler.admissionWebhook.failurePolicy	Failure policy	Ignore

TLS Certificate Configuration

Parameter	Description	Default Value
scheduler.certManager.enabled	Whether to use cert-manager to generate self-signed certificates	false
scheduler.patch.enabled	Whether to use kube-webhook-certgen to generate self-signed certificates	true
scheduler.patch.image.registry	Certgen image registry	"docker.io"
scheduler.patch.image.repository	Certgen image repository	"jettech/kube-webhook-certgen"
scheduler.patch.image.tag	Certgen image tag	"v1.5.2"
scheduler.patch.image.pullPolicy	Certgen image pull policy	IfNotPresent
scheduler.patch.imageNew.registry	New certgen image registry	"docker.io"
scheduler.patch.imageNew.repository	New certgen image repository	"liangjw/kube-webhook-certgen"
scheduler.patch.imageNew.tag	New certgen image tag	"v1.1.1"

Scheduler Service Configuration

Parameter	Description	Default Value
scheduler.service.type	Service type	NodePort
scheduler.service.httpPort	HTTP port	443
scheduler.service.schedulerPort	Scheduler NodePort	31998
scheduler.service.monitorPort	Monitor port	31993
scheduler.service.monitorTargetPort	Monitor target port	9395

Device Plugin Configuration

Parameter	Description	Default Value
devicePlugin.image.registry	Device plugin image registry	"docker.io"
devicePlugin.image.repository	Device plugin image repository	"projecthami/hami"
devicePlugin.image.tag	Device plugin image tag	""
devicePlugin.image.pullPolicy	Device plugin image pull policy	IfNotPresent
devicePlugin.image.pullSecrets	Device plugin image pull secrets	[]

Monitor Configuration

Parameter	Description	Default Value
devicePlugin.monitor.image.registry	Monitor image registry	"docker.io"
devicePlugin.monitor.image.repository	Monitor image repository	"projecthami/hami"
devicePlugin.monitor.image.tag	Monitor image tag	""
devicePlugin.monitor.image.pullPolicy	Monitor image pull policy	IfNotPresent
devicePlugin.monitor.image.pullSecrets	Monitor image pull secrets	[]
devicePlugin.monitor.ctrPath	Container path	/usr/local/vgpu/containers
devicePlugin.monitor.extraArgs	Monitor extra arguments	["-v=4"]
devicePlugin.monitor.extraEnvs	Monitor extra environments	{}

Device Plugin Other Configuration

Parameter	Description	Default Value
devicePlugin.deviceSplitCount	Integer type, default value: 10. Maximum number of tasks assigned to a single GPU device	10
devicePlugin.deviceMemoryScaling	Device memory scaling ratio	1
devicePlugin.deviceCoreScaling	Device core scaling ratio	1
devicePlugin.runtimeClassName	Runtime class name	""
devicePlugin.createRuntimeClass	Whether to create runtime class	false
devicePlugin.migStrategy	String type, "none" means ignore MIG functionality, "mixed" means allocate MIG devices through independent resources	"none"
devicePlugin.disablecorelimit	String type, "true" means disable core limit, "false" means enable core limit	"false"
devicePlugin.passDeviceSpecsEnabled	Whether to enable passing device specs	false
devicePlugin.extraArgs	Device plugin extra arguments	["-v=4"]
devicePlugin.nodeConfiguration.config	Node configuration for device plugin by json	An example of default configuration.
devicePlugin.nodeConfiguration.externalConfigName	Node configuration for device plugin by external congimap	""
devicePlugin.extraEnvs	Device plugin extra environments	{}

Device Plugin Service Configuration

Parameter	Description	Default Value
devicePlugin.service.type	Service type	NodePort
devicePlugin.service.httpPort	HTTP port	31992

Device Plugin Deployment Configuration

Parameter	Description	Default Value
devicePlugin.pluginPath	Plugin path	/var/lib/kubelet/device-plugins
devicePlugin.libPath	Library path	/usr/local/vgpu
devicePlugin.nvidiaNodeSelector	NVIDIA node selector	{"gpu": "on"}
devicePlugin.updateStrategy.type	Update strategy type	RollingUpdate
devicePlugin.updateStrategy.rollingUpdate.maxUnavailable	Maximum unavailable count	1

Device Configuration

AWS Neuron

Parameter	Description	Default Value
devices.awsneuron.customresources	Custom resources	["aws.amazon.com/neuron", "aws.amazon.com/neuroncore"]

Kunlunxin

Parameter	Description	Default Value
devices.kunlun.enabled	Whether to enable	true
devices.kunlun.customresources	Custom resources	["kunlunxin.com/xpu"]

Mthreads

Parameter	Description	Default Value
devices.mthreads.enabled	Whether to enable	true
devices.mthreads.customresources	Custom resources	["mthreads.com/vgpu"]

NVIDIA

Parameter	Description	Default Value
devices.nvidia.gpuCorePolicy	GPU core policy	default
devices.nvidia.libCudaLogLevel	CUDA library log level	1

Huawei Ascend

Parameter	Description	Default Value
devices.ascend.enabled	Whether to enable	false
devices.ascend.image	Image	""
devices.ascend.imagePullPolicy	Image pull policy	IfNotPresent
devices.ascend.extraArgs	Extra arguments	[]
devices.ascend.nodeSelector	Node selector	{"ascend": "on"}
devices.ascend.tolerations	Tolerations	[]
devices.ascend.customresources	Custom resources	["huawei.com/Ascend910A", "huawei.com/Ascend910A-memory", ...]

Iluvatar

Parameter	Description	Default Value
devices.iluvatar.enabled	Whether to enable	false
devices.iluvatar.customresources	Custom resources	["iluvatar.ai/BI-V150-vgpu", "iluvatar.ai/BI-V150.vMem","iluvatar.ai/BI-V150.vCore", ...]