複数ネットワーク

手順

1. オプション: プライマリーネットワークを使用する ClusterUserDefinedNetwork CR の場合は、次のコマンドを入力して、k8s.ovn.org/primary-user-defined-network ラベルを持つ namespace を作成します。

   $ 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 が適用される namespace のセットに対するラベルクエリー。標準の Kubernetes MatchLabel セレクターを使用します。デフォルト または openshift-* namespace は指定しないでください。

      3

      matchLabels セレクタータイプを使用します。このセレクタータイプでは、用語が AND 関係で評価されます。

      4 5

      matchLabels セレクタータイプが使用されているため、<label_1_key>=<label_1_value> ラベルと <label_2_key>=<label_2_value> ラベルの両方を含む namespace がプロビジョニングされます。

      6

      ネットワーク設定を記述します。

      7

      topology フィールドはネットワーク設定を記述します。受け入れられる値は Layer2 と Layer3 です。Layer2 トポロジータイプを指定すると、すべてのノードで共有される 1 つの論理スイッチが作成されます。

      8

      このフィールドは、トポロジー設定を指定します。layer2 または layer3 に指定できます。

      9

      Primary または Secondary を指定します。4.18 でサポートされる role 仕様は Primary のみです。

      10

      Layer2 トポロジータイプの場合、以下は subnet フィールドの設定を指定します。

      • subnets フィールドは任意です。
      • subnets フィールドはタイプが string で、IPv4 と IPv6 の両方の標準 CIDR 形式を受け入れます。
      • subnets フィールドには 1 つまたは 2 つの項目を入力できます。2 つのアイテムは、異なるファミリーに属している必要があります。たとえば、subnets の値は 10.100.0.0/16 と 2001:db8::/64 です。
      • Layer2 サブネットは省略できます。省略した場合、ユーザーは Pod の静的 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 が適用される namespace セットに対するラベルクエリー。標準の Kubernetes MatchLabel セレクターを使用します。デフォルト または openshift-* namespace は指定しないでください。

      3

      matchExpressions セレクタータイプを使用します。このセレクタータイプでは、用語が OR 関係で評価されます。

      4

      照合するラベルキーを指定します。

      5

      Operator を指定します。有効な値には、In、NotIn、Exists、DoesNotExist などがあります。

      6

      matchExpressions タイプが使用されているため、<example_namespace_one> または <example_namespace_two> のいずれかに一致する namespace がプロビジョニングされます。

      7

      ネットワーク設定を記述します。

      8

      topology フィールドはネットワーク設定を記述します。受け入れられる値は Layer2 と Layer3 です。Layer3 トポロジータイプを指定すると、ノードごとにレイヤー 2 セグメントが作成され、それぞれに異なるサブネットが割り当てられます。レイヤー 3 ルーティングは、ノードサブネットを相互接続するために使用されます。

      9

      このフィールドは、トポロジー設定を指定します。有効な値は layer2 または layer3 です。

      10

      Primary ロールまたは Secondary ロールを指定します。4.18 でサポートされる role 仕様は Primary のみです。

      11

      Layer3 トポロジータイプの場合、subnet フィールドの設定の詳細を次に示します。

      • subnets フィールドは必須です。

      • subnets フィールドのタイプは、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. Administrator パースペクティブから、Networking → UserDefinedNetworks をクリックします。
2. ClusterUserDefinedNetwork をクリックします。
3. Name フィールドで、クラスタースコープの UDN の名前を指定します。
4. Subnet フィールドに値を指定します。
5. Project(s) Match Labels フィールドに適切なラベルを追加して、クラスター UDN が適用される namespace を選択します。
6. Create をクリックします。クラスタースコープの UDN は、ステップ 5 で指定したラベルを含む namespace に配置された Pod のデフォルトプライマリーネットワークとして機能します。

手順

1. オプション: プライマリーネットワークを使用する UserDefinedNetwork CR の場合は、次のコマンドを入力して、k8s.ovn.org/primary-user-defined-network ラベルを持つ namespace を作成します。

   $ 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 リソースの名前。これは default にすべきではありません。また、Cluster Network Operator (CNO) によって作成されたグローバル namespace と重複してはなりません。

      2

      topology フィールドはネットワーク設定を記述します。受け入れられる値は Layer2 と Layer3 です。Layer2 トポロジータイプを指定すると、すべてのノードで共有される 1 つの論理スイッチが作成されます。

      3

      このフィールドは、トポロジー設定を指定します。layer2 または layer3 に指定できます。

      4

      Primary ロールまたは Secondary ロールを指定します。

      5

      Layer2 トポロジータイプの場合、以下は subnet フィールドの設定を指定します。

      • subnets フィールドは任意です。
      • subnets フィールドはタイプが string で、IPv4 と IPv6 の両方の標準 CIDR 形式を受け入れます。
      • subnets フィールドには 1 つまたは 2 つの項目を入力できます。2 つのアイテムは、異なるファミリーに属している必要があります。たとえば、subnets の値は 10.100.0.0/16 と 2001:db8::/64 です。
      • Layer2 サブネットは省略できます。省略すると、ユーザーは Pod の IP アドレスを設定する必要があります。結果として、ポートセキュリティーは MAC スプーフィングのみを防止します。
      • ipamLifecycle フィールドが指定されている場合、Layer2subnets フィールドは必須です。

   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 リソースの名前。これは default にすべきではありません。また、Cluster Network Operator (CNO) によって作成されたグローバル namespace と重複してはなりません。

      2

      topology フィールドはネットワーク設定を記述します。受け入れられる値は Layer2 と Layer3 です。Layer3 トポロジータイプを指定すると、ノードごとにレイヤー 2 セグメントが作成され、それぞれに異なるサブネットが割り当てられます。レイヤー 3 ルーティングは、ノードサブネットを相互接続するために使用されます。

      3

      このフィールドは、トポロジー設定を指定します。有効な値は layer2 または layer3 です。

      4

      Primary ロールまたは Secondary ロールを指定します。

      5

      Layer3 トポロジータイプの場合、subnet フィールドの設定の詳細を次に示します。

      • subnets フィールドは必須です。

      • subnets フィールドのタイプは、cidr および hostSubnet です。

        • cidr は、クラスターの clusterNetwork 設定に相当します。CIDR 内の IP アドレスは、ユーザー定義ネットワーク内の Pod に配布されます。このパラメーターは文字列値を受け入れます。
        • 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 は、ユーザー定義ネットワーク用に作成した 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. Administrator パースペクティブから、Networking → UserDefinedNetworks をクリックします。
2. Create UserDefinedNetwork をクリックします。
3. Project name リストから、以前に作成した namespace を選択します。
4. Subnet フィールドに値を指定します。
5. Create をクリックします。ユーザー定義ネットワークは、この namespace で作成する Pod のデフォルトのプライマリーネットワークとして機能します。

手順

1. 次の詳細を含む、setsebool-container-use-devices.yaml などの名前の新しい YAML ファイルを作成します。

   apiVersion: machineconfiguration.openshift.io/v1
   kind: MachineConfig
   metadata:
     labels:
       machineconfiguration.openshift.io/role: worker
     name: 99-worker-setsebool
   spec:
     config:
       ignition:
         version: 3.2.0
       systemd:
         units:
         - enabled: true
           name: setsebool.service
           contents: |
             [Unit]
             Description=Set SELinux boolean for the TAP CNI plugin
             Before=kubelet.service
   
             [Service]
             Type=oneshot
             ExecStart=/usr/sbin/setsebool container_use_devices=on
             RemainAfterExit=true
   
             [Install]
             WantedBy=multi-user.target graphical.target

   Copy to Clipboard Toggle word wrap

2. 次のコマンドを実行して、新しい MachineConfig オブジェクトを作成します。

   $ oc apply -f setsebool-container-use-devices.yaml

   Copy to Clipboard Toggle word wrap
   注記

   MachineConfig オブジェクトに変更を適用すると、変更が適用された後、影響を受けるすべてのノードが正常に再起動します。この更新が適用されるまでに、時間がかかる場合があります。

3. 次のコマンドを実行して、変更が適用されていることを確認します。

   $ oc get machineconfigpools

   Copy to Clipboard Toggle word wrap

   予想される出力

   NAME        CONFIG                                                UPDATED   UPDATING   DEGRADED   MACHINECOUNT   READYMACHINECOUNT   UPDATEDMACHINECOUNT   DEGRADEDMACHINECOUNT   AGE
   master      rendered-master-e5e0c8e8be9194e7c5a882e047379cfa      True      False      False      3              3                   3                     0                      7d2h
   worker      rendered-worker-d6c9ca107fba6cd76cdcbfcedcafa0f2      True      False      False      3              3                   3                     0                      7d

   Copy to Clipboard Toggle word wrap

   注記

   すべてのノードが更新され、準備完了状態になっている必要があります。

1. Pod リソース定義を編集します。既存の Pod リソースを編集する場合は、以下のコマンドを実行してデフォルトエディターでその定義を編集します。<name> を、編集する Pod リソースの名前に置き換えます。

   $ oc edit pod <name>

   Copy to Clipboard Toggle word wrap

2. Pod リソース定義で、k8s.v1.cni.cncf.io/networks パラメーターを Pod の metadata マッピングに追加します。k8s.v1.cni.cncf.io/networks は、追加のプロパティーを指定するだけでなく、NetworkAttachmentDefinition カスタムリソース (CR) 名を参照するオブジェクトリストの JSON 文字列を受け入れます。

   metadata:
     annotations:
       k8s.v1.cni.cncf.io/networks: '[<network>[,<network>,...]]' 

   1

   Copy to Clipboard Toggle word wrap

   1

   <network> を、以下の例にあるように JSON オブジェクトに置き換えます。一重引用符が必要です。

3. 以下の例では、アノテーションで default-route パラメーターを使用して、デフォルトルートを持つネットワーク割り当てを指定します。

   apiVersion: v1
   kind: Pod
   metadata:
     name: example-pod
     annotations:
       k8s.v1.cni.cncf.io/networks: '[
       {
         "name": "net1"
       },
       {
         "name": "net2", 

   1

   
         "default-route": ["192.0.2.1"] 

   2

   
       }]'
   spec:
     containers:
     - name: example-pod
       command: ["/bin/bash", "-c", "sleep 2000000000000"]
       image: centos/tools

   Copy to Clipboard Toggle word wrap

   1

   name キーは、Pod に関連付けるセカンダリーネットワークの名前です。

   2

   default-route キーは、ルーティングテーブルに他のルーティングテーブルがない場合に、ルーティングされるトラフィックに使用されるゲートウェイ値を指定します。複数の default-route キーを指定すると、Pod がアクティブでなくなります。

1. 以下のコマンドを実行して CNO CR を編集します。

   $ oc edit networks.operator.openshift.io cluster

   Copy to Clipboard Toggle word wrap