12.2. ノードのネットワーク設定の更新

12.2.1. nmstate について
リンクのコピー

OpenShift Virtualization は nmstate を使用してノードネットワークの状態を報告し、設定します。これにより、単一の設定マニフェストをクラスターに適用して、すべてのノードに Linux ブリッジを作成するなどして、ネットワークポリシーの設定を変更することができます。

ノードのネットワークは、以下のオブジェクトによって監視され更新されます。

NodeNetworkState: そのノード上のネットワークの状態を報告します。
NodeNetworkConfigurationPolicy: ノードで要求されるネットワーク設定について説明します。NodeNetworkConfigurationPolicy マニフェストをクラスターに適用して、インターフェイスの追加および削除など、ノードネットワーク設定を更新します。
NodeNetworkConfigurationEnactment: 各ノードに制定されたネットワークポリシーを報告します。

OpenShift Virtualization は以下の nmstate インターフェイスタイプの使用をサポートします。

Linux Bridge
VLAN
Bond
イーサネット

注記

OpenShift Container Platform クラスターが OVN-Kubernetes をデフォルトの Container Network Interface (CNI) プロバイダーとして使用する場合、OVN-Kubernetes のホストネットワークトポロジーの変更により、Linux ブリッジまたはボンディングをホストのデフォルトインターフェイスに割り当てることはできません。回避策として、ホストに接続されたセカンダリーネットワークインターフェイスを使用するか、OpenShift SDN デフォルト CNI プロバイダーに切り替えることができます。

12.2.2. ノード上でのインターフェイスの作成
リンクのコピー

NodeNetworkConfigurationPolicy マニフェストをクラスターに適用してクラスター内のノード上にインターフェイスを作成します。マニフェストには、インターフェイスの要求された設定の詳細が含まれます。

デフォルトでは、マニフェストはクラスター内のすべてのノードに適用されます。インターフェイスを特定ノードに追加するには、ノードセレクターの spec: nodeSelector パラメーターおよび適切な <key>:<value> を追加します。

手順

NodeNetworkConfigurationPolicy マニフェストを作成します。以下の例は、すべてのワーカーノードで Linux ブリッジを設定します。

apiVersion: nmstate.io/v1beta1
kind: NodeNetworkConfigurationPolicy
metadata:
  name: <br1-eth1-policy>

1


spec:
  nodeSelector:

2


    node-role.kubernetes.io/worker: ""

3


  desiredState:
    interfaces:
      - name: br1
        description: Linux bridge with eth1 as a port

4


        type: linux-bridge
        state: up
        ipv4:
          dhcp: true
          enabled: true
        bridge:
          options:
            stp:
              enabled: false
          port:
            - name: eth1

1: ポリシーの名前。
2: オプション: nodeSelector パラメーターを含めない場合、ポリシーはクラスター内のすべてのノードに適用されます。
3: この例では node-role.kubernetes.io/worker: "" ノードセレクターを使用し、クラスター内のすべてのワーカーノードを選択します。
4: オプション: インターフェイスの人間が判読できる説明。

ノードのネットワークポリシーを作成します。
```
$ oc apply -f <br1-eth1-policy.yaml> 
```
1
1
ノードネットワーク設定ポリシーマニフェストのファイル名。

12.2.3. ノード上でのノードネットワークポリシー更新の確認
リンクのコピー

NodeNetworkConfigurationPolicy マニフェストは、クラスターのノードについて要求されるネットワーク設定を記述します。ノードネットワークポリシーには、要求されたネットワーク設定と、クラスター全体でのポリシーの実行ステータスが含まれます。

ノードネットワークポリシーを適用する際に、NodeNetworkConfigurationEnactment オブジェクトがクラスター内のすべてのノードについて作成されます。ノードネットワーク設定の enactment (実行) は、そのノードでのポリシーの実行ステータスを表す読み取り専用オブジェクトです。ポリシーがノードに適用されない場合、そのノードの enactment (実行) にはトラブルシューティングのためのトレースバックが含まれます。

手順

ポリシーがクラスターに適用されていることを確認するには、ポリシーとそのステータスを一覧表示します。
```
$ oc get nncp
```
オプション: ポリシーの設定に想定されている以上の時間がかかる場合は、特定のポリシーの要求される状態とステータスの状態を検査できます。
```
$ oc get nncp <policy> -o yaml
```
オプション: ポリシーのすべてのノード上での設定に想定されている以上の時間がかかる場合は、クラスターの enactment (実行) のステータスを一覧表示できます。
```
$ oc get nnce
```
オプション: 特定の enactment (実行) の設定 (失敗した設定のエラーレポートを含む) を表示するには、以下を実行します。
```
$ oc get nnce <node>.<policy> -o yaml
```

12.2.4. ノードからインターフェイスの削除
リンクのコピー

NodeNetworkConfigurationPolicy オブジェクトを編集し、インターフェイスの state を absent に設定して、クラスターの 1 つ以上のノードからインターフェイスを削除できます。

ノードからインターフェイスを削除しても、ノードのネットワーク設定は以前の状態に自動的に復元されません。以前の状態に復元する場合、そのノードのネットワーク設定をポリシーで定義する必要があります。

ブリッジまたはボンディングインターフェイスを削除すると、そのブリッジまたはボンディングインターフェイスに以前に接続されたか、またはそれらの下位にあるノード NIC は down の状態になり、到達できなくなります。接続が失われないようにするには、同じポリシーでノード NIC を設定し、ステータスを up にし、DHCP または静的 IP アドレスのいずれかになるようにします。

注記

インターフェイスを追加したポリシーを削除しても、ノード上のポリシーの設定は変更されません。NodeNetworkConfigurationPolicy はクラスターのオブジェクトですが、これは要求される設定のみを表します。
同様に、インターフェイスを削除してもポリシーは削除されません。

手順

インターフェイスの作成に使用する NodeNetworkConfigurationPolicy マニフェストを更新します。以下の例は Linux ブリッジを削除し、接続が失われないように DHCP で eth1 NIC を設定します。
```
apiVersion: nmstate.io/v1beta1
kind: NodeNetworkConfigurationPolicy
metadata:
  name: <br1-eth1-policy> 
```
1
```
spec:
  nodeSelector: 
```
2
```
    node-role.kubernetes.io/worker: "" 
```
3
```
  desiredState:
    interfaces:
    - name: br1
      type: linux-bridge
      state: absent 
```
4
```
    - name: eth1 
```
5
```
      type: ethernet 
```
6
```
      state: up 
```
7
```
      ipv4:
        dhcp: true 
```
8
```
        enabled: true 
```
9
1
ポリシーの名前。
2
オプション: nodeSelector パラメーターを含めない場合、ポリシーはクラスター内のすべてのノードに適用されます。
3
この例では node-role.kubernetes.io/worker: "" ノードセレクターを使用し、クラスター内のすべてのワーカーノードを選択します。
4
状態を absent に変更すると、インターフェイスが削除されます。
5
ブリッジインターフェイスから接続が解除されるインターフェイスの名前。
6
インターフェイスのタイプ。この例では、イーサネットネットワークインターフェイスを作成します。
7
インターフェイスの要求された状態。
8
オプション: dhcp を使用しない場合は、静的 IP を設定するか、IP アドレスなしでインターフェイスを出ることができます。
9
この例では ipv4 を有効にします。
ノード上でポリシーを更新し、インターフェイスを削除します。
```
$ oc apply -f <br1-eth1-policy.yaml> 
```
1
1
ポリシーマニフェストのファイル名。

12.2.5. 異なるインターフェイスのポリシー設定の例
リンクのコピー

12.2.5.1. 例: Linux ブリッジインターフェイスノードネットワーク設定ポリシー
リンクのコピー

NodeNetworkConfigurationPolicy マニフェストをクラスターに適用してクラスター内のノード上に Linux ブリッジインターフェイスを作成します。

以下の YAML ファイルは、Linux ブリッジインターフェイスのマニフェストの例です。これには、独自の情報で置き換える必要のあるサンプルの値が含まれます。

apiVersion: nmstate.io/v1beta1
kind: NodeNetworkConfigurationPolicy
metadata:
  name: br1-eth1-policy

1


spec:
  nodeSelector:

2


    kubernetes.io/hostname: <node01>

3


  desiredState:
    interfaces:
      - name: br1

4


        description: Linux bridge with eth1 as a port

5


        type: linux-bridge

6


        state: up

7


        ipv4:
          dhcp: true

8


          enabled: true

9


        bridge:
          options:
            stp:
              enabled: false

10


          port:
            - name: eth1

11

1: ポリシーの名前。
2: オプション: nodeSelector パラメーターを含めない場合、ポリシーはクラスター内のすべてのノードに適用されます。
3: この例では、hostname ノードセレクターを使用します。
4: インターフェイスの名前。
5: オプション: 人間が判読できるインターフェイスの説明。
6: インターフェイスのタイプ。この例では、ブリッジを作成します。
7: 作成後のインターフェイスの要求された状態。
8: オプション: dhcp を使用しない場合は、静的 IP を設定するか、IP アドレスなしでインターフェイスを出ることができます。
9: この例では ipv4 を有効にします。
10: この例では stp を無効にします。
11: ブリッジが接続されるノードの NIC。

12.2.5.2. 例: VLAN インターフェイスノードネットワークの設定ポリシー
リンクのコピー

NodeNetworkConfigurationPolicy マニフェストをクラスターに適用してクラスター内のノード上に VLAN インターフェイスを作成します。

以下の YAML ファイルは、VLAN インターフェイスのマニフェストの例です。これには、独自の情報で置き換える必要のあるサンプルの値が含まれます。

apiVersion: nmstate.io/v1beta1
kind: NodeNetworkConfigurationPolicy
metadata:
  name: vlan-eth1-policy

1


spec:
  nodeSelector:

2


    kubernetes.io/hostname: <node01>

3


  desiredState:
    interfaces:
    - name: eth1.102

4


      description: VLAN using eth1

5


      type: vlan

6


      state: up

7


      vlan:
        base-iface: eth1

8


        id: 102

9

1: ポリシーの名前。
2: オプション: nodeSelector パラメーターを含めない場合、ポリシーはクラスター内のすべてのノードに適用されます。
3: この例では、hostname ノードセレクターを使用します。
4: インターフェイスの名前。
5: オプション: 人間が判読できるインターフェイスの説明。
6: インターフェイスのタイプ。以下の例では VLAN を作成します。
7: 作成後のインターフェイスの要求された状態。
8: VLAN が接続されているノードの NIC。
9: VLAN タグ。

12.2.5.3. 例: ボンドインターフェイスノードネットワークの設定ポリシー
リンクのコピー

NodeNetworkConfigurationPolicy マニフェストをクラスターに適用してノード上にボンドインターフェイスを作成します。

注記

OpenShift Virtualization は以下のボンドモードのみをサポートします。

mode=1 active-backup
mode=2 balance-xor
mode=4 802.3ad
mode=5 balance-tlb
mode=6 balance-alb

以下の YAML ファイルは、ボンドインターフェイスのマニフェストの例です。これには、独自の情報で置き換える必要のあるサンプルの値が含まれます。

apiVersion: nmstate.io/v1beta1
kind: NodeNetworkConfigurationPolicy
metadata:
  name: bond0-eth1-eth2-policy

1


spec:
  nodeSelector:

2


    kubernetes.io/hostname: <node01>

3


  desiredState:
    interfaces:
    - name: bond0

4


      description: Bond with ports eth1 and eth2

5


      type: bond

6


      state: up

7


      ipv4:
        dhcp: true

8


        enabled: true

9


      link-aggregation:
        mode: active-backup

10


        options:
          miimon: '140'

11


        port:

12


        - eth1
        - eth2
      mtu: 1450

13

1: ポリシーの名前。
2: オプション: nodeSelector パラメーターを含めない場合、ポリシーはクラスター内のすべてのノードに適用されます。
3: この例では、hostname ノードセレクターを使用します。
4: インターフェイスの名前。
5: オプション: 人間が判読できるインターフェイスの説明。
6: インターフェイスのタイプ。この例では、ボンドを作成します。
7: 作成後のインターフェイスの要求された状態。
8: オプション: dhcp を使用しない場合は、静的 IP を設定するか、IP アドレスなしでインターフェイスを出ることができます。
9: この例では ipv4 を有効にします。
10: ボンドのドライバーモード。この例では、アクティブなバックアップモードを使用します。
11: オプション: この例では、miimon を使用して 140ms ごとにボンドリンクを検査します。
12: ボンド内の下位ノードの NIC。
13: オプション: ボンドの Maximum transmission unit (MTU)指定がない場合、この値はデフォルトで 1500 に設定されます。

12.2.5.4. 例: イーサネットインターフェイスノードネットワークの設定ポリシー
リンクのコピー

NodeNetworkConfigurationPolicy マニフェストをクラスターに適用してクラスター内のノードにイーサネットインターフェイスを作成します。

以下の YAML ファイルは、イーサネットインターフェイスのマニフェストの例です。これには、独自の情報で置き換える必要のあるサンプルの値が含まれます。

apiVersion: nmstate.io/v1beta1
kind: NodeNetworkConfigurationPolicy
metadata:
  name: eth1-policy

1


spec:
  nodeSelector:

2


    kubernetes.io/hostname: <node01>

3


  desiredState:
    interfaces:
    - name: eth1

4


      description: Configuring eth1 on node01

5


      type: ethernet

6


      state: up

7


      ipv4:
        dhcp: true

8


        enabled: true

9

1: ポリシーの名前。
2: オプション: nodeSelector パラメーターを含めない場合、ポリシーはクラスター内のすべてのノードに適用されます。
3: この例では、hostname ノードセレクターを使用します。
4: インターフェイスの名前。
5: オプション: 人間が判読できるインターフェイスの説明。
6: インターフェイスのタイプ。この例では、イーサネットネットワークインターフェイスを作成します。
7: 作成後のインターフェイスの要求された状態。
8: オプション: dhcp を使用しない場合は、静的 IP を設定するか、IP アドレスなしでインターフェイスを出ることができます。
9: この例では ipv4 を有効にします。

12.2.5.5. 例: 同じノードネットワーク設定ポリシーでの複数のインターフェイス
リンクのコピー

同じノードネットワーク設定ポリシーで複数のインターフェイスを作成できます。これらのインターフェイスは相互に参照でき、単一のポリシーマニフェストを使用してネットワーク設定をビルドし、デプロイできます。

以下のスニペット例では、2 つの NIC 間に bond10 という名前のボンドと、ボンドに接続する br1 という名前の Linux ブリッジを作成します。

#...
    interfaces:
    - name: bond10
      description: Bonding eth2 and eth3 for Linux bridge
      type: bond
      state: up
      link-aggregation:
        port:
        - eth2
        - eth3
    - name: br1
      description: Linux bridge on bond
      type: linux-bridge
      state: up
      bridge:
        port:
        - name: bond10
#...

12.2.6. 例: IP 管理
リンクのコピー

以下の設定スニペットの例は、さまざまな IP 管理方法を示しています。

これらの例では、ethernet インターフェイスタイプを使用して、ポリシー設定に関連するコンテキストを表示しつつ、サンプルを単純化します。これらの IP 管理のサンプルは、他のインターフェイスタイプでも使用できます。

12.2.6.1. 静的
リンクのコピー

以下のスニペットは、イーサネットインターフェイスで IP アドレスを静的に設定します。

...
    interfaces:
    - name: eth1
      description: static IP on eth1
      type: ethernet
      state: up
      ipv4:
        dhcp: false
        address:
        - ip: 192.168.122.250

1


          prefix-length: 24
        enabled: true
...

1: この値を、インターフェイスの静的 IP アドレスに置き換えます。

12.2.6.2. IP アドレスなし
リンクのコピー

以下のスニペットでは、インターフェイスに IP アドレスがないことを確認できます。

...
    interfaces:
    - name: eth1
      description: No IP on eth1
      type: ethernet
      state: up
      ipv4:
        enabled: false
...

12.2.6.3. 動的ホストの設定
リンクのコピー

以下のスニペットは、動的 IP アドレス、ゲートウェイアドレス、および DNS を使用するイーサネットインターフェイスを設定します。

...
    interfaces:
    - name: eth1
      description: DHCP on eth1
      type: ethernet
      state: up
      ipv4:
        dhcp: true
        enabled: true
...

以下のスニペットは、動的 IP アドレスを使用しますが、動的ゲートウェイアドレスまたは DNS を使用しないイーサネットインターフェイスを設定します。

...
    interfaces:
    - name: eth1
      description: DHCP without gateway or DNS on eth1
      type: ethernet
      state: up
      ipv4:
        dhcp: true
        auto-gateway: false
        auto-dns: false
        enabled: true
...

12.2.6.4. DNS
リンクのコピー

以下のスニペットは、ホストに DNS 設定を設定します。

...
    interfaces:
       ...
    dns-resolver:
      config:
        search:
        - example.com
        - example.org
        server:
        - 8.8.8.8
...

12.2.6.5. 静的ルーティング
リンクのコピー

以下のスニペットは、インターフェイス eth1 に静的ルートおよび静的 IP を設定します。

...
    interfaces:
    - name: eth1
      description: Static routing on eth1
      type: ethernet
      state: up
      ipv4:
        dhcp: false
        address:
        - ip: 192.0.2.251

1


          prefix-length: 24
        enabled: true
    routes:
      config:
      - destination: 198.51.100.0/24
        metric: 150
        next-hop-address: 192.0.2.1

2


        next-hop-interface: eth1
        table-id: 254
...

1: イーサネットインターフェイスの静的 IP アドレス。
2: ノードトラフィックのネクストホップアドレス。これは、イーサネットインターフェイスに設定される IP アドレスと同じサブネットにある必要があります。

12.2.1. nmstate について
リンクのコピー

12.2.2. ノード上でのインターフェイスの作成
リンクのコピー

関連情報

12.2.3. ノード上でのノードネットワークポリシー更新の確認
リンクのコピー

12.2.4. ノードからインターフェイスの削除
リンクのコピー

12.2.5. 異なるインターフェイスのポリシー設定の例
リンクのコピー

12.2.5.1. 例: Linux ブリッジインターフェイスノードネットワーク設定ポリシー
リンクのコピー

12.2.5.2. 例: VLAN インターフェイスノードネットワークの設定ポリシー
リンクのコピー

12.2.5.3. 例: ボンドインターフェイスノードネットワークの設定ポリシー
リンクのコピー

12.2.5.4. 例: イーサネットインターフェイスノードネットワークの設定ポリシー
リンクのコピー

12.2.5.5. 例: 同じノードネットワーク設定ポリシーでの複数のインターフェイス
リンクのコピー

12.2.6. 例: IP 管理
リンクのコピー

12.2.6.1. 静的
リンクのコピー

12.2.6.2. IP アドレスなし
リンクのコピー

12.2.6.3. 動的ホストの設定
リンクのコピー

12.2.6.4. DNS
リンクのコピー

12.2.6.5. 静的ルーティング
リンクのコピー

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

12.2. ノードのネットワーク設定の更新

12.2.1. nmstate についてリンクのコピーリンクがクリップボードにコピーされました!

12.2.2. ノード上でのインターフェイスの作成リンクのコピーリンクがクリップボードにコピーされました!

関連情報

12.2.3. ノード上でのノードネットワークポリシー更新の確認リンクのコピーリンクがクリップボードにコピーされました!

12.2.4. ノードからインターフェイスの削除リンクのコピーリンクがクリップボードにコピーされました!

12.2.5. 異なるインターフェイスのポリシー設定の例リンクのコピーリンクがクリップボードにコピーされました!

12.2.5.1. 例: Linux ブリッジインターフェイスノードネットワーク設定ポリシーリンクのコピーリンクがクリップボードにコピーされました!

12.2.5.2. 例: VLAN インターフェイスノードネットワークの設定ポリシーリンクのコピーリンクがクリップボードにコピーされました!

12.2.5.3. 例: ボンドインターフェイスノードネットワークの設定ポリシーリンクのコピーリンクがクリップボードにコピーされました!

12.2.5.4. 例: イーサネットインターフェイスノードネットワークの設定ポリシーリンクのコピーリンクがクリップボードにコピーされました!

12.2.5.5. 例: 同じノードネットワーク設定ポリシーでの複数のインターフェイスリンクのコピーリンクがクリップボードにコピーされました!

12.2.6. 例: IP 管理リンクのコピーリンクがクリップボードにコピーされました!

12.2.6.1. 静的リンクのコピーリンクがクリップボードにコピーされました!

12.2.6.2. IP アドレスなしリンクのコピーリンクがクリップボードにコピーされました!

12.2.6.3. 動的ホストの設定リンクのコピーリンクがクリップボードにコピーされました!

12.2.6.4. DNSリンクのコピーリンクがクリップボードにコピーされました!

12.2.6.5. 静的ルーティングリンクのコピーリンクがクリップボードにコピーされました!

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

多様性を受け入れるオープンソースの強化

会社概要

Theme

Red Hat legal and privacy links

Red Hat legal and privacy links

12.2.1. nmstate について
リンクのコピー

12.2.2. ノード上でのインターフェイスの作成
リンクのコピー

12.2.3. ノード上でのノードネットワークポリシー更新の確認
リンクのコピー

12.2.4. ノードからインターフェイスの削除
リンクのコピー

12.2.5. 異なるインターフェイスのポリシー設定の例
リンクのコピー

12.2.5.1. 例: Linux ブリッジインターフェイスノードネットワーク設定ポリシー
リンクのコピー

12.2.5.2. 例: VLAN インターフェイスノードネットワークの設定ポリシー
リンクのコピー

12.2.5.3. 例: ボンドインターフェイスノードネットワークの設定ポリシー
リンクのコピー

12.2.5.4. 例: イーサネットインターフェイスノードネットワークの設定ポリシー
リンクのコピー

12.2.5.5. 例: 同じノードネットワーク設定ポリシーでの複数のインターフェイス
リンクのコピー

12.2.6. 例: IP 管理
リンクのコピー

12.2.6.1. 静的
リンクのコピー

12.2.6.2. IP アドレスなし
リンクのコピー

12.2.6.3. 動的ホストの設定
リンクのコピー

12.2.6.4. DNS
リンクのコピー

12.2.6.5. 静的ルーティング
リンクのコピー