gottaboy / kubeadm-ha

Kubeadm HA

🎉 项目受 kubeasz 启发，考虑使用二进制进行安装的童鞋可以参考这个项目。

kubeadm-ha 使用 kubeadm 进行高可用 kubernetes 集群搭建，利用 ansible-playbook 实现自动化安装，既提供一键安装脚本，也可以根据 playbook 分步执行安装各个组件。

• 项目特性： 不受国内网络限制、所有组件使用 kubelet 托管、多 master 高可用、tls 双向认证、自定义 lts 证书有效期、RBAC 授权、支持 Network Policy

• 相关组件及支持：

  组件	支持
  Dist	Ubuntu 16.04+, Debian 9, CentOS 7.4+, RedHat 7
  Etcd	v3.3.10
  Docker	18.06.3, 18.09.3, 18.09.6
  Kubernetes	v1.13, v1.14, v1.15
  Kube-apiserver lb	haproxy, envoy, nginx
  Network plugin	calico, kube-ovn, flannel
  Ingress controller	traefik, nginx-ingress

  Note: 表格中粗体标识出来的为默认安装版本

1. 克隆本项目

• 克隆本项目至任意节点中：

  git clone https://github.com/TimeBye/kubeadm-ha.git
  

2. Ansible 环境准备

• 进入项目安装ansible运行需要的环境：

  sudo ./install-ansible.sh

3. 集群规划，修改 hosts 文件

编辑项目example文件夹下的主机清单文件，修改各机器的访问地址、用户名、密码，并维护好各节点与角色的关系。文件中配置的用户必须是具有 root 权限的用户。项目预定义了6个例子，请完成集群规划后进行修改，生产环境建议一个节点只是一个角色。

• 搭建集群后有以下两种“样式”显示，请自行选择：

  • 样式一

    NAME            STATUS   ROLES                AGE     VERSION
    192.168.56.11   Ready    etcd,master,worker   7m25s   v1.15.0
    192.168.56.12   Ready    etcd,master,worker   5m18s   v1.15.0
    192.168.56.13   Ready    etcd,master,worker   5m18s   v1.15.0
    192.168.56.14   Ready    worker               4m37s   v1.15.0
    

  • 样式二

    NAME    STATUS   ROLES                AGE     VERSION
    node1   Ready    etcd,master,worker   7m25s   v1.15.0
    node2   Ready    etcd,master,worker   5m18s   v1.15.0
    node3   Ready    etcd,master,worker   5m18s   v1.15.0
    node4   Ready    worker               4m37s   v1.15.0
    

  • 对应的hosts配置文件事例如下：

    节点分配	样式一	样式二
    单节点	hosts.allinone.ip	hosts.allinone.hostname
    单主多节点	hosts.s-master.ip	hosts.s-master.hostname
    多主多节点	hosts.m-master.ip	hosts.m-master.hostname

4. 部署

一句命令拥有一个高可用 kubernetes 集群:

• 基本配置执行

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

• 高级配置执行

  ansible-playbook -i example/hosts.m-master.ip.ini -e @example/variables.yaml 90-init-cluster.yml
  

  若 example/hosts.m-master.ip.ini 文件中与 example/variables.yaml 参数冲突，则以 example/variables.yaml 文件为准。

5. 重置集群

• 如果部署失败，想要重置集群(所有数据)，执行：

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

6. 升级集群

• 升级kubernetes版本，执行：

  # 请注意替换用下面命令中版本号x部分为实际版本
  ansible-playbook -i example/hosts.m-master.ip.ini -e kube_upgrade_version=1.15.x 96-upgrade-cluster.yml
  

License