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. cluster-layer-two-udn.yaml 과 같은 YAML 파일을 생성하여 다음 예와 같이 Layer2 토폴로지에 대한 요청을 정의합니다.

      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

      CUDN CR이 적용되는 네임스페이스 세트에 대한 라벨 쿼리입니다. 표준 Kubernetes MatchLabel 선택기를 사용합니다. default 또는 openshift-* 네임스페이스를 가리키지 않아야 합니다.

      3

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

      4 5

      이 예에서 CUDN CR은 <label_1_ key>=<label_1_value> 및 <label _2_key>=<label_2_value > 라벨이 모두 포함된 네임스페이스에 배포됩니다.

      6

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

      7

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

      8

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

      9

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

      10

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

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

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

      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

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

      4

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

      5

      Operator를 지정합니다. 유효한 값에는 in,NotIn,Exists 및 DoesNotExist 가 있습니다.

      6

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

      7

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

      8

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

      9

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

      10

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

      11

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

      • subnets 필드는 필수입니다.

      • subnets 필드의 유형은 cidr 및 hostSubnet:입니다.

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

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. cluster-udn-localnet.yaml 과 같은 YAML 파일을 생성하여 다음 예와 같이 Localnet 토폴로지에 대한 요청을 정의합니다.

      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 선택기를 사용합니다. 기본,openshift-* 또는 기타 시스템 네임스페이스를 가리키지 않아야 합니다.

      3

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

      4 5

      이 예에서 CUDN CR은 <label_1_ key>=<label_1_value> 및 <label _2_key>=<label_2_value > 라벨이 모두 포함된 네임스페이스에 배포됩니다.

      6

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

      7

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

      8

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

      9

      네트워크 구성의 역할을 지정합니다. secondary 는 localnet 토폴로지에 지원되는 유일한 역할 사양입니다.

      10

      Localnet 토폴로지 유형의 경우 다음에서는 subnet 필드에 대한 구성 세부 정보를 지정합니다.

      • subnets 필드는 선택 사항입니다.
      • subnets 필드는 문자열 유형이며 IPv4 및 IPv6 모두에 대한 표준 CIDR 형식을 허용합니다.
      • subnets 필드에는 하나 또는 두 개의 항목을 사용할 수 있습니다. 두 항목의 경우 다른 IP 제품군이어야 합니다. 예를 들어 서브넷 값은 10.100.0.0/16 및 2001:db8::/64 입니다.
      • localnet 서브넷은 생략할 수 있습니다. 생략하면 사용자는 Pod의 고정 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. Subnet 필드에 값을 지정합니다.
5. Project(s) Match Labels 필드에서 적절한 레이블을 추가하여 클러스터 UDN이 적용되는 네임스페이스를 선택합니다.
6. 생성을 클릭합니다. 클러스터 범위 UDN은 5단계에서 지정한 라벨이 포함된 네임스페이스에 있는 Pod의 기본 기본 네트워크 역할을 합니다.

프로세스

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. my-layer-two-udn.yaml 과 같은 YAML 파일을 생성하여 다음 예와 같이 Layer2 토폴로지에 대한 요청을 정의합니다.

      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(Cluster Network Operator)에서 생성한 글로벌 네임스페이스를 복제해서는 안 됩니다.

      2

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

      3

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

      4

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

      5

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

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

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

      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(Cluster Network Operator)에서 생성한 글로벌 네임스페이스를 복제해서는 안 됩니다.

      2

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

      3

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

      4

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

      5

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

      • subnets 필드는 필수입니다.

      • subnets 필드의 유형은 cidr 및 hostSubnet:입니다.

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

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. Create UserDefinedNetwork 를 클릭합니다.
3. 프로젝트 이름 목록에서 이전에 생성한 네임스페이스를 선택합니다.
4. Subnet 필드에 값을 지정합니다.
5. 생성을 클릭합니다. 사용자 정의 네트워크는 이 네임스페이스에서 생성하는 Pod의 기본 기본 네트워크 역할을 합니다.