https://blogs.wuvikr.top/tags/kubespray/Recent content in Kubespray on 维克的博客HugoenFri, 09 Oct 2026 11:34:13 +0800https://blogs.wuvikr.top/posts/kubespray%E9%83%A8%E7%BD%B2%E5%92%8C%E7%BB%B4%E6%8A%A4k8s%E9%9B%86%E7%BE%A4%E6%8C%87%E5%8D%97/Fri, 09 Oct 2026 11:34:13 +0800https://blogs.wuvikr.top/posts/kubespray%E9%83%A8%E7%BD%B2%E5%92%8C%E7%BB%B4%E6%8A%A4k8s%E9%9B%86%E7%BE%A4%E6%8C%87%E5%8D%97/<h1 id="1-简介">1. 简介</h1> <p>Kubespray 是 Kubernetes SIGs 官方维护的部署项目，本质是一套经过大量生产环境验证的 Ansible Playbook、Inventory 模板和角色集合。它不发明新的集群模型，而是把 kubeadm 引导、etcd 集群组建、CNI 安装、证书轮换、节点扩缩容与升级这些容易出错的步骤固化为可重复执行的代码。</p> <h2 id="11-kubespray-解决了什么问题">1.1 Kubespray 解决了什么问题</h2> <p>手动搭一个生产集群的工作量并不仅仅只是简单把 K8s 集群跑起来，而在于：</p> <ul> <li>etcd 节点集群的证书、成员管理、快照备份；</li> <li>多控制平面节点下 apiserver 的负载均衡与前端证书 SAN；</li> <li>kubelet 配置（cgroup 驱动、预留资源、镜像垃圾回收、最大 Pod 数）；</li> <li>CNI 插件与内核网络参数、iptables/nftables 后端的匹配；</li> <li>证书到期轮换、跨小版本顺序升级、节点下线清理。</li> </ul> <p>这些工作做一次可以靠文档，做十次就得靠自动化。Kubespray 的价值就在于它把这些工程细节沉淀成了一套<strong>符合生产环境最佳实践的可重复执行代码</strong>，你只需要在默认值的基础上少量改动，而不是自己编写和维护大量的脚本。</p> <h2 id="12-和其他工具对比">1.2 和其他工具对比</h2> <table> <thead> <tr> <th>工具</th> <th>Kubespray</th> <th>kubeadm</th> <th>Rancher</th> <th>OpenShift(OKD)</th> <th>kops</th> <th>KubeKey(kk)</th> <th>k3s</th> </tr> </thead> <tbody> <tr> <td><strong>核心定位</strong></td> <td>Ansible驱动，生产级离线部署K8s集群</td> <td>K8s官方最小化集群引导工具</td> <td>企业级K8s全生命周期管理平台</td> <td>红帽出品，基于K8s的企业容器平台</td> <td>AWS专用K8s集群部署工具</td> <td>KubeSphere社区开源部署工具，中文友好</td> <td>Rancher出品轻量K8s发行版</td> </tr> <tr> <td><strong>底层引擎</strong></td> <td>Ansible</td> <td>Go原生二进制</td> <td>容器+WebUI</td> <td>容器/Operator</td> <td>Go，调用AWS API</td> <td>Go二进制，封装kubeadm</td> <td>裁剪K8s单二进制</td> </tr> <tr> <td><strong>适用环境</strong></td> <td>裸金属、VMware、私有云、离线环境</td> <td>裸金属/虚拟机/云主机，在线为主</td> <td>公有云、私有云、边缘，多集群统一管理</td> <td>企业私有/混合云，偏向生产企业</td> <td><strong>仅限AWS</strong>公有云</td> <td>裸机/虚拟机，私有化离线场景</td> <td>低配服务器、边缘、开发/小生产</td> </tr> <tr> <td><strong>离线部署</strong></td> <td>✅ 完美支持，可打包离线介质</td> <td>⚠️ 支持但麻烦，需要手动下载镜像/二进制</td> <td>✅ 支持离线airgap安装</td> <td>✅ 官方提供离线方案</td> <td>❌ 依赖AWS云API，不适合离线</td> <td>✅原生支持打包离线包</td> <td>✅离线包</td> </tr> <tr> <td><strong>集群维护</strong></td> <td>Ansible playbook升级、扩容、替换节点；版本升级稳定</td> <td>仅引导集群，<strong>不负责后续集群运维</strong>，升级操作繁琐</td> <td>Web界面一键升级、扩缩容，多集群统一监控告警</td> <td>Operator管理集群，自动化运维能力强</td> <td>集群升级、节点替换由kops命令管理</td> <td>一键HA、扩容升级，可配套KubeSphere控制台</td> <td>一行命令运维，嵌入式etcd HA</td> </tr> <tr> <td><strong>高可用</strong></td> <td>✅ 内置etcd三副本、控制面HA方案</td> <td>需要手动搭建HA（负载均衡+多master）</td> <td>✅ 自动支持HA，内置负载均衡方案</td> <td>✅ 默认HA架构</td> <td>✅ AWS上自动搭建控制面HA</td> <td>✅一键HA，内置负载均衡</td> <td>✅内置HA（嵌入式etcd）</td> </tr> <tr> <td><strong>网络插件</strong></td> <td>内置Calico/Flannel/Cilium等多种CNI可选</td> <td>仅提供基础CNI对接，需自行部署CNI</td> <td>内置多种CNI，UI可视化配置</td> <td>默认OVN-Kubernetes，也可Calico</td> <td>默认Calico，可自定义CNI</td> <td>Calico等CNI可选</td> <td>Flannel默认，支持替换CNI</td> </tr> <tr> <td><strong>存储支持</strong></td> <td>对接本地卷、Ceph、Longhorn等，ansible角色集成</td> <td>仅提供CSI标准，存储需要自己部署</td> <td>内置存储管理，支持Longhorn等</td> <td>内置CSI+本地存储方案</td> <td>对接AWS EBS等云存储</td> <td>对接Longhorn、Ceph、本地存储</td> <td>支持本地存储、CSI</td> </tr> <tr> <td><strong>版本适配</strong></td> <td>紧跟K8s社区版本，滞后一小段时间</td> <td>K8s官方同步发布</td> <td>支持多K8s版本，统一纳管不同版本集群</td> <td>OKD版本独立，和上游K8s有差异</td> <td>紧跟AWS支持的K8s版本</td> <td>跟随上游kubeadm</td> <td>Rancher维护稳定版本</td> </tr> <tr> <td><strong>学习成本</strong></td> <td>中等，需要懂Ansible</td> <td>低，上手简单，适合测试集群</td> <td>低，WebUI友好，运维门槛低</td> <td>高，体系庞大，有专属概念</td> <td>中等，熟悉AWS即可快速上手</td> <td>中等，中文文档友好</td> <td>很低，上手极快</td> </tr> <tr> <td><strong>典型场景</strong></td> <td>裸金属机房、私有化项目、需要批量部署大量集群、等保离线环境</td> <td>实验室、POC测试、小规模简单集群</td> <td>多集群管理、混合云、需要统一权限/审计的企业</td> <td>大型企业生产环境，需要完整容器安全、合规能力</td> <td>AWS云上快速搭建销毁K8s集群</td> <td>中小企业裸机/VM离线部署，可选KubeSphere控制台</td> <td>资源有限、边缘、小生产集群</td> </tr> <tr> <td><strong>缺点</strong></td> <td>Ansible串行执行，大规模集群部署慢；无WebUI；故障排查需要Ansible基础</td> <td>没有集群生命周期管理，生产HA搭建工作量大；缺少监控日志等附加组件</td> <td>资源开销大；底层K8s被封装，深度定制复杂；商业版收费</td> <td>闭源企业版昂贵；架构重，资源消耗高；学习曲线陡峭</td> <td>只能跑在AWS，无法裸金属/其他云使用</td> <td>依赖kubeadm；底层封装，深度排障需要kubeadm知识；KubeSphere额外耗资源</td> <td>裁剪部分组件，重型大规模生产不推荐；和标准K8s有细微差异</td> </tr> <tr> <td><strong>国内中小企业热度</strong></td> <td>⭐⭐⭐ 更多集成商使用，中小企业自用偏少</td> <td>⭐⭐⭐⭐⭐ 最高，几乎所有运维都学这个</td> <td>⭐⭐⭐⭐ 多集群场景热门</td> <td>⭐⭐ 大型企业为主，中小企业很少用</td> <td>⭐ 国内几乎不用</td> <td>⭐⭐⭐⭐ 私有化中小企业热门</td> <td>⭐⭐⭐⭐ 小集群/边缘场景热门</td> </tr> </tbody> </table> <h1 id="2-底层架构和设计">2. 底层架构和设计</h1> <p><strong>关键核心设计</strong>：</p>