告别复杂配置！kubeadm-ha使用Ansible实现Kubernetes自动化安装的完整教程

【免费下载链接】kubeadm-hakubeadm-ha 使用 kubeadm 进行高可用 kubernetes 集群搭建，利用 ansible-playbook 实现自动化安装，既提供一键安装脚本，也可以根据 playbook 分步执行安装各个组件。项目地址: https://gitcode.com/gh_mirrors/ku/kubeadm-ha

kubeadm-ha是一个基于Ansible Playbook的Kubernetes高可用集群自动化部署工具，它利用kubeadm的强大功能，让用户无需手动处理复杂的集群配置即可快速搭建生产级别的Kubernetes环境。无论是新手还是有经验的用户，都能通过这个工具轻松实现Kubernetes集群的自动化安装与管理。

📋 为什么选择kubeadm-ha？

核心优势

• 完全自动化：通过Ansible Playbook实现从环境准备到集群部署的全流程自动化，减少人为操作错误
• 高可用架构：支持多Master节点部署，确保Kubernetes集群核心组件的高可用性
• 灵活的节点角色：可根据需求灵活配置节点角色（master/etcd/worker），满足不同规模集群需求
• 丰富的组件支持：默认集成Calico网络插件、Nginx Ingress Controller、Metrics Server等必备组件
• 广泛的系统兼容性：支持CentOS、Ubuntu、Debian、Rocky Linux等多种Linux发行版

支持矩阵

kubeadm-ha对各种组件和环境提供了广泛支持：

🚀 快速开始：一键部署Kubernetes集群

1. 准备工作

硬件要求

• 至少2台服务器（推荐3台以上实现高可用）
• 每台服务器至少2核CPU、4GB内存、20GB磁盘空间
• 所有节点之间网络互通，且能够访问互联网（离线安装需额外准备）

环境准备

首先克隆项目仓库到控制节点：

git clone https://gitcode.com/gh_mirrors/ku/kubeadm-ha cd kubeadm-ha

安装Ansible运行环境：

sudo ansible/install.sh

2. 集群规划与配置

kubeadm-ha提供了多种集群配置模板，位于example目录下，您可以根据实际需求选择合适的模板：

复制并修改适合您环境的配置文件：

cp example/hosts.m-master.ip.ini example/hosts.ini vi example/hosts.ini

在配置文件中设置节点信息、SSH连接方式和节点角色：

# 示例配置（多Master多节点） [lb] 192.168.56.10 ansible_ssh_user=root ansible_ssh_pass=your_password [master] 192.168.56.11 ansible_ssh_user=root ansible_ssh_pass=your_password 192.168.56.12 ansible_ssh_user=root ansible_ssh_pass=your_password 192.168.56.13 ansible_ssh_user=root ansible_ssh_pass=your_password [worker] 192.168.56.14 ansible_ssh_user=root ansible_ssh_pass=your_password 192.168.56.15 ansible_ssh_user=root ansible_ssh_pass=your_password [etcd] 192.168.56.11 192.168.56.12 192.168.56.13

3. 执行一键部署

基本配置部署（使用默认参数）：

ansible-playbook -i example/hosts.ini 90-init-cluster.yml

高级配置部署（自定义参数）：

# 先复制并修改变量配置文件 cp example/variables.yaml example/my-variables.yaml vi example/my-variables.yaml # 使用自定义变量部署 ansible-playbook -i example/hosts.ini -e @example/my-variables.yaml 90-init-cluster.yml

所有可配置项都在example/variables.yaml文件中，删除配置项前的注释符即可生效自定义配置。

4. 验证集群状态

部署完成后，在任意Master节点执行以下命令验证集群状态：

kubectl get nodes

成功部署后将看到类似以下输出：

NAME STATUS ROLES AGE VERSION 192.168.56.11 Ready control-plane,etcd,master 10m v1.33.4 192.168.56.12 Ready control-plane,etcd,master 8m v1.33.4 192.168.56.13 Ready control-plane,etcd,master 8m v1.33.4 192.168.56.14 Ready worker 6m v1.33.4 192.168.56.15 Ready worker 6m v1.33.4

⚙️ 分步部署详解

如果您需要更精细地控制部署过程，可以分步执行Ansible Playbook：

1. 系统初始化与内核优化

ansible-playbook -i example/hosts.ini 00-kernel.yml # 可选：升级内核 ansible-playbook -i example/hosts.ini 01-base.yml # 系统基础配置

2. 容器运行时安装

ansible-playbook -i example/hosts.ini 02-container-engine.yml

3. 负载均衡与etcd集群部署

ansible-playbook -i example/hosts.ini 05-load-balancer.yml ansible-playbook -i example/hosts.ini 06-etcd.yml

4. Kubernetes核心组件部署

ansible-playbook -i example/hosts.ini 07-kubernetes-certificates.yml ansible-playbook -i example/hosts.ini 08-kubernetes-master.yml ansible-playbook -i example/hosts.ini 09-kubernetes-worker.yml

5. 网络插件与附加组件安装

ansible-playbook -i example/hosts.ini 21-network-plugin.yml # 安装网络插件 ansible-playbook -i example/hosts.ini 22-ingress-controller.yml # 安装Ingress控制器 ansible-playbook -i example/hosts.ini 23-metrics-server.yml # 安装Metrics Server

🔧 集群管理常用操作

添加新节点

# 添加Worker节点 ansible-playbook -i example/hosts.ini 81-add-worker.yml # 添加Master节点 ansible-playbook -i example/hosts.ini 82-add-master.yml

证书轮换

ansible-playbook -i example/hosts.ini 92-certificates-renew.yml

集群升级

ansible-playbook -i example/hosts.ini 91-upgrade-cluster.yml

集群备份与恢复

# 备份集群 ansible-playbook -i example/hosts.ini 93-backup-cluster.yml # 恢复集群 ansible-playbook -i example/hosts.ini 94-restore-cluster.yml

集群重置

ansible-playbook -i example/hosts.ini 99-reset-cluster.yml

📚 深入学习与资源

官方文档

• 安装须知
• 集群安装详细指南
• 节点管理
• 离线安装方法

核心Playbook文件

• 集群初始化：90-init-cluster.yml
• 节点准备：roles/prepare/
• 网络插件：roles/plugins/network-plugins/
• 负载均衡：roles/load-balancer/

🎯 总结

kubeadm-ha通过Ansible自动化技术，将复杂的Kubernetes高可用集群部署过程简化为几个简单步骤，极大降低了Kubernetes的入门门槛。无论是企业级生产环境还是个人学习测试，kubeadm-ha都能提供快速、可靠、灵活的Kubernetes部署解决方案。

通过本文介绍的方法，您可以轻松实现Kubernetes集群的自动化部署与管理，告别手动配置的繁琐与易错，将更多精力集中在业务应用的开发与运维上。立即尝试kubeadm-ha，体验Kubernetes自动化部署的便捷与高效！

【免费下载链接】kubeadm-hakubeadm-ha 使用 kubeadm 进行高可用 kubernetes 集群搭建，利用 ansible-playbook 实现自动化安装，既提供一键安装脚本，也可以根据 playbook 分步执行安装各个组件。项目地址: https://gitcode.com/gh_mirrors/ku/kubeadm-ha