HAMi Enterprise 2.8.0-rc1

Chart 版本	Chart 声明的 appVersion	发布日期
2.8.0-rc1	2.8.0-rc1	2026 年 3 月 16 日

本次为 patch 版本，以下变化以 HAMi Enterprise v2.8.0-rc0 为比较基线。

软件变更

• 阿里云 PPU 调度接入：调度器开始识别 PPU 节点注册信息和 alibaba.com/ppu、alibaba.com/ppu-memory、alibaba.com/gpu-core 资源。此 Chart 不安装 PPU 设备插件；使用该能力前，仍需由配套设备插件在节点上注册设备与资源。
• 统一内存 NVIDIA GPU 的显存登记：当 NVML 不支持查询设备显存时，设备插件可使用预设显存容量登记设备。未设置正值时，这类设备会被跳过；NVML 可正常查询显存的设备继续使用查询结果。
• Ascend 910C 模组分配：启用 Ascend 且设备配置包含 commonWord: Ascend910C 时，单容器申请 1 个 NPU 会调整为 2 个，以完整模组分配；其他奇数申请会被拒绝。发布 Chart 的默认设备配置尚无 910C 条目。
• 显式指定调度器的 Pod 准入：修复 spec.schedulerName 已设为 HAMi 调度器名称时，准入 webhook 可能跳过设备处理的问题；该名称由 Chart 的 schedulerName 配置。
• NVIDIA 节点状态与工作负载启动：调度器在可分配 GPU 数量归零时清理节点设备状态，并在设备注册标注变化时更新设备信息。NVIDIA 配置启用 postNvidiaSmi 且工作负载已有 Exec 型 postStart 命令时，原命令成功后才执行 nvidia-smi；串联命令需要容器镜像提供 sh。
• NVIDIA 命名空间配额：Pod 准入时会累计各容器中声明为单卡的 NVIDIA 显存和算力请求，并检查命名空间已配置的相应 ResourceQuota；超出配额时返回 exceeding resource quota。此项准入检查不覆盖容器声明多卡的请求。
• 监控指标调整：容器显存明细指标 hami_container_device_memory_context_bytes、hami_container_device_memory_module_bytes、hami_container_device_memory_data_bytes 分别改为 vGPU_device_memory_context_size_bytes、vGPU_device_memory_module_size_bytes、vGPU_device_memory_buffer_size_bytes；旧的 hami_container_device_memory_offset_bytes 没有同名替代项。调度器的 GPUDeviceMemoryLimit、GPUDeviceCoreLimit、GPUDeviceMemoryAllocated、GPUDeviceCoreAllocated、vGPULicenseRemains 增加 devicetype 标签；其中 GPUDeviceMemoryAllocated 还增加 devicecores 标签，nodeGPUOverview 也增加 devicecores 标签。

Chart 变更

• 新增 devicePlugin.preConfiguredDeviceMemory，单位为 MB，默认 0。它写入调度器设备配置；可通过 devicePlugin.nodeConfiguration.config 中对应节点的 preconfigureddevicememory 覆盖设备插件配置。节点级正值可覆盖通用配置。
• 新增 devices.alibaba.enabled（默认 true）和 devices.alibaba.ppuCorePolicy（默认 default），用于 PPU 资源映射和算力策略配置；策略可取 default、force 或 disable。
• 新增 prometheus.enabled，默认 false。设为 true 且集群已有 monitoring.coreos.com/v1/ServiceMonitor 资源类型时，Chart 会为调度器和 NVIDIA 设备插件创建 ServiceMonitor；Chart 不安装该资源类型。
• 主 Chart 的 version 和 appVersion 均为 2.8.0-rc1，默认镜像标签调整为 v2.8.0-rc1。

升级说明

在 NVML 无法查询显存的 NVIDIA 节点上，将 devicePlugin.preConfiguredDeviceMemory 设置为实际容量的 MB 数值。需要按节点设置不同容量时，在 devicePlugin.nodeConfiguration.config 中按节点名称填写正值 preconfigureddevicememory；其他 NVIDIA 节点可以保留默认值。

使用 Ascend 910C 的部署需在 devices.ascend.enabled: true 的基础上，在自定义 Chart 包中提供包含 commonWord: Ascend910C 和对应资源名的 files/device-config.yaml，并将这些资源名加入 devices.ascend.customresources。自定义文件会替换 Chart 生成的整份设备配置，原有设备条目需一并保留；默认 Chart 不含 910C 配置。已有 910C 工作负载应检查奇数 NPU 申请及单卡申请被调整为双 NPU 后的容量预期。

已有自定义 Exec 型 postStart 命令的 NVIDIA 工作负载，应确认镜像提供 sh，且原命令及其参数在 shell 中执行的结果符合预期；原命令失败时不会执行 nvidia-smi。

使用 Prometheus Operator 的部署可按需启用 prometheus.enabled。升级前检查依赖上述旧指标名或精确匹配标签的看板、告警和查询规则，并迁移到新指标及标签；依赖显存 offset 指标的规则需要单独调整。

安装包通过约定的交付渠道获取。查看Chart 与 appVersion 对应关系或软件中心。

Values 说明

以下参数说明取自 Chart 2.8.0-rc1 发布包随附的 README，保留原文。默认配置以该版本的 values.yaml 为准。

展开参数表

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", ...]