Yurtadm init/join

1.背景说明

为了让用户快速拥有一个 OpenYurt 测试集群，OpenYurt 提供了命令 Yurtadm init 初始化集群，用户只需要选择 OpenYurt 集群的镜像版本，就可以创建对应版本的 OpenYurt，Yurt -APP-Manager、Yurt-Controller-Manager、Yurttunnel-Server、Yurttunnel-Agent 组件会自动部署。

后续扩展集群，用户可以使用命令 Yurtadm join，将边缘节点或者云端节点加入集群。

2.使用流程

2.1编译 Yurtadm

在进行初始化集群时，需要先获取 Yurtadm 可执行文件。 要快速构建和安装设置 yurtadm ，在编译系统已安装了 golang 1.13~1.17 和 bash 的前提下你可以执行以下命令来完成安装：

  1. $ git clone https://github.com/openyurtio/openyurt.git
  2. $ cd openyurt
  3. $ make build WHAT="yurtadm" ARCH="amd64" REGION=cn

可执行文件将存放在 _output/local/bin/ 目录下。

2.2初始化集群

执行以下命令初始化集群：

  1. $ _output/local/bin/linux/amd64/yurtadm init --apiserver-advertise-address 1.2.3.4 --openyurt-version latest --passwd 1234

其中主要参数为：

  1.  --apiserver-advertise-address    master节点的IP地址
  2.  --passwd                         master节点的ssh登入密码
  3.  --openyurt-version               OpenYurt集群的版本

如果想要配置更多信息，可以通过 -h 来获取。

2.4节点加入

用户可以通过 Yurtadm join 将云端节点、边缘节点加入 OpenYurt 集群。注意，在加入节点时，需要在节点上安装运行时，并关闭交换分区。

执行以下命令加入边缘节点：

  1. $ _output/local/bin/linux/amd64/yurtadm join 1.2.3.4:6443 --token=zffaj3.a5vjzf09qn9ft3gt --node-type=edge --discovery-token-unsafe-skip-ca-verification --v=5

执行以下命令加入云端节点：

  1. $ _output/local/bin/linux/amd64/yurtadm join 1.2.3.4:6443 --token=zffaj3.a5vjzf09qn9ft3gt --node-type=cloud --discovery-token-unsafe-skip-ca-verification --v=5

当边缘节点runtime为containerd时，需要配置cri-socket参数，如上面执行命令加入边缘节点改为：

  1. $ _output/local/bin/linux/amd64/yurtadm join 1.2.3.4:6443 --token=zffaj3.a5vjzf09qn9ft3gt --node-type=edge --discovery-token-unsafe-skip-ca-verification --cri-socket=/run/containerd/containerd.sock --v=5

3.实现细节

3.1 Yurtadm init

为了降低 Yurtadm init 的使用难度，提高的集群安装成功概率，Yurtadm init 通过开源工具 sealer 初始化 OpenYurt 集群。在实现上，Yurtadm init 会下载 sealer 二进制文件，sealer 会下载 OpenYurt 官方提供的集群镜像并安装集群。 此外，Yurtadm init 也支持用户个性化配置 OpenYurt 集群镜像。