Kubespray v2.32.0 介绍与选型指南

一、信息基准

1.1 查询说明

• 查询日期：2026-10-19。
• 信息获取方式：纯官方资料溯源（官方站点 kubespray.io、官方仓库 kubernetes-sigs/kubespray 发行页与 v2.32.0 发行说明），本文不做本地安装与运行实测。
• 版本结论：本次介绍的版本为 Kubespray v2.32.0（2026-09-22 发布，当前最新稳定版），默认部署 Kubernetes 1.36。

1.2 版本依据

1.3 官方来源清单

二、软件概述

本文介绍的是 Kubespray v2.32.0（2026-09-22 发布，Kubernetes SIGs 项目）。

Kubespray 是一个基于 Ansible 的 Kubernetes 集群部署与生命周期管理工具，使用一组声明式清单（inventory）描述目标机器与集群拓扑，再以 playbook 完成从裸机或云主机的操作系统准备、运行时与网络插件安装，到高可用控制平面拉起的完整部署流程。项目隶属 Kubernetes SIGs（kubernetes-sigs 组织），以 Apache License 2.0 开源。

与上游 Kubernetes 的版本对齐是 Kubespray 的核心维护策略：每个 Kubespray 大版本都会锁定一个默认 Kubernetes minor 版本。v2.32.0 的默认版本为 Kubernetes 1.36，同时将 Ansible 环境升级到 Ansible 12 / ansible-core 2.19（v2.32.0 官方发行说明）。

三、核心架构

3.1 Ansible 驱动的声明式部署

• Inventory：以 ini 或 YAML 描述所有节点角色（kube_control_plane、kube_node、etcd 等）与集群变量。
• Playbook：cluster.yml（部署）、reset.yml（重置）、upgrade-cluster.yml（升级）、scale.yml（扩缩节点）等入口。
• 角色（Role）：每个组件（运行时、网络插件、证书、DNS 等）对应一个可配置的 Ansible 角色，参数通过 group_vars/all 覆盖。

3.2 集群形态能力

• 高可用控制平面：支持多 master 与外部/内置负载均衡（haproxy、keepalived 等，官方文档）。
• 多网络插件：Calico、Cilium、Flannel、Kube-Router 等（官方文档网络章节）。
• 多运行时与多操作系统：v2.32.0 新增 Ubuntu 26.04、openSUSE Leap 16.0、openSUSE MicroOS 支持（官方发行说明）。
• 离线安装：官方提供离线部署路径，适配无外网环境（官方文档）。

3.3 组件版本管理

addons 与附属组件（如 Node Feature Discovery）随版本统一管理；v2.32.0 将 NFD 默认版本调整为 0.19.0 并清理了旧变量（官方发行说明）。

四、功能特性

4.1 生产级部署

面向自建生产集群：节点准备、证书签发、控制平面高可用、etcd 集群化、网络插件与存储类对接一步到位。

4.2 版本升级与滚动维护

upgrade-cluster.yml 支持集群滚动升级；Kubespray 版本与上游 Kubernetes 版本对齐的发布模型，让升级路径清晰可控（官方发行说明）。

4.3 v2.32.0 关键变更（引自官方发行说明）

• Kubernetes 1.36 成为默认 minor 版本。
• Ansible 12 / ansible-core 2.19：条件表达式必须返回布尔值，布尔覆盖需以 JSON 或 YAML 未引号布尔传入（重大模板与条件变更）。
• 新增 Ubuntu 26.04、openSUSE Leap 16.0、openSUSE MicroOS 支持。
• Node Feature Discovery 默认 0.19.0，并移除旧版 inventory 变量。

4.4 生态集成

部署产物为标准 Kubernetes 集群，可直接对接 K8s 生态的 CNI、CSI、Ingress、监控栈；与上游一致性高，便于使用官方文档与工具链。

五、快速上手

以下步骤引自官方快速上手文档 https://kubespray.io/#/docs/quickstart ，本文不做本地实测。

5.1 准备 Ansible 环境

git clone https://github.com/kubernetes-sigs/kubespray.git
cd kubespray
pip install -r requirements.txt

（v2.32.0 的 requirements.txt 会安装 ansible-core 2.19.x 与 Ansible 12，见官方发行说明。）

5.2 定义集群清单

cp -r inventory/sample inventory/mycluster
# 编辑 inventory/mycluster/hosts.yaml，填入各节点 IP 与角色

5.3 执行部署

ansible-playbook -i inventory/mycluster/hosts.yaml cluster.yml -b

部署完成后在控制平面节点使用 kubectl 验证集群状态（官方 quickstart）。

六、适用场景与限制

6.1 适用场景

• 自建生产集群：裸机或云主机上的多节点高可用 Kubernetes。
• 内网/离线环境：官方离线安装路径可覆盖无外网数据中心。
• 需要细粒度控制集群组件版本与参数的团队。
• 已有 Ansible 运维体系的组织，可复用既有自动化资产。

6.2 限制与注意事项

• v2.32.0 对 Ansible 2.19 的模板与条件表达式有重大变更，升级前必须阅读 Urgent Upgrade Notes 并重建控制机虚拟环境（官方发行说明）。
• 部署依赖控制机到全部节点的 SSH 连通性，目标机需预置账户与权限。
• 集群创建后的多集群统一管理、权限审计等平台化能力需另配管理工具（如 Rancher）。
• 版本升级需遵循 Kubespray 的版本跨度建议，跨多个 minor 升级时应逐版推进。

七、同类选型对比

7.1 候选概览

7.2 量化对比（2026-10-19 实查）

（stars 与发版时间取自各项目 GitHub Releases 页面实查。）

7.3 选型建议

需要批量、可重复、离线可用的自建生产集群且团队具备 Ansible 能力时，Kubespray 是最直接的部署面选择；小规模或单机实验可直接 kubeadm；资源受限的边缘与 IoT 场景优先 K3s；多集群、多团队、多形态集群需要统一纳管时，在 Kubespray/RKE2 部署之上叠加 Rancher 做管理面。

八、参考链接

• 官方站点：https://kubespray.io/
• 快速上手：https://kubespray.io/#/docs/quickstart
• 源码仓库：https://github.com/kubernetes-sigs/kubespray
• v2.32.0 发行说明：https://github.com/kubernetes-sigs/kubespray/releases/tag/v2.32.0
• Kubernetes 官方 kubeadm 文档：https://kubernetes.io/zh-cn/docs/setup/production-environment/tools/kubeadm/
• K3s 仓库：https://github.com/k3s-io/k3s
• Rancher 仓库：https://github.com/rancher/rancher