워크로드 클러스터에 Multus 배포

Multus CNI는 여러 네트워크 인터페이스를 단일 포드에 연결하고 각각을 다른 주소 범위와 연결할 수 있게 해주는 Kubernetes용 컨테이너 네트워크 인터페이스(CNI) 플러그인입니다.

이 항목에서는 Multus 패키지를 워크로드 클러스터에 설치하고 이를 사용하여 여러 네트워크 인터페이스가 있는 포드를 생성하는 방법을 설명합니다. 예를 들어 Antrea 또는 Calico를 기본 CNI로, 하드웨어 또는 가속 인터페이스를 위한 macvlan 또는 ipvlan 또는 SR-IOV 또는 DPDK 디바이스와 같은 보조 인터페이스를 생성합니다.

macvlan 및 ipvlan용 바이너리는 워크로드 클러스터 노드 템플릿에 이미 설치되어 있습니다.

사전 요구 사항

  • 다음이 설치된 부트스트랩 시스템:
  • 하나 이상의 워크로드 클러스터가 있고 vSphere에서 실행되는 Tanzu Kubernetes Grid.

Multus CNI 패키지 설치

참고: 클러스터에 Multus CNI가 설치되면 삭제하면 안 됩니다. 아래의 지원되지 않는 Multus 삭제를 참조하십시오.

워크로드 클러스터에 Multus CNI 패키지를 설치하고 이를 사용하도록 클러스터를 구성하려면 다음을 수행합니다.

  1. 아직 하지 않았다면 standard 패키지 저장소를 클러스터에 추가합니다.

    tanzu package repository add tanzu-standard --url projects.registry.vmware.com/tkg/packages/standard/repo:v1.6.0 --namespace tkg-system
    
  2. (선택 사항) Multus를 구성하려면 다음을 수행합니다.

    1. Multus 매개 변수를 검색하여 Daemonset로 배포하는 구성 파일을 생성합니다.

      tanzu package available get multus.tanzu.vmware.com/PACKAGE-VERSION --generate-default-values-file
      

      여기서 PACKAGE-VERSION은 설치하려는 Multus 패키지의 버전입니다. 위 명령은 기본값이 포함된 multus-cni-default-values.yaml 구성 파일을 생성합니다.

      구성 파일의 설정에 대한 자세한 내용은 Multus entrypoint.sh 스크립트를 참조하십시오.

    2. tanzu package available list 명령을 실행하여 사용 가능한 Multus 패키지 버전을 표시합니다. 예를 들면 다음과 같습니다.

      tanzu package available list multus-cni.tanzu.vmware.com -A
       NAME                        VERSION              RELEASED-AT                   NAMESPACE
       multus-cni.tanzu.vmware.com 3.7.1+vmware.1-tkg.1 2021-06-04 18:00:00 +0000 UTC tanzu-package-repo-global
       multus-cni.tanzu.vmware.com 3.7.1+vmware.2-tkg.1 2021-06-04 18:00:00 +0000 UTC tanzu-package-repo-global
       multus-cni.tanzu.vmware.com 3.7.1+vmware.2-tkg.2 2021-06-04 18:00:00 +0000 UTC tanzu-package-repo-global
      

      참고: 네트워크 제한 환경에서 작업하는 경우 사용자 지정 이미지 레지스트리에 연결할 수 있는지 확인합니다.

    3. --values-schema와 함께 tanzu package available get 명령을 실행하여 설정할 수 있는 필드 값을 확인합니다.

      tanzu package available get multus-cni.tanzu.vmware.com/VERSION --values-schema -o FORMAT
      

      형식 설명: VERSIONtanzu package available list 출력에 표시된 버전입니다. FORMATyaml 또는 json입니다.

    4. multus-cni-default-values.yaml 구성 파일을 원하는 필드 값으로 채웁합니다.

  3. multus-cni-default-values.yaml 파일에서 모든 주석을 제거합니다.

    yq -i eval '... comments=""' multus-cni-default-values.yaml
    
  4. tanzu package install을 실행하여 패키지를 설치합니다.

    tanzu package install INSTALLED_PACKAGE_NAME --package-name multus-cni.tanzu.vmware.com --version <version> -f  multus-cni-default-values.yaml
    
  5. tanzu package installed get을 실행하여 설치된 패키지의 상태를 확인합니다.

    tanzu package installed get INSTALLED_PACKAGE_NAME -o <json|yaml|table>
    
  6. Multus CNI에서 사용할 네트워크 인터페이스의 CNI 구성을 정의하는 NetworkAttachmentDefinition의 사용자 지정 리소스 정의(CRD)를 생성합니다.

    1. CRD 규격을 생성합니다. 예를 들어 이 multus-cni-crd.yamlmacvlan CNI를 구성하고 macvlan-conf라는 NetworkAttachmentDefinition을 지정합니다.

      apiVersion: "k8s.cni.cncf.io/v1"
      kind: NetworkAttachmentDefinition
      metadata:
        name: macvlan-conf
      spec:
        config: '{
            "cniVersion": "0.3.0",
            "type": "macvlan",
            "master": "eth0",
            "mode": "bridge",
            "ipam": {
              "type": "host-local",
              "subnet": "192.168.1.0/24",
              "rangeStart": "192.168.1.200",
              "rangeEnd": "192.168.1.216",
              "routes": [
                { "dst": "0.0.0.0/0" }
              ],
              "gateway": "192.168.1.1"
            }
          }'
      
    2. 리소스를 생성합니다. 예: kubectl create -f multus-cni-crd.yaml

  7. 쉼표로 구분된 NetworkAttachmentDefinition 사용자 지정 리소스 이름 목록을 사용하는 주석 k8s.v1.cni.cncf.io/networks를 사용하여 포드를 생성합니다.

    1. 포드 규격을 생성합니다. 예: my-multi-cni-pod.yaml:

      apiVersion: v1
      kind: Pod
      metadata:
        name: sample-pod
        annotations:
          k8s.v1.cni.cncf.io/networks: macvlan-conf
      spec:
        containers:
        - name: sample-pod
          command: ["/bin/ash", "-c", "trap : TERM INT; sleep infinity & wait"]
          image: harbor-repo.vmware.com/dockerhub-proxy-cache/library/alpine
      
      
    2. 포드를 생성합니다. 예를 들어 kubectl create -f my-multi-cni-crd.yaml은 포드 sample-pod를 생성합니다.

포드가 생성되면 다음과 같은 세 가지 네트워크 인터페이스가 있습니다.

  • lo 루프백 인터페이스
  • eth0 Antrea 또는 Calico CNI에서 관리하는 기본 포드 네트워크
  • net1 주석 k8s.v1.cni.cncf.io/networks: macvlan-conf를 통해 생성된 새 인터페이스.

참고: 기본 네트워크에는 eth0이라는 이름이 지정되고 추가 네트워크 포드 인터페이스에는 net1, net2 등의 이름이 지정됩니다.

Multus 검증

포드에서 kubectl describe pod를 실행하고, 주석 k8s.v1.cni.cncf.io/network-status가 모든 네트워크 인터페이스를 표시하는지 확인합니다. 예:

$ kubectl describe pod sample-pod

Name:         sample-pod
Namespace:    default
Priority:     0
Node:         tcecluster-md-0-6476897f75-rl9vt/10.170.109.225
Start Time:   Thu, 27 May 2021 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.1.201"
                    ],
                    "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로 실행 중인지 확인합니다.

지원되지 않는 Multus 삭제

클러스터에 Multus CNI가 설치되면 삭제하면 안 됩니다.

Multus를 제거해도 CNI 스크립트 디렉토리에서 Multus 구성 파일 /etc/cni/net.d/00-multus.conf가 제거되지 않기 때문에 클러스터가 새 포드를 생성할 수 없습니다.

이는 알려진 문제입니다. Multus 저장소에서 문제 #461을 참조하십시오.

check-circle-line exclamation-circle-line close-line
Scroll to top icon