9.3. 仮想マシンをプライマリーユーザー定義ネットワークに接続する

手順

1. Administrator パースペクティブから、Administration Namespaces をクリックします。
2. Create Namespace をクリックします。
3. Name フィールドに、namespace の名前を指定します。名前は、小文字の英数字または '-' で構成される必要があり、先頭と末尾は英数字でなければなりません。
4. Labels フィールドに、k8s.ovn.org/primary-user-defined-network ラベルを追加します。
5. オプション: namespace を既存のクラスタースコープ UDN で使用する場合は、ClusterUserDefinedNetwork カスタムリソースの spec.namespaceSelector フィールドで定義されている適切なラベルを追加します。
6. オプション: デフォルトのネットワークポリシーを指定します。
7. namespace を作成するには、Create をクリックします。

手順

1. Administrator パースペクティブから、Networking UserDefinedNetworks をクリックします。
2. Create UserDefinedNetwork をクリックします。
3. Project name リストから、以前に作成した namespace を選択します。
4. Subnet フィールドに値を指定します。
5. Create をクリックします。ユーザー定義ネットワークは、この namespace で作成する Pod と仮想マシンのデフォルトのプライマリーネットワークとして機能します。

手順

1. Administrator パースペクティブから、Networking UserDefinedNetworks をクリックします。
2. Create リストから、ClusterUserDefinedNetwork を選択します。
3. Name フィールドで、クラスタースコープの UDN の名前を指定します。
4. Subnet フィールドに値を指定します。
5. Project(s) Match Labels フィールドに適切なラベルを追加して、クラスター UDN が適用される namespace を選択します。
6. Create をクリックします。クラスタースコープの UDN は、ステップ 5 で指定したラベルが含まれる namespace にある Pod および仮想マシンのデフォルトのプライマリーネットワークとして機能します。

手順

1. 次の例のような YAML ファイルとして Namespace オブジェクトを作成します。

   apiVersion: v1
   kind: Namespace
   metadata:
     name: my-namespace
     labels:
       k8s.ovn.org/primary-user-defined-network: "" 

   1

   
   # ...

   Copy to Clipboard Toggle word wrap

   1

   namespace を UDN に関連付けるには、このラベルが必要です。namespace を既存のクラスター UDN で使用する場合は、ClusterUserDefinedNetwork カスタムリソースの spec.namespaceSelector フィールドで定義されている適切なラベルも追加する必要があります。

2. 次のコマンドを実行して、Namespace マニフェストを適用します。

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap

手順

1. カスタムネットワーク設定を指定するには、UserDefinedNetwork オブジェクトを作成します。

   UserDefinedNetwork マニフェストの例

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

   1

   
     namespace: my-namespace 

   2

   
   spec:
     topology: Layer2 

   3

   
     layer2:
       role: Primary 

   4

   
       subnets:
         - "10.0.0.0/24"
         - "2001:db8::/60"
     ipam:
       lifecycle: Persistent 

   5

   Copy to Clipboard Toggle word wrap

   1

   UserDefinedNetwork カスタムリソースの名前を指定します。

   2

   仮想マシンが配置されている namespace を指定します。namespace には k8s.ovn.org/primary-user-defined-network ラベルが必要です。namespace として default、openshift-* namespace は使用できません。また Cluster Network Operator (CNO) によって定義されたグローバル namespace と同じにすることはできません。

   3

   ネットワークのトポロジー設定を指定します。必要な値は Layer2 です。Layer2 トポロジーは、すべてのノードで共有される論理スイッチを作成します。

   4

   UDN がプライマリーかセカンダリーかを指定します。Primary ロールとは、UDN が仮想マシンのプライマリーネットワークとして機能し、すべてのデフォルトトラフィックがこのネットワークを通過することを意味します。

   5

   仮想ワークロードが再起動および移行後も、同じ IP アドレスが使用されるように指定します。ipam.lifecycle: Persistent が指定されている場合は、spec.layer2.subnets フィールドが必須です。

2. 次のコマンドを実行して、UserDefinedNetwork マニフェストを適用します。

   $ oc apply -f --validate=true <filename>.yaml

   Copy to Clipboard Toggle word wrap

手順

1. カスタムネットワーク設定を指定するには、ClusterUserDefinedNetwork オブジェクトを作成します。

   ClusterUserDefinedNetwork マニフェストの例

   kind: ClusterUserDefinedNetwork
   metadata:
     name: cudn-l2-net 

   1

   
   spec:
     namespaceSelector: 

   2

   
       matchExpressions: 

   3

   
       - key: kubernetes.io/metadata.name
         operator: In 

   4

   
         values: ["red-namespace", "blue-namespace"]
     network:
       topology: Layer2 

   5

   
       layer2:
         role: Primary 

   6

   
         ipam:
           lifecycle: Persistent
         subnets:
           - 203.203.0.0/16

   Copy to Clipboard Toggle word wrap

   1

   ClusterUserDefinedNetwork カスタムリソースの名前を指定します。

   2

   クラスター UDN が適用される namespace のセットを指定します。namespace セレクターは、default、openshift-* namespace、または Cluster Network Operator (CNO) によって定義されたグローバル namespace を参照できません。

   3

   セレクターのタイプを指定します。この例では、matchExpressions セレクターは、kubernetes.io/metadata.name ラベルと、値が red-namespace または blue-namespace のオブジェクトを選択します。

   4

   演算子の種類を指定します。可能な値は In、NotIn、Exists です。

   5

   ネットワークのトポロジー設定を指定します。必要な値は Layer2 です。Layer2 トポロジーは、すべてのノードで共有される論理スイッチを作成します。

   6

   UDN がプライマリーかセカンダリーかを指定します。Primary ロールとは、UDN が仮想マシンのプライマリーネットワークとして機能し、すべてのデフォルトトラフィックがこのネットワークを通過することを意味します。

2. 次のコマンドを実行して、ClusterUserDefinedNetwork マニフェストを適用します。

   $ oc apply -f --validate=true <filename>.yaml

   Copy to Clipboard Toggle word wrap

手順

1. passt ネットワークバインディングプラグインのテクノロジープレビュー機能を有効にするには、次の手順に従います。

   1. Virtualization パースペクティブから、Overview をクリックします。
   2. Virtualization ページで、Settings タブをクリックします。
   3. Preview features をクリックし、Enable Passt binding for primary user-defined networks を on に設定します。
2. Virtualization パースペクティブから、VirtualMachines をクリックします。
3. 仮想マシンを選択して、VirtualMachine details ページを開きます。
4. Configuration タブをクリックします。
5. Network をクリックします。
6. Network interfaces ページの Options メニュー をクリックし、Edit を選択します。
7. Edit network interface ダイアログで、Network リストからデフォルトの Pod ネットワーク割り当てを選択します。
8. Advanced を展開し、Passt バインディングを選択します。
9. Save をクリックします。
10. 仮想マシンが実行中の場合は、再起動して変更を適用します。

手順

1. 次の例のように、VirtualMachine マニフェストを編集して UDN インターフェイスの詳細を追加します。

   VirtualMachine マニフェストの例:

   apiVersion: kubevirt.io/v1
   kind: VirtualMachine
   metadata:
     name: example-vm
     namespace: my-namespace 

   1

   
   spec:
     template:
       spec:
         domain:
           devices:
             interfaces:
               - name: udn-l2-net 

   2

   
                 binding:
                   name: l2bridge 

   3

   
   # ...
         networks:
         - name: udn-l2-net 

   4

   
           pod: {}
   # ...

   Copy to Clipboard Toggle word wrap

   1

   仮想マシンが配置されている namespace。この値は、UDN が定義されている namespace と一致する必要があります。

   2

   ユーザー定義ネットワークインターフェイスの名前。

   3

   インターフェイスを仮想マシンに接続するために使用されるバインディングプラグインの名前。使用できる値は l2bridge と passt です。デフォルト値は l2bridge です。

   4

   ネットワークの名前。これは、spec.template.spec.domain.devices.interfaces.name フィールドの値と一致する必要があります。

2. オプション: Plug a Simple Socket Transport (passt) ネットワークバインディングプラグインを使用している場合は、次のコマンドを実行して、HyperConverged カスタムリソース (CR) で hco.kubevirt.io/deployPasstNetworkBinding アノテーションを true に設定します。

   $ oc annotate hco kubevirt-hyperconverged -n kubevirt-hyperconverged hco.kubevirt.io/deployPasstNetworkBinding=true --overwrite

   Copy to Clipboard Toggle word wrap
   重要

   passt バインディングプラグインを使用して仮想マシンをプライマリー UDN に接続する機能は、テクノロジープレビュー機能です。テクノロジープレビュー機能は、Red Hat 製品のサービスレベルアグリーメント (SLA) の対象外であり、機能的に完全ではないことがあります。Red Hat は、実稼働環境でこれらを使用することを推奨していません。テクノロジープレビュー機能は、最新の製品機能をいち早く提供して、開発段階で機能のテストを行い、フィードバックを提供していただくことを目的としています。

   Red Hat のテクノロジープレビュー機能のサポート範囲に関する詳細は、テクノロジープレビュー機能のサポート範囲 を参照してください。

3. 次のコマンドを実行して、VirtualMachine マニフェストを適用します。

   $ oc apply -f <filename>.yaml

   Copy to Clipboard Toggle word wrap