Kubernetes/部署文档/Kubeasz/Kubeasz部署Kubernetes集群.md

> 本文作者：丁辉

# Kubeasz部署Kubernetes集群

[Github官方文档](https://github.com/easzlab/kubeasz)

[Github安装文档](https://github.com/easzlab/kubeasz/blob/master/docs/setup/quickStart.md)

|         节点名称         |      IP      |  Kubernetes角色  |
| :----------------------: | :----------: | :--------------: |
| k8s-master-1,Kubeasz管理 | 192.168.1.10 | master,etcd,node |
|       k8s-master-2       | 192.168.1.20 | master,etcd,node |
|       k8s-master-3       | 192.168.1.30 | master,etcd,node |

## 环境准备

1. 配置免密

   ```bash
   ssh-keygen -t rsa -N "" -f ~/.ssh/id_rsa -q
   ```

2. 配置免密登录

   ```bash
   ssh-copy-id root@192.168.1.10
   ssh-copy-id root@192.168.1.20
   ssh-copy-id root@192.168.1.30
   ```

3. 更改主机名

   - 192.168.1.10

     ```bash
     hostnamectl set-hostname k8s-master-1 && bash
     ```

   - 192.168.1.20

     ```bash
     hostnamectl set-hostname k8s-master-2 && bash
     ```

   - 192.168.1.30

     ```bash
     hostnamectl set-hostname k8s-master-3 && bash
     ```

4. 编辑 /etc/hosts 文件

   ```bash
   vi /etc/hosts
   ```

   添加如下内容

   ```bash
   192.168.1.10 k8s-master-1
   192.168.1.20 k8s-master-2
   192.168.1.30 k8s-master-3
   ```

## 开始部署 Kubeasz

[Github Releases](https://github.com/easzlab/kubeasz/releases)

1. 下载 ezdown

   ```bash
   wget https://github.com/easzlab/kubeasz/releases/download/3.6.2/ezdown && chmod 777 ezdown
   ```

   > 下载支持 Docker 的版本
   >
   > ```bash
   > wget https://github.com/easzlab/kubeasz/releases/download/3.2.0/ezdown && chmod 777 ezdown
   > ```

2. 下载kubeasz代码、二进制、默认容器镜像

   - 国内环境

     ```bash
     ./ezdown -D
     ```

     > 下载 flannel 镜像
     >
     > ```bash
     > ./ezdown -X flannel
     > ```

   - 海外环境

     ```bash
     ./ezdown -D -m standard
     ```

     > 下载 flannel 镜像
     >
     > ```bash
     > ./ezdown -D -m standard -X flannel
     > ```

3. 运行 Kubeasz

   ```bash
   ./ezdown -S
   ```

   > 配置快捷命令
   >
   > ```bash
   > echo "alias dk='docker exec -it kubeasz'" >> ~/.bashrc
   > source ~/.bashrc
   > ```
   >
   > 配置后执行 `dk` 即可

4. 创建新集群

   ```bash
   dk ezctl new k8s-01
   ```

5. 编辑 hosts 文件

   ```bash
   vi /etc/kubeasz/clusters/k8s-01/hosts
   ```

   内容如下

   ```bash
   # 'etcd' cluster should have odd member(s) (1,3,5,...)
   [etcd]
   192.168.1.10
   192.168.1.20
   192.168.1.30
   
   # master node(s)
   [kube_master]
   192.168.1.10 k8s_nodename='k8s-master-1'
   192.168.1.20 k8s_nodename='k8s-master-2'
   192.168.1.30 k8s_nodename='k8s-master-3'
   
   # work node(s)
   [kube_node]
   192.168.1.10 k8s_nodename='k8s-master-1'
   192.168.1.20 k8s_nodename='k8s-master-2'
   192.168.1.30 k8s_nodename='k8s-master-3'
   
   # VIP
   [ex_lb]
   192.168.1.10 LB_ROLE=master EX_APISERVER_VIP=192.168.1.100 EX_APISERVER_PORT=8443
   192.168.1.20 LB_ROLE=backup EX_APISERVER_VIP=192.168.1.100 EX_APISERVER_PORT=8443
   192.168.1.30 LB_ROLE=backup EX_APISERVER_VIP=192.168.1.100 EX_APISERVER_PORT=8443
   
   ...#此处省略
   # Cluster container-runtime supported: docker, containerd
   CONTAINER_RUNTIME="containerd"
   
   # Network plugins supported: calico, flannel, kube-router, cilium, kube-ovn
   CLUSTER_NETWORK="flannel"
   
   ...#此处省略
   ```

6. 修改 config.yml 文件

   ```bash
   vi /etc/kubeasz/clusters/k8s-01/config.yml
   ```

   内容如下

   ```yml
   ############################
   # role:kube-master
   ############################
   # k8s 集群 master 节点证书配置，可以添加多个ip和域名（比如增加公网ip和域名）尽量预留一些IP使用
   MASTER_CERT_HOSTS:
     - "192.168.1.10"
     - "192.168.1.20"
     - "192.168.1.30"
     - "192.168.1.100"
   ```


## 开始安装 Kubernetes

1. 安装

   ```bash
   dk ezctl setup k8s-01 all
   ```

   > 或一步一步安装
   >
   > ```bash
   > # 初始化集群配置
   > dk ezctl setup k8s-01 01
   > # 安装 etcd
   > dk ezctl setup k8s-01 02
   > ...#此处省略
   > ```

2. 加载新配置

   ```bash
   source ~/.bashrc
   ```

3. 查看节点状态

   ```bash
   kubectl get node
   ```

## 添加节点

[官方文档](https://github.com/easzlab/kubeasz/blob/master/docs/op/op-node.md)

- 添加 worker

  ```bash
  dk ezctl add-node k8s-01 192.168.1.40 k8s_nodename='k8s-master-4'
  ```

  > SSH 非 22 端口
  >
  > ```bash
  > dk ezctl add-node k8s-01 192.168.1.40 k8s_nodename='k8s-master-4' ansible_ssh_port=10022
  > ```

- 添加 master

  ```bash
  dk ezctl add-master k8s-01 192.168.1.40 k8s_nodename='k8s-master-4'
  ```

- 添加 etcd

  ```bash
  dk ezctl add-etcd k8s-01 192.168.1.40
  ```

### 删除节点

- 删除 worker

  ```bash
  dk ezctl del-node k8s-01 192.168.1.40
  ```

- 删除 master

  ```bash
  dk ezctl del-master k8s-01 192.168.1.40
  ```

- 删除 etcd

  ```bash
  dk ezctl del-etcd k8s-01 192.168.1.40
  ```