2장. 기본 네트워크

프로세스

1. 선택 사항: 기본 네트워크를 사용하는 ClusterUserDefinedNetwork CR의 경우 다음 명령을 입력하여 k8s.ovn.org/primary-user-defined-network 레이블이 있는 네임스페이스를 만듭니다.

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     name: <cudn_namespace_name>
     labels:
       k8s.ovn.org/primary-user-defined-network: ""
   EOF

   Copy to Clipboard Toggle word wrap

2. Layer2 또는 Layer3 토폴로지 유형 클러스터 전체 사용자 정의 네트워크에 대한 요청을 만듭니다.

   1. 다음 예와 같이 Layer2 토폴로지에 대한 요청을 정의하려면 cluster-layer-two-udn.yaml 과 같은 YAML 파일을 만듭니다.

      apiVersion: k8s.ovn.org/v1
      kind: ClusterUserDefinedNetwork
      metadata:
        name: <cudn_name> 

      1

      
      spec:
        namespaceSelector: 

      2

      
          matchLabels: 

      3

      
            "<label_1_key>": "<label_1_value>" 

      4

      
            "<label_2_key>": "<label_2_value>" 

      5

      
        network: 

      6

      
          topology: Layer2 

      7

      
          layer2: 

      8

      
            role: Primary 

      9

      
            subnets:
              - "2001:db8::/64"
              - "10.100.0.0/16" 

      10

      Copy to Clipboard Toggle word wrap

      1

      ClusterUserDefinedNetwork CR의 이름입니다.

      2

      클러스터 UDN CR이 적용되는 네임스페이스 세트에 대한 레이블 쿼리입니다. 표준 Kubernetes MatchLabel 선택기를 사용합니다. default 또는 openshift-* 네임스페이스를 가리켜서는 안 됩니다.

      3

      AND 관계로 용어를 평가하는 matchLabels 선택기 유형을 사용합니다.

      4 5

      matchLabels 선택기 유형이 사용되므로 <label_1_key>=<label_1_value> 와 <label_2_key>=<label_2_value> 레이블을 모두 포함하는 네임스페이스가 제공됩니다.

      6

      네트워크 구성을 설명합니다.

      7

      토폴로지 필드는 네트워크 구성을 설명합니다. 허용되는 값은 Layer2 와 Layer3 입니다. Layer2 토폴로지 유형을 지정하면 모든 노드에서 공유되는 하나의 논리적 스위치가 생성됩니다.

      8

      이 필드는 토폴로지 구성을 지정합니다. layer2 또는 layer3 이 될 수 있습니다.

      9

      기본 또는 보조를 지정합니다. Primary는 4.19에서 지원되는 유일한 역할 사양입니다.

      10

      Layer2 토폴로지 유형의 경우 다음은 서브넷 필드에 대한 구성 세부 정보를 지정합니다.

      • 서브넷 필드는 선택 사항입니다.
      • 서브넷 필드는 문자열 유형이며 IPv4와 IPv6 모두에 대한 표준 CIDR 형식을 허용합니다.
      • 서브넷 필드에는 1개 또는 2개의 항목이 허용됩니다. 두 품목은 서로 다른 계열에 속해야 합니다. 예를 들어, 서브넷 값은 10.100.0.0/16 및 2001:db8::/64입니다 .
      • Layer2 서브넷은 생략될 수 있습니다. 생략하면 사용자는 포드에 대한 정적 IP 주소를 구성해야 합니다. 결과적으로 포트 보안은 MAC 스푸핑만 방지합니다. 자세한 내용은 "고정 IP 주소로 Pod 구성"을 참조하세요.

   2. 다음 예와 같이 Layer3 토폴로지에 대한 요청을 정의하려면 cluster-layer-three-udn.yaml 과 같은 YAML 파일을 만듭니다.

      apiVersion: k8s.ovn.org/v1
      kind: ClusterUserDefinedNetwork
      metadata:
        name: <cudn_name> 

      1

      
      spec:
        namespaceSelector: 

      2

      
          matchExpressions: 

      3

      
          - key: kubernetes.io/metadata.name 

      4

      
            operator: In 

      5

      
            values: ["<example_namespace_one>", "<example_namespace_two>"] 

      6

      
        network: 

      7

      
          topology: Layer3 

      8

      
          layer3: 

      9

      
            role: Primary 

      10

      
            subnets: 

      11

      
              - cidr: 10.100.0.0/16
                hostSubnet: 24

      Copy to Clipboard Toggle word wrap

      1

      ClusterUserDefinedNetwork CR의 이름입니다.

      2

      클러스터 UDN이 적용되는 네임스페이스 세트에 대한 레이블 쿼리입니다. 표준 Kubernetes MatchLabel 선택기를 사용합니다. default 또는 openshift-* 네임스페이스를 가리켜서는 안 됩니다.

      3

      OR 관계로 용어를 평가하는 matchExpressions 선택기 유형을 사용합니다.

      4

      일치시킬 레이블 키를 지정합니다.

      5

      연산자를 지정합니다. 유효한 값은 다음과 같습니다: In , NotIn , Exists , DoesNotExist .

      6

      matchExpressions 유형이 사용되므로 <example_namespace_one> 또는 <example_namespace_two> 와 일치하는 네임스페이스가 프로비저닝됩니다.

      7

      네트워크 구성을 설명합니다.

      8

      토폴로지 필드는 네트워크 구성을 설명합니다. 허용되는 값은 Layer2 와 Layer3 입니다. Layer3 토폴로지 유형을 지정하면 노드당 다른 서브넷을 갖는 Layer 2 세그먼트가 생성됩니다. 3계층 라우팅은 노드 서브넷을 상호 연결하는 데 사용됩니다.

      9

      이 필드는 토폴로지 구성을 지정합니다. 유효한 값은 layer2 또는 layer3 입니다.

      10

      기본 또는 보조 역할을 지정합니다. Primary는 4.19에서 지원되는 유일한 역할 사양입니다.

      11

      Layer3 토폴로지 유형의 경우 다음은 서브넷 필드에 대한 구성 세부 정보를 지정합니다.

      • 서브넷 필드는 필수입니다.

      • 서브넷 필드의 유형은 cidr 및 hostSubnet 입니다.

        • cidr 은 클러스터 서브넷이며 문자열 값을 허용합니다.
        • hostSubnet은 클러스터 서브넷이 분할되는 노드 서브넷 접두사를 지정합니다.
        • IPv6의 경우 hostSubnet 에 대해 /64 길이만 지원됩니다.

3. 다음 명령을 실행하여 요청을 적용하세요.

   $ oc create --validate=true -f <example_cluster_udn>.yaml

   Copy to Clipboard Toggle word wrap

   여기서 <example_cluster_udn>.yaml은 Layer2 또는 Layer3 구성 파일의 이름입니다.

4. 다음 명령을 실행하여 요청이 성공했는지 확인하세요.

   $ oc get clusteruserdefinednetwork <cudn_name> -o yaml

   Copy to Clipboard Toggle word wrap

   여기서 <cudn_name> 은 클러스터 전체 사용자 정의 네트워크에 대해 생성한 이름입니다.

   출력 예

   apiVersion: k8s.ovn.org/v1
   kind: ClusterUserDefinedNetwork
   metadata:
     creationTimestamp: "2024-12-05T15:53:00Z"
     finalizers:
     - k8s.ovn.org/user-defined-network-protection
     generation: 1
     name: my-cudn
     resourceVersion: "47985"
     uid: 16ee0fcf-74d1-4826-a6b7-25c737c1a634
   spec:
     namespaceSelector:
       matchExpressions:
       - key: custom.network.selector
         operator: In
         values:
         - example-namespace-1
         - example-namespace-2
         - example-namespace-3
     network:
       layer3:
         role: Primary
         subnets:
         - cidr: 10.100.0.0/16
       topology: Layer3
   status:
     conditions:
     - lastTransitionTime: "2024-11-19T16:46:34Z"
       message: 'NetworkAttachmentDefinition has been created in following namespaces:
         [example-namespace-1, example-namespace-2, example-namespace-3]'
       reason: NetworkAttachmentDefinitionReady
       status: "True"
       type: NetworkCreated

   Copy to Clipboard Toggle word wrap

프로세스

1. Localnet 토폴로지를 사용하여 클러스터 전체 사용자 정의 네트워크를 만듭니다.

   1. 다음 예와 같이 Localnet 토폴로지에 대한 요청을 정의하려면 cluster-udn-localnet.yaml 과 같은 YAML 파일을 만듭니다.

      apiVersion: k8s.ovn.org/v1
      kind: ClusterUserDefinedNetwork
      metadata:
        name: <cudn_name> 

      1

      
      spec:
        namespaceSelector: 

      2

      
          matchLabels: 

      3

      
            "<label_1_key>": "<label_1_value>" 

      4

      
            "<label_2_key>": "<label_2_value>" 

      5

      
        network: 

      6

      
          topology: Localnet 

      7

      
          localnet: 

      8

      
            role: Secondary 

      9

      
            physicalNetworkName: test
            ipam: {lifecycle: Persistent}
            subnets: ["192.168.0.0/16", "2001:dbb::/64"] 

      10

      Copy to Clipboard Toggle word wrap

      1

      ClusterUserDefinedNetwork (CUDN) CR의 이름입니다.

      2

      클러스터 CUDN CR이 적용되는 네임스페이스 세트에 대한 레이블 쿼리입니다. 표준 Kubernetes MatchLabel 선택기를 사용합니다. default , openshift-* 또는 다른 시스템 네임스페이스를 가리켜서는 안 됩니다.

      3

      AND 관계로 용어를 평가하는 matchLabels 선택기 유형을 사용합니다.

      4 5

      이 예에서 CUDN CR은 <label_1_key>=<label_1_value> 와 <label_2_key>=<label_2_value> 레이블을 모두 포함하는 네임스페이스에 배포됩니다.

      6

      네트워크 구성을 설명합니다.

      7

      Localnet 토폴로지 유형을 지정하면 하나의 공급자 네트워크에 직접 연결되는 하나의 논리적 스위치가 생성됩니다.

      8

      이 필드는 로컬넷 토폴로지를 지정합니다.

      9

      네트워크 구성에 대한 역할을 지정합니다. 보조 역할 은 로컬넷 토폴로지에 지원되는 유일한 역할 사양입니다.

      10

      로컬넷 토폴로지 유형의 경우 다음은 서브넷 필드에 대한 구성 세부 정보를 지정합니다.

      • 서브넷 필드는 선택 사항입니다.
      • 서브넷 필드는 문자열 유형이며 IPv4와 IPv6 모두에 대한 표준 CIDR 형식을 허용합니다.
      • 서브넷 필드에는 1개 또는 2개의 항목이 허용됩니다. 두 항목은 서로 다른 IP 패밀리에 속해야 합니다. 예를 들어, 서브넷 값은 10.100.0.0/16 및 2001:db8::/64입니다 .
      • localnet 서브넷은 생략될 수 있습니다. 생략하면 사용자는 포드에 대한 정적 IP 주소를 구성해야 합니다. 결과적으로 포트 보안은 MAC 스푸핑만 방지합니다. 자세한 내용은 "고정 IP 주소로 Pod 구성"을 참조하세요.

2. 다음 명령을 실행하여 요청을 적용하세요.

   $ oc create --validate=true -f <example_cluster_udn>.yaml

   Copy to Clipboard Toggle word wrap

   다음과 같습니다.

   <example_cluster_udn>.yaml

   Localnet 구성 파일의 이름입니다.

3. 다음 명령을 실행하여 요청이 성공했는지 확인하세요.

   $ oc get clusteruserdefinednetwork <cudn_name> -o yaml

   Copy to Clipboard Toggle word wrap

   다음과 같습니다.

   <cudn_name>

   클러스터 전체 사용자 정의 네트워크에 대해 생성한 이름입니다.

프로세스

1. 관리자 관점에서 네트워킹 사용자 정의 네트워크를 클릭합니다.
2. ClusterUserDefinedNetwork를 클릭합니다.
3. 이름 필드에서 클러스터 범위 UDN의 이름을 지정합니다.
4. 서브넷 필드에 값을 지정합니다.
5. 프로젝트 일치 레이블 필드에서 클러스터 UDN이 적용되는 네임스페이스를 선택하기 위해 적절한 레이블을 추가합니다.
6. 생성을 클릭합니다. 클러스터 범위 UDN은 5단계에서 지정한 레이블이 포함된 네임스페이스에 있는 포드의 기본 기본 네트워크 역할을 합니다.

프로세스

1. 선택 사항: 기본 네트워크를 사용하는 UserDefinedNetwork CR의 경우 다음 명령을 입력하여 k8s.ovn.org/primary-user-defined-network 레이블이 있는 네임스페이스를 만듭니다.

   $ cat << EOF | oc apply -f -
   apiVersion: v1
   kind: Namespace
   metadata:
     name: <udn_namespace_name>
     labels:
       k8s.ovn.org/primary-user-defined-network: ""
   EOF

   Copy to Clipboard Toggle word wrap

2. Layer2 또는 Layer3 토폴로지 유형 사용자 정의 네트워크에 대한 요청을 만듭니다.

   1. 다음 예와 같이 Layer2 토폴로지에 대한 요청을 정의하려면 my-layer-two-udn.yaml 과 같은 YAML 파일을 만듭니다.

      apiVersion: k8s.ovn.org/v1
      kind: UserDefinedNetwork
      metadata:
        name: udn-1 

      1

      
        namespace: <some_custom_namespace>
      spec:
        topology: Layer2 

      2

      
        layer2: 

      3

      
          role: Primary 

      4

      
          subnets:
            - "10.0.0.0/24"
            - "2001:db8::/60" 

      5

      Copy to Clipboard Toggle word wrap

      1

      UserDefinedNetwork 리소스의 이름입니다. 이는 기본값이어서 는 안 되며 클러스터 네트워크 운영자(CNO)가 생성한 글로벌 네임스페이스와 중복되어서는 안 됩니다.

      2

      토폴로지 필드는 네트워크 구성을 설명합니다. 허용되는 값은 Layer2 와 Layer3 입니다. Layer2 토폴로지 유형을 지정하면 모든 노드에서 공유되는 하나의 논리적 스위치가 생성됩니다.

      3

      이 필드는 토폴로지 구성을 지정합니다. layer2 또는 layer3 이 될 수 있습니다.

      4

      기본 또는 보조 역할을 지정합니다.

      5

      Layer2 토폴로지 유형의 경우 다음은 서브넷 필드에 대한 구성 세부 정보를 지정합니다.

      • 서브넷 필드는 선택 사항입니다.
      • 서브넷 필드는 문자열 유형이며 IPv4와 IPv6 모두에 대한 표준 CIDR 형식을 허용합니다.
      • 서브넷 필드에는 1개 또는 2개의 항목이 허용됩니다. 두 품목은 서로 다른 계열에 속해야 합니다. 예를 들어, 서브넷 값은 10.100.0.0/16 및 2001:db8::/64입니다 .
      • Layer2 서브넷은 생략될 수 있습니다. 생략하면 사용자는 포드에 대한 IP 주소를 구성해야 합니다. 결과적으로 포트 보안은 MAC 스푸핑만 방지합니다.
      • ipamLifecycle 필드가 지정된 경우 Layer2 서브넷 필드는 필수입니다.

   2. 다음 예와 같이 Layer3 토폴로지에 대한 요청을 정의하려면 my-layer-three-udn.yaml 과 같은 YAML 파일을 만듭니다.

      apiVersion: k8s.ovn.org/v1
      kind: UserDefinedNetwork
      metadata:
        name: udn-2-primary 

      1

      
        namespace: <some_custom_namespace>
      spec:
        topology: Layer3 

      2

      
        layer3: 

      3

      
          role: Primary 

      4

      
          subnets: 

      5

      
            - cidr: 10.150.0.0/16
              hostSubnet: 24
            - cidr: 2001:db8::/60
              hostSubnet: 64
      # ...

      Copy to Clipboard Toggle word wrap

      1

      UserDefinedNetwork 리소스의 이름입니다. 이는 기본값이어서 는 안 되며 클러스터 네트워크 운영자(CNO)가 생성한 글로벌 네임스페이스와 중복되어서는 안 됩니다.

      2

      토폴로지 필드는 네트워크 구성을 설명합니다. 허용되는 값은 Layer2 와 Layer3 입니다. Layer3 토폴로지 유형을 지정하면 노드당 다른 서브넷을 갖는 Layer 2 세그먼트가 생성됩니다. 3계층 라우팅은 노드 서브넷을 상호 연결하는 데 사용됩니다.

      3

      이 필드는 토폴로지 구성을 지정합니다. 유효한 값은 layer2 또는 layer3 입니다.

      4

      기본 또는 보조 역할을 지정합니다.

      5

      Layer3 토폴로지 유형의 경우 다음은 서브넷 필드에 대한 구성 세부 정보를 지정합니다.

      • 서브넷 필드는 필수입니다.

      • 서브넷 필드의 유형은 cidr 및 hostSubnet 입니다.

        • cidr은 클러스터의 clusterNetwork 구성 설정과 동일합니다. CIDR의 IP 주소는 사용자 정의 네트워크의 포드에 배포됩니다. 이 매개변수는 문자열 값을 허용합니다.
        • hostSubnet은 노드별 서브넷 접두사를 정의합니다.
        • IPv6의 경우 hostSubnet 에 대해 /64 길이만 지원됩니다.

3. 다음 명령을 실행하여 요청을 적용하세요.

   $ oc apply -f <my_layer_two_udn>.yaml

   Copy to Clipboard Toggle word wrap

   여기서 <my_layer_two_udn>.yaml은 Layer2 또는 Layer3 구성 파일의 이름입니다.

4. 다음 명령을 실행하여 요청이 성공했는지 확인하세요.

   $ oc get userdefinednetworks udn-1 -n <some_custom_namespace> -o yaml

   Copy to Clipboard Toggle word wrap

   여기서 some_custom_namespace 는 사용자 정의 네트워크에 대해 생성한 네임스페이스입니다.

   출력 예

   apiVersion: k8s.ovn.org/v1
   kind: UserDefinedNetwork
   metadata:
     creationTimestamp: "2024-08-28T17:18:47Z"
     finalizers:
     - k8s.ovn.org/user-defined-network-protection
     generation: 1
     name: udn-1
     namespace: some-custom-namespace
     resourceVersion: "53313"
     uid: f483626d-6846-48a1-b88e-6bbeb8bcde8c
   spec:
     layer2:
       role: Primary
       subnets:
       - 10.0.0.0/24
       - 2001:db8::/60
     topology: Layer2
   status:
     conditions:
     - lastTransitionTime: "2024-08-28T17:18:47Z"
       message: NetworkAttachmentDefinition has been created
       reason: NetworkAttachmentDefinitionReady
       status: "True"
       type: NetworkCreated

   Copy to Clipboard Toggle word wrap

프로세스

1. 관리자 관점에서 네트워킹 사용자 정의 네트워크를 클릭합니다.
2. 사용자 정의 네트워크 만들기를 클릭합니다.
3. 프로젝트 이름 목록에서 이전에 만든 네임스페이스를 선택합니다.
4. 서브넷 필드에 값을 지정합니다.
5. 생성을 클릭합니다. 사용자 정의 네트워크는 이 네임스페이스에서 생성하는 포드의 기본 기본 네트워크 역할을 합니다.