跳转至

升级 Spiderpool

本页说明如何将 DCE 5.0 的旧版本 Spiderpool，升级到新版本。本文中以 Spiderpool 到 v0.9.6 为例。

前提条件

  1. 一套 Kubernetes 集群
  2. 已安装 Helm。

获取 Chart 包与镜像

您可以根据下面两种方式之一，同步镜像包和 Chart 包到离线仓库。

方式一：升级 Addon 离线包，同步更新 Spiderpool Chart 包和镜像

Spiderpool 的离线包存放在 Addon 中，您可以参考下载 Addon 离线包，下载最新的 Addon 离线包。 在下载后，打开 clusterConfig.yaml ，修改 addonOfflinePackagePath 字段，指定 Addon 所在的路径，完成 Addon 离线包的升级。

  1. Addon 升级后，即可通过如下方式，获取 Chart 包

    参考如下方式，通过 DCE 5.0 界面下载 v0.9.6 的 Chart 包：

    spiderpool chart

  2. 上传并解压 Chart 包到环境中

    tar -xvf spiderpool-0.9.6.tgz -C /root/spiderpool

方式二：手动升级 Spiderpool

  1. 获取 Chart 包

    在环境上通过如下 Helm 方式获取 Chart 包。

    $ helm repo add spiderpool https://spidernet-io.github.io/spiderpool
$ helm repo update spiderpool

$ helm search repo spiderpool/spiderpool --versions
NAME                   CHART VERSION   APP VERSION  DESCRIPTION
spiderpool/spiderpool  0.9.6           0.9.6        ipam for kubernetes cni
...

$ helm fetch spiderpool/spiderpool --version 0.9.6

$ ls spiderpool-0.9.6.tgz
spiderpool-0.9.6.tgz

    将 Chart 包上传到离线仓库。

    # 上传 Chart 包
helm repo add [addon] http://10.5.10.210:8081 # Addon 替换为离线仓库名称，以及替换您的镜像仓库 URL
helm cm-push -u rootuser -p rootpass123 --insecure {Chart 目录或 tar 包} # 替换您的镜像仓库用户名与密码。

  2. 获取离线镜像包

    在任意可通外网的且安装了 Docker 的环境上，执行下列命令获取 Spiderpool 的镜像。

    docker pull ghcr.m.daocloud.io/spidernet-io/spiderpool/spiderpool-controller:v0.9.6
docker pull ghcr.m.daocloud.io/spidernet-io/spiderpool/spiderpool-agent:v0.9.6

    通过 docker save 保存为离线镜像 tar 包，并上传到离线环境。

    docker save -o spiderpool-0.9.6.tar ghcr.m.daocloud.io/spidernet-io/spiderpool/spiderpool-controller:v0.9.6 ghcr.m.daocloud.io/spidernet-io/spiderpool/spiderpool-agent:v0.9.6

  3. 在需升级的环境中加载镜像到 Docker 或 containerd。

    docker load -i spiderpool-0.9.6.tar

    ctr -n k8s.io image import spiderpool-0.9.6.tar

Note

每个节点都需要做 Docker 或 containerd 加载镜像操作， 加载完成后需要 tag 镜像，保持 Registry、Repository 与安装时一致。

删除 spiderpool-init

  • 在 v0.9.5 版本开始，Spiderpool 将 spiderpool-init 组件从 Pod 更改为 Job，使得升级更加灵活，如果从 v0.9.5 版本升级到更高的版本，无需删除 spiderpool-init Job。

  • 从 v0.9.5 以下的任何版本升级到比 v0.9.5 更高的版本时，在升级 Spiderpool 前，请先删除该 spiderpool-init Pod，如果不删除，可能会引发一些更新冲突，同时通过 helm upgrade 更新后，会自动创建 spiderpool-init Job， 但此时，spiderpool-init Pod 将会存在残留。

    [root@controller-node-1 ~]# kubectl get po -n kube-system spiderpool-init
NAME              READY   STATUS      RESTARTS   AGE
spiderpool-init   0/1     Completed   0          49m

[root@controller-node-1 ~]# kubectl delete po -n kube-system spiderpool-init
pod "spiderpool-init" deleted

更新 CRD

由于通过 Helm 无法在界面完成 CRD 的更新，在集群 Master 节点上通过 kubectl apply 更新 Spiderpool 版本的 CRD。

[root@controller-node-1 crds]# ls
spiderpool.spidernet.io_spidercoordinators.yaml  spiderpool.spidernet.io_spiderippools.yaml        spiderpool.spidernet.io_spiderreservedips.yaml
spiderpool.spidernet.io_spiderendpoints.yaml     spiderpool.spidernet.io_spidermultusconfigs.yaml  spiderpool.spidernet.io_spidersubnets.yaml

[root@controller-node-1 crds]# ls | grep '\.yaml$' | xargs -I {} kubectl apply -f {}
customresourcedefinition.apiextensions.k8s.io/spidercoordinators.spiderpool.spidernet.io created
customresourcedefinition.apiextensions.k8s.io/spiderendpoints.spiderpool.spidernet.io configured
customresourcedefinition.apiextensions.k8s.io/spiderippools.spiderpool.spidernet.io configured
customresourcedefinition.apiextensions.k8s.io/spidermultusconfigs.spiderpool.spidernet.io created
customresourcedefinition.apiextensions.k8s.io/spiderreservedips.spiderpool.spidernet.io configured
customresourcedefinition.apiextensions.k8s.io/spidersubnets.spiderpool.spidernet.io configured

通过 DCE 5.0 界面升级

在前面的步骤中，已经正确上传离线 Chart 与镜像包到离线环境中，现在可通过 5.0 界面执行升级。 在低于 0.7.0 的版本中，Spiderpool 会搭配 Multus-underlay 插件使用，而更高的 Spiderpool 中已经集成了 Multus 插件。 因此在低于 0.7.0 的版本升级到更高版本在界面进行更新操作时，请关闭 安装 Multus CNI 按钮，避免重复安装。如下图所示，点击 更新 ，等待更新完成。

disable multus

Note

  • Multus Setting -> MultusCNI -> Default CNI Name ：集群默认 CNI 名称。 在更新时，该值应该与安装所填的保持一致，如果安装时该值为空，那 Spiderpool 是根据/etc/cni/net.d/ 中已有的 CNI conf 文件自动获取默认 CNI，此时更新 Spiderpool 该值填入 /etc/cni/net.d/00-multus.config 文件中字段：clusterNetwork 对应的值，如 calico。

验证

升级后检查版本正常。

spiderpool 0.9.6

在 0.7.0 及以上的 Spiderpool 版本中，提供了 SpiderMultusConfig CR 来自动管理 Multus NetworkAttachmentDefinition CR。 如果您的集群中存在旧的 Multus CR，新版本由于创建机制的不同，UI 中并不会显示出来您旧有的 MUltus CR。 您可以通过界面创建同名的 Multus CR 进行纳管，并不会影响您原有功能的使用。 注意，界面上所填写的 Vlan ID、网卡接口等值，需要与您原本的 Multus CR 中保持完全一致。

multus cr create

评论