使用 edgeadm 安装部署

前提

  • Kubenertes集群的要求
  1. 用 kubeadm 安装好一个原生的kubernestes集群,最低一个 master 节点一个 node 节点,最低配置 2C2G(kubeadm的要求)。
  2. 集群版本推荐v1.18及以上(1.18.2我们做过详细测试)。
  3. 检查kube-api-server 和 kubelet 是否开启特权容器,没有开启的话 kube-api-server 和 kubelet 的启动参数添加 –allow-privileged=true, 并重启。
  4. 确保kubeadm集群健康,各个组件运行正常运行,Node处于Ready状态,能正常下发应用。

建议使用 kubeadm 安装集群,避免部署失败,kubeadm安装Kubernetes 集群的方法可参考:kubeadm官方安装指南

一、edgeadm 简要

1. edgeadm 是什么?

edgeadm 是superedge团队推出的管理边缘集群的命令行工具。

2. edgeadm 有什么用?

  • 能够无缝的将kubernestes集群转化成edge集群, 应用于边缘场景。
  • 能够把edgeadm转化成的edge集群恢复至最初的原生kubernestes集群。
  • 能够支持用户自定义边缘集群的属性和相关组件的调试开发。

3. 如何获取 edgeadm 工具

4. 将kubernestes集群转化成边缘集群

  1. 用 kubeadm 部署一个原生的kubernestes集群,要求见上面的 Kubeadm集群的要求。
  2. 获取 edgeadm,按下文 change 命令进行。
  1. sudo chmod +x edgeadm && ./edgeadm change

二、edgeadm 命令介绍

1. change 命令

使用 edgeadm 部署 - 图1

  • 含义

将kubernestes原生集群转化成edge集群。

  • 最简执行
  1. [root@master01 ~]# edgeadm change

edgeadm默认读取${home}/.kube/config的kubeconfig文件和/etc/kubernetes/pki/ca.* 证书 要是 kubeconfig 和 ca.* 不在默认路径请按全参执行。

  • 全参数执行
  1. [root@master01 ~]# edgeadm change -p [集群的部署方式] --kubeconfig [kubeconfig文件路径] --ca.cert [集群根证书路径] --ca.key [集群根证书key路径]

要是执行过程中没有问题,会输出如下内容:

  1. [root@master01 ~]# edgeadm change
  2. Create tunnel-coredns.yaml success!
  3. ...
  4. Deploy helper-job-master* success!
  5. Kubeadm Cluster Change To Edge cluster Success!

要有问题会直接返回相应的错误,并中断集群的转换。

  • 注意点:

    <1>. 转化的镜像默认是从docker hub superedge 仓库拉取的,目前支持amd64和arm64体系,其他体系可自行编译,按mainfests命令方式替换执行。

    <2>. 默认读取kubeconfig的顺序是:–kubeconfig > Env KUBECONFIG > ~/.kube/config


2. revert 命令

  • 含义

将edge集群恢复成最初的kubernestes原生集群。

  • 最简执行
  1. [root@master01 ~]# edgeadm revert

edgeadm默认读取${home}/.kube/config的kubeconfig文件和/etc/kubernetes/pki/ca.* 证书 要是kubeconfig 和 ca.* 不在默认路径请按全参执行。

  • 全参数执行
  1. [root@master01 ~]# edgeadm revert -p kubeadm --kubeconfig [kubeconfig文件路径] --ca.cert [集群根证书路径] --ca.key [集群根证书key路径]

要是执行过程中没有问题,会输出如下内容:

  1. [root@master01 ~]# edgeadm revert
  2. Deploy helper-job-node* success!
  3. ...
  4. Deploy helper-job-master* success!
  5. Kubeadm Cluster Revert To Edge Cluster Success!

要有问题会直接返回相应的错误,并中断集群的恢复。


3. mainfests 命令

  • 含义

输出edge集群所有的yaml文件到特定文件下

  • 最简执行
  1. [root@master01 ~]# edgeadm manifests

默认将edge集群所需要的yaml文件全部输出到./manifests/ 文件夹下

  • 全参执行
  1. [root@master01 ~]# edgeadm manifests -m /目标文件夹
  • 输出这些yaml文件有什么用?

可以根据实际情况修改yaml内容,然后用change命令部署

比如:修改了edge-health的代码,先将编译出的镜像推送到私有镜像仓库,然后部署自己编译出来的镜像 edge-health:0.1.0

  1. 修改 ./manifests/edge-health.yaml, 将镜像换成修改后的

使用 edgeadm 部署 - 图2

  1. 然后用change 命令重新转化edge cluster
  1. [root@master01 ~]# edgeadm change -m ./manifests/
  1. 查看edge-health的pod, 镜像已经变成自定义的:

使用 edgeadm 部署 - 图3

注意: manifests/下生成的yaml模板,所有参数都可以更改和自定义,更改请遵守kubernetes规范。对于带 {{.}} 的参数可直接赋值,没有赋值的 {{.}} edgeadm 工具在chenge时会自动填充。

最后修改 June 15, 2021 : Fixed missing charater in installation guide (b63d28b)