在工作負載叢集上部署使用 Whereabouts 的 Multus
Whereabouts 是 IP 位址管理 (IPAM) CNI 外掛程式，可跨叢集中的所有節點動態指派 IP 位址給 Pod。不同於其他 IPAM 外掛程式 (例如 host-local) 僅指派 IP 位址給同一節點上的 Pod，whereabouts 指派叢集範圍的 IP 位址。
在本主題中，我們說明如何將次要網路介面連結到 Pod，而指派給該 Pod 的 IP 位址在您使用 whereabouts 指定的範圍內。例如，您會有 Antrea 或 Calico 作為主要 CNI、使用 macvlan 或 ipvlan 建立的次要介面，以及 Whereabouts 作為 IPAM CNI。
必要條件
- 安裝以下項目的啟動機器：
- 支援多個網路的 Multis CNI 套件。如需詳細資訊，請參閱在工作負載叢集上部署 Multus。
- Tanzu CLI、Tanzu CLI 外掛程式和
kubectl，如安裝 Tanzu CLI 和 Kubernetes CLI 以與獨立管理叢集配合使用中所述。 - yq v4.5 或更新版本。
- 在 vSphere、Amazon Web Services (AWS) 或 Azure 上執行的 Tanzu Kubernetes Grid 管理叢集和工作負載叢集。
- Whereabouts 需要大小為
large或extra-large的工作負載叢集工作節點，如預定義的節點大小中所述。
- Whereabouts 需要大小為
安裝 Whereabouts 套件
若要在工作負載叢集上安裝 Whereabouts 套件，並將叢集設定為使用該套件，請執行以下動作：
-
設定和安裝 Whereabouts。
-
建立組態檔來擷取 Whereabouts 參數。
tanzu package available get whereabouts.tanzu.vmware.com/PACKAGE-VERSION --default-values-file-output FILE-PATH附註
部署
whereabouts元件的命名空間必須為kube-system。任何自訂的命名空間安裝都將失敗。其中，
PACKAGE-VERSION是您要安裝的 Whereabouts 套件版本，FILE-PATH是用來儲存組態檔的位置，例如，whereabouts-data-values.yaml。上面的命令建立名為whereabouts-data-values.yaml的組態檔，其中包含預設值。 -
執行
tanzu package available list命令以列出可用的 Whereabouts 套件版本，例如：tanzu package available list whereabouts.tanzu.vmware.com -A NAME VERSION RELEASED-AT NAMESPACE whereabouts.tanzu.vmware.com 0.6.1+vmware.2-tkg.1 2023-30-04 18:00:00 +0000 UTC tanzu-package-repo-global附註
如果在網路受限環境中操作，請確保可以存取自訂映像登錄。
-
執行
tanzu package available get命令搭配--values-schema，以查看可設定哪些欄位值：tanzu package available get whereabouts.tanzu.vmware.com/VERSION --values-schema -o FORMAT其中：-
VERSION是tanzu package available list輸出中列出的版本 -FORMAT為yaml或json -
在
whereabouts-data-values.yaml組態檔中填入所需的欄位值。
-
-
從
whereabouts-data-values.yaml檔案中移除所有註解：yq -i eval '... comments=""' whereabouts-cni-default-values.yaml -
執行
tanzu package install以安裝套件。tanzu package install whereabouts --package whereabouts.tanzu.vmware.com --version AVAILABLE-PACKAGE-VERSION --values-file whereabouts-data-values.yaml --namespace TARGET-NAMESPACE其中：
-
TARGET-NAMESPACE是要在其中安裝 Whereabouts 軟體包的命名空間。例如，my-packages或tanzu-cli-managed-packages命名空間。- 如果未指定
--namespace旗標，則 Tanzu CLI 會在default命名空間中安裝套件。 - 指定的命名空間必須已存在，例如，從執行
kubectl create namespace my-packages。
- 如果未指定
AVAILABLE-PACKAGE-VERSION是您在上方所擷取的版本，例如0.6.1+vmware.2-tkg.1。
-
-
執行
tanzu package installed get以檢查已安裝的套件狀態。tanzu package installed get whereabouts -o <json|yaml|table> -
為
NetworkAttachmentDefinition建立自訂資源定義 (CRD)，針對以 Whereabouts 為 IPAM 類型的 Multus CNI 所使用的網路介面定義 CNI 組態。-
建立 CRD 規格。例如，此
multus-cni-crd.yaml指定名為macvlan-conf的NetworkAttachmentDefinition，其中設定macvlanCNI 並以whereabouts為 IPAM 類型：--- apiVersion: "k8s.cni.cncf.io/v1" kind: NetworkAttachmentDefinition metadata: name: macvlan-conf spec: config: '{ "cniVersion": "0.3.1", "plugins": [ { "type": "macvlan", "capabilities": { "ips": true }, "master": "eth0", "mode": "bridge", "ipam": { "type": "whereabouts", "range": "192.168.20.0/24", "range_start": "192.168.20.10", "range_end": "192.168.20.100", "gateway": "192.168.20.1" } } ] }' -
建立資源，例如
kubectl create -f multus-cni-crd.yaml
-
-
建立含有註解
k8s.v1.cni.cncf.io/networks的 Pod，以指定要新增的其他網路。-
建立網繭規格，例如
my-multi-cni-pod.yaml：apiVersion: v1 kind: Pod metadata: name: pod0 annotations: k8s.v1.cni.cncf.io/networks: macvlan-conf spec: containers: - name: pod0 command: ["/bin/ash", "-c", "trap : TERM INT; sleep infinity & wait"] image: docker.io/kserving/tools:latest -
建立網繭。例如，
kubectl create -f my-multi-cni-crd.yaml建立網繭pod0。 -
建立的網繭會有三個網路介面：
lo回送介面eth0由 Antrea 或 Calico CNI 管理的預設網繭網路net1透過註解k8s.v1.cni.cncf.io/networks: macvlan-conf建立的新介面。
附註
預設網路的名稱為
eth0，其他網路網繭介面的名稱為net1、net2等。 -
在
pod0上執行kubectl describe pod，並確認註解k8s.v1.cni.cncf.io/network-status列出所有網路介面。例如：
$ kubectl describe pod pod0 Name: pod0 Namespace: default Priority: 0 Node: tcecluster-md-0-6476897f75-rl9vt/10.170.109.225 Start Time: Thu, 25 August 2022 15:31:20 +0000 Labels: <none> Annotations: k8s.v1.cni.cncf.io/network-status: [{ "name": "", "interface": "eth0", "ips": [ "100.96.1.80" ], "mac": "66:39:dc:63:50:a3", "default": true, "dns": {} },{ "name": "default/macvlan-conf", "interface": "net1", "ips": [ "192.168.20.11" ], "mac": "02:77:cb:a0:60:e3", "dns": {} }] k8s.v1.cni.cncf.io/networks: macvlan-conf然後，執行
kubectl exec sample-pod -- ip a show dev net1，以檢查目標介面是否以上面註解列出的 IP 啟動並執行。針對將在下一步建立的其他網繭，重複此步驟以驗證組態。
-
-
建立兩個額外的網繭：
pod1在同一節點上，pod2在另一個節點上。我們將使用這些網繭驗證單一節點內和整個叢集的節點之間的網路存取。
驗證整個叢集的網繭之間的網路流量
現在，您可以檢查同一節點中的網繭和整個叢集的網繭之間的網路存取。
-
驗證同一節點上的網繭之間的網路存取是否正常運作。例如，以下命令驗證
pod0是否可以透過指派的 IP 位址連線到pod1。kubectl exec -it pod0 -- ping -c 3 192.168.20.12 PING 192.168.20.12 (192.168.20.12) 56(84) bytes of data. 64 bytes from 192.168.20.12: icmp_seq=1 ttl=64 time=0.237 ms 64 bytes from 192.168.20.12: icmp_seq=2 ttl=64 time=0.215 ms 64 bytes from 192.168.20.12: icmp_seq=3 ttl=64 time=0.156 ms --- 192.168.20.12 ping statistics --- 3 packets transmitted, 3 received, 0% packet loss, time 2030ms rtt min/avg/max/mdev = 0.156/0.202/0.237/0.037 ms -
驗證不同節點上的網繭之間的網路存取是否正常運作。例如，以下命令驗證
pod0是否可以透過指派的 IP 位址連線到pod2。kubectl exec -it pod0 -- ping -c 3 <192.168.20.13 PING 192.168.20.13 (192.168.20.13) 56(84) bytes of data. 64 bytes from 192.168.20.13: icmp_seq=1 ttl=64 time=0.799 ms 64 bytes from 192.168.20.13: icmp_seq=2 ttl=64 time=0.626 ms 64 bytes from 192.168.20.13: icmp_seq=3 ttl=64 time=0.655 ms --- 192.168.20.13 ping statistics --- 3 packets transmitted, 3 received, 0% packet loss, time 2030ms rtt min/avg/max/mdev = 0.626/0.693/0.799/0.078 ms
