# 升级 Spiderpool

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

## 前提条件

1. 一套 Kubernetes 集群
2. 已安装 [Helm](https://helm.sh/docs/intro/install/)。

## 获取 Chart 包与镜像

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

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

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

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

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

    ![spiderpool chart](../../images/spiderpool-upgrade-chart.png)

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

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

### 方式二：手动升级 Spiderpool

1. 获取 Chart 包

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

    ```bash
    $ 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 包上传到离线仓库。

    ```shell
    # 上传 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 的镜像。

    ```shell
    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 包，并上传到离线环境。

    ```shell
    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"

        ```shell
        docker load -i spiderpool-0.9.6.tar
        ```

    === "containerd"

        ```shell
        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 将会存在残留。

    ```bash
    [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。

```bash
[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](https://docs.daocloud.io/daocloud-docs-images/docs/zh/docs/network/images/spiderpool-disable-multus.png)

!!! 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](../../images//spiderpool-after-upgrade.png)

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

![multus cr create](https://docs.daocloud.io/daocloud-docs-images/docs/zh/docs/network/images/spiderpool-multus-cr-create.png)