registry.k8s.io/capi-openstack/capi-openstack-controller:v0.11.2

registry.k8s.io/capi-openstack/capi-openstack-controller 是 Kubernetes Cluster API（CAPI）生态中，针对 OpenStack 云平台的核心控制器镜像，存储于 Kubernetes 官方容器镜像仓库。CAPI 作为 Kubernetes 集群生命周期管理工具，允许用户通过 Kubernetes API 声明式定义和管理集群，而该控制器正是 CAPI 与 OpenStack 环境集成的关键组件，负责将 CAPI 的集群配置“落地”到 OpenStack 基础设施中。

其核心功能围绕 OpenStack 环境下的 Kubernetes 集群全生命周期管理展开。首先是基础设施资源协调：通过对接 OpenStack 服务 API（如 Nova 计算、Neutron 网络、Cinder 存储），根据 CAPI 自定义资源（如 OpenStackCluster、OpenStackMachine）的配置，自动创建集群所需资源——例如通过 Nova 启动节点虚拟机实例，用 Neutron 配置私有网络与安全组，或通过 Cinder 挂载持久化卷，确保集群节点具备运行 Kubernetes 所需的计算、网络和存储能力。

其次是状态监控与故障自愈：控制器会持续同步 OpenStack 资源状态（如实例运行状态、网络连通性）与 CAPI 资源的期望状态，一旦发现偏差（如节点实例异常终止），会触发修复流程——例如重新调用 Nova API 创建实例，或通过 Heat 堆栈恢复基础设施配置，保障集群稳定性。

此外，它还支持集群扩缩容、版本升级等运维操作。当用户通过 CAPI 调整 MachineDeployment 副本数时，控制器会联动 OpenStack 增减实例；在集群升级场景中，协调节点替换与配置更新，确保升级过程符合 OpenStack 资源调度规则。

作为官方维护的镜像，其优势在于兼容性与可靠性：与 CAPI 核心组件版本同步，适配 OpenStack 最新稳定版（如 Yoga、Zed），并定期更新安全补丁；同时遵循 Kubernetes 声明式管理理念，用户可通过 kubectl 或 GitOps 工具（如 Argo CD）直接操作，无需额外学习 OpenStack 复杂的 CLI 命令，大幅降低在 OpenStack 环境中部署和管理 Kubernetes 集群的门槛。

实际应用中，该控制器常用于企业私有云或混合云场景——借助 OpenStack 现有资源池（如虚拟化集群、共享存储），快速构建多套 Kubernetes 集群，满足开发测试、生产环境隔离需求，同时通过 CAPI 统一管控集群生命周期，提升运维效率。