#VMware vSphere Provider release notes

#概述

本页面跟踪 Alauda Container Platform VMware vSphere Infrastructure Provider 的 release notes。你在平台上看到的版本号（例如，v1.0.10）指的是 vSphere provider 的打包发布版本，该版本捆绑了 Cluster API Provider vSphere (CAPV) controller image、vSphere Cloud Provider Interface (CPI) image，以及用于在 Alauda Container Platform 上部署它们的 Helm chart。

有关当前完整功能列表和安装步骤，请参见 VMware vSphere Provider 安装。

#v1.0.16 (2026-08-05)

#增强

• ACP 4.4 系统组件仓库 — 该 provider 会根据目标 Kube-OVN 版本选择 Kube-OVN chart，根据 CoreDNS tag 中的 ACP 版本后缀选择 CoreDNS image repository，并根据 Kubernetes 版本选择 kube-proxy image repository。Kube-OVN v4.4 及之后版本使用 acp/chart-kube-ovn，ACP v4.4 及之后版本的 CoreDNS tag 使用 acp，Kubernetes v1.35 及之后版本的 kube-proxy 使用 acp/k8s。较早的目标仍保持其旧的 repository 路径。

#修复的问题

• 升级期间的组件协调更可靠 — 该 provider 会响应 KubeadmControlPlane 版本和 rollout 变更，在修改业务集群的 kube-proxy 和 CoreDNS resources 之前等待控制平面 rollout 完成，并将业务集群现有的 Registry pull 凭据传递给受管系统组件。这样可使 Kube-OVN、CoreDNS 和 kube-proxy 与所选的 ACP 和 Kubernetes 版本保持一致。

#说明

• 外部控制平面 LoadBalancer — 此版本不会部署 Self-built VIP。请按照 规划控制平面端点 配置外部 LoadBalancer。

关于该 provider 版本对应的 Kube-OVN 升级顺序，请参见 升级 VMware vSphere 上的集群。

#v1.0.15 (2026-07-09)

#修复的问题

• 更可靠的主节点地址和标识 — vSphere cloud provider 现在在选择节点地址时会遵循已配置的 node IP，并从 VM 注册的 system UUID 中解析 provider ID。这样可避免错误的 node 标识或地址选择，尤其适用于具有多个 NIC 的 VM。

• 更可靠的 Kube-OVN 引导 — 该 provider 会等待有效的控制平面节点集合之后再协调 Kube-OVN，避免在初始控制平面尚未完成时进行 CNI 协调。

#v1.0.14 (2026-06-08)

#说明

v1.0.14 是在相同源 revision 上对 v1.0.13 的重新打 tag。它不包含其他更改；请参见 v1.0.13。

#v1.0.13 (2026-06-08)

#修复的问题

• 更安全的 pool 管理型持久化磁盘替换 — 当上一台 VM 的 persistent disks 仍然挂载时，不会复用 machine-configuration pool 槽位。这可防止替换 VM 与磁盘卸载操作发生竞态。

• 待机 Global Cluster 协调 — vSphere provider resources 可以在待机 Global Cluster 上正确协调，支持文档化的灾难恢复操作步骤。

#v1.0.12 (2026-05-25)

#修复的问题

• vSphere CPI 可在 Kube-OVN 引导期间启动 — vSphere cloud provider 会调度到控制平面节点并容忍其 taint，因此可以在集群网络就绪之前启动。

• Kube-OVN 等待初始控制平面 — 该 provider 会推迟 Kube-OVN 协调，直到就绪的控制平面节点数量与预期的控制平面副本数一致。

#v1.0.11 (2026-05-21)

#修复的问题

• 减少不必要的 OVN 协调触发 — 上游 CAPV image 升级到一个构建版本，该版本可防止在不需要实际状态变更时反复重新触发 OVN 协调。提升了 controller 稳定性，并降低了后台负载。

#v1.0.10 (2026-05-18)

#增强

• 上游 CAPV image 刷新 — Provider chart 现在引用了更新的上游 Cluster API Provider vSphere controller Alauda 构建版本。除上游 image 升级外，此 overlay release 没有行为变化。

#v1.0.9 (2026-05-18)

#新功能

• 容器镜像上的 OCI source 和 revision 标签 — 构建的 provider images 包含标准 OCI source 和 revision 标签，以便于构建追踪。

#修复的问题

• OVN 集成和持久化磁盘处理 — 上游 CAPV image 升级到一个构建版本，解决了先前 release 中报告的 OVN 网络集成问题和持久化磁盘处理回归。

#v1.0.8 (2026-05-12)

#修复的问题

• capv-manager-role ClusterRole — 修正了 capv-manager-role ClusterRole 定义中缺少正常 controller 运行所需权限的问题。

#v1.0.7 (2026-04-28)

#修复的问题

• chart 模板回归 — 恢复了 CRD 上的 v1beta1 contract 标签，并修正了 chart 中一个被转义的 Go template 字面量，修复了在某些配置下阻止 provider 成功安装的 chart 模板回归问题。

#v1.0.6 (2026-04-28)

#增强

• CRD 更新 — 刷新 provider CRD，以与最新 schema 保持一致。

#v1.0.5 (2026-04-16)

#破坏性变更

• CRD 重命名：VSphereResourcePool → VSphereMachineConfigPool — 用于声明每个 node-pool 槽位预留和持久配置的 CRD 已从 VSphereResourcePool 重命名为 VSphereMachineConfigPool。现有 manifest 必须更新为使用新的资源类型。

#v1.0.4 (2026-04-11)

#增强

• VSphereResourcePool CRD 更新 — 对 VSphereResourcePool CRD 进行了 schema 调整（随后在 v1.0.5 中重命名；见上文）。

• 文档 — 刷新了 provider README，补充了项目结构、组件、CRD 和配置章节。

#v1.0.3 (2026-04-07)

#修复的问题

• CVE 补丁 — 解决了 vendored dependencies 中披露的多个 CVE 问题。

#v1.0.2 (2026-04-07)

#说明

v1.0.2 是对 v1.0.1 的重新打 tag（底层为相同的 commit）。除 v1.0.1 外没有其他更改；请参见 v1.0.1 了解 release 内容。

#v1.0.1 (2026-04-07)

#新功能

• 基于 Secret 的 CAPV 部署加密 — provider deployment 现在可以使用外部 Secret 来配置加密，从而不再要求将加密材料直接写入 deployment manifest。

#增强

• VSphereResourcePool CRD 更新 — 对 VSphereResourcePool CRD 进行了 schema 刷新。请注意，该 CRD 随后在 v1.0.5 中重命名为 VSphereMachineConfigPool。

• 更新的 CAPV deployment manifest — provider deployment manifest 已与新的 CRD schema 对齐。

#v1.0.0 (2026-04-03)

#概述

v1.0.0 是 Alauda Container Platform VMware vSphere Infrastructure Provider 的初始 release，它是面向 Alauda Container Platform 的上游 Cluster API Provider vSphere (CAPV) 的 Alauda 打包发行版。

#初始功能集

• CAPV controller 和 vSphere CPI 的 Helm-chart 打包 — 捆绑了上游 CAPV controller image 和 vSphere Cloud Provider Interface (CPI) image，以及平台托管安装所需的 Alauda Container Platform ModulePlugin 定义。

• CRD 集 — 提供标准 CAPV CRD（VSphereCluster、VSphereClusterIdentity、VSphereMachine、VSphereMachineTemplate、VSphereVM、VSphereDeploymentZone、VSphereFailureDomain），以及 Alauda 扩展 VSphereResourcePool（在 v1.0.5 中重命名为 VSphereMachineConfigPool）。

• 平台对齐的安装流程 — 通过 Alauda Container Platform 的标准 provider 安装流程进行安装，并为上游 CAPV controller 和 CPI image 覆盖提供 chart values。