创建 Multus CR¶

Multus CR 管理，是 Spiderpool 对 Multus CNI 中配置实例的二次封装。旨在为容器提供更灵活的网络连接和配置选项，以满足不同的网络需求，为用户提供更简单和经济高效的使用体验。本页介绍在创建工作负载使用多网卡配置之前，如何创建 Multus CR。如需创建新的 Multus CR 实例，可参考此文档。

前提条件¶

SpiderPool 已成功部署, SpiderPool v0.8.7 已包含 Multus-underlay 的全部功能。

界面操作¶

登录 DCE UI 后，在左侧导航栏点击 容器管理 —> 集群列表，找到对应集群。然后在左侧导航栏点击 容器网络 —> 网络配置。
进入 网络配置 —> Multus CR 管理 ，点击创建 Multus CR 。

Note

创建 Multus CR 时，CNI 类型只能为 macvlan、ipvlan、sriov 和自定义四种类型四选一，可分成三种场景，参考以下三种参数方式进行配置。

创建 macvlan 或 ipvlan 类型的 Multus CR¶

请输入如下参数：

创建 Multus CR

参数	说明
名称	Multus CNI 配置的实例名称，即 Multus CR 名称。
描述	实例的描述信息。
CNI 类型	CNI 的类型，目前界面可选择 `macvlan`、`ipvlan`。
VLAN ID	当 CNI 类型为 `macvlan`、`ipvlan`、`sriov` 时允许配置，`0` 和 `""` 的效果一致。
网卡配置	- 网卡配置中包含接口配置信息。 - 请确保主网卡存在于主机上。 - 如果使用基于 MacVlan/IPVlan 的共享 RDMA 功能，请确保该网卡具备 RDMA 能力。 - 当网卡接口数量为 1 时，默认只有一个接口配置；当接口数量 ≥ 2 时，可进行 Bond 配置。
网卡接口	仅用于 CNI 类型为 `macvlan`、`ipvlan`，至少有 1 个元素；若 ≥ 2 个元素，`bond` 必须非空。
Bond 信息	名称不能为空，模式必须在 `[0,6]` 范围内，对应： 0. balance-rr 1. active-backup 2. balance-xor 3. broadcast 4. 802.3ad 5. balance-tlb 6. balance-alb
IPv4 默认池	CNI 配置文件 IPv4 默认池，参数可选，格式：`k1=v1;k2=v2;k3=v3`。
IPv6 默认池	CNI 配置文件 IPv6 默认池，参数可选，格式：`k1=v1;k2=v2;k3=v3`。

VLAN 配置说明¶

Underlay 网络是指底层物理网络，通常涉及 VLAN 网络。如果 Underlay 网络不涉及到 VLAN 网络，不需要配置 VLAN ID (默认值为 0 即可)。

对于 VLAN 子接口:
- 如果网络管理员已经创建好 VLAN 子接口，那么不需要填写 VLAN ID (默认值为 0 即可)，只需要将创建好的 VLAN 子接口 填入到网卡接口(Master) 字段。
- 如果需要自动创建 VLAN 子接口 ，那么需要配置 VLAN ID，并将主网卡接口(Master)设置为对应的 父接口 Spiderpool 在创建 Pod 时，在主机上动态创建一个名为: <master>.<vlanID> 的 子接口，以将 Pod 连接到 VLAN 网络。
对于 Bond 网卡:
- 如果网络管理员已经创建好 Bond 网卡，并且使用 Bond 网卡 连接 Pod 的 Underlay 网络，那么不需要填写 VLAN ID (默认值为 0 即可) 只需要将创建好的 Bond 网卡名称 填入到网卡接口(Master) 字段。
- 如果网络管理员已经创建好 Bond 网卡，并且使用 Bond 网卡 连接 Pod 的 Underlay 网络，那么不需要填写 VLAN ID (默认值为 0 即可)，只需要将创建好的 Bond 网卡名称 填入到网卡接口(Master) 字段。 Spiderpool 在创建 Pod 时，在主机上动态创建一张 Bond 网卡，以用于连接 Pod 的 Underlay 网络。
对于 RDMA 网卡：
- 如果基于 Macvlan/IPvlan/SR-IOV 暴露主机上的 RoCE 网卡给到 Pod 使用时， VLAN ID 无需填写，默认为 0 即可。
使用 Bond 网卡创建 VLAN 子接口：
- 如果需要在创建 Bond 网卡 的同时，需要创建VLAN 子接口来承接 Pod 网络，需要配置 VLAN ID Spiderpool 在创建 Pod 时，在主机上动态创建一个名为: <bondName>.<vlanID> 的 VLAN 子接口 ，以用于连接 Pod 的 VLAN 网络。
- 所有通过 Spiderpool 创建的接口，都不会配置 IP，并且这些接口不是持久化的。如果被意外删除或节点重启，这些接口将会被删除，重启 Pod 后会自动重新创建这些接口, 如果需要持久化这些接口或者配置 IP 地址，可以考虑使用 nmcli 工具。

创建 SR-IOV 类型的 Multus CR¶

请输入如下参数：

创建multus cr

CNI 类型 ：选择 SR-IOV
Vlan ID : 必需填入 0
RDMA ：默认关闭。如果需要开启，请满足 RDMA 资源使用条件
SR-IOV 资源 ：只用于sriov类型, 选择资源名称。如何查看 SR-IOV 资源请参考：SR-IOV CNI 配置

SR-IOV 资源配置说明：

SR-IOV resourceName 为部署sriovnetworknodepolicies 时自定义名称。

如果 基于 SR-IOV 搭配 RDMA 使用，SR-IOV 资源配置查询如下：

命令查询：

如下的 spidernet.io/sriov_netdevice_enp4s0f0np0 为查询的资源名称。

   kubectl get no -o json | jq -r '[.items[] | {name:.metadata.name, allocable:.status.allocatable}]'
   [
     {
       "name": "10-20-1-220",
       "allocable": {
         "cpu": "56",
         "ephemeral-storage": "3971227249029",
         "hugepages-1Gi": "0",
         "hugepages-2Mi": "0",
         "memory": "131779740Ki",
         "pods": "110",
         "spidernet.io/hca_shared_devices": "0",
         "spidernet.io/mellanoxrdma": "0",
         "spidernet.io/sriov_netdevice": "0",
         "spidernet.io/sriov_netdevice_enp4s0f0np0": "8", # 查询的 RDMA 设备资源名称及数量
         ...
       }
     }

界面查询：

查询的resourceName需要加上 spidernet.io/前缀。

networkconfig09

创建自定义类型的 Multus CR¶

请输入如下参数：

创建 Multus CR

JSON ：自定义类型时，需判断输入一个合法格式的 Json 文件。

创建完成后工作负载即可使用 Multus CR 管理。

创建 Multus CR¶

前提条件¶

界面操作¶

创建 macvlan 或 ipvlan 类型的 Multus CR¶

VLAN 配置说明¶

创建 SR-IOV 类型的 Multus CR¶

创建自定义类型的 Multus CR¶

评论