7.5. macvlan ネットワークの設定
クラスター管理者は、macvlan CNI プラグインを使用して、クラスターの追加のネットワークを設定できます。Pod がネットワークに割り当てられている場合、プラグインはホストの親インターフェースからサブインターフェースを作成します。各サブデバイスに対して固有のハードウェアの MAC アドレスが生成されます。
このプラグインがサブインターフェース用に生成する固有の MAC アドレスは、クラウドプロバイダーのセキュリティーポリシーとの互換性がない場合があります。
7.5.1. macvlan CNI プラグインを使用した追加ネットワーク割り当ての作成
Cluster Network Operator (CNO) は追加ネットワークの定義を管理します。作成する追加ネットワークを指定する場合、CNO は NetworkAttachmentDefinition カスタムリソース (CR) を自動的に作成します。
Cluster Network Operator が管理する NetworkAttachmentDefinition CR は編集しないでください。これを実行すると、追加ネットワークのネットワークトラフィックが中断する可能性があります。
前提条件
-
ocとして知られる OpenShift コマンドラインインターフェース (CLI) のインストール。 -
cluster-admin権限を持つユーザーとしてのログイン。
手順
クラスターの追加ネットワークを作成するには、以下の手順を実施します。
以下のコマンドを実行して CNO CR を編集します。
$ oc edit networks.operator.openshift.io cluster
以下のサンプル CR のように、作成される追加ネットワークの設定を追加して、作成している CR を変更します。
以下の YAML は、macvlan CNI プラグインを設定します。
apiVersion: operator.openshift.io/v1 kind: Network metadata: name: cluster spec: additionalNetworks: 1 - name: test-network-1 namespace: test-1 type: SimpleMacvlan simpleMacvlanConfig: ipamConfig: type: static staticIPAMConfig: addresses: - address: 10.1.1.0/24- 1
- 追加ネットワーク割り当て定義の設定を指定します。
- 変更を保存し、テキストエディターを終了して、変更をコミットします。
オプション: 以下のコマンドを実行して、CNO が NetworkAttachmentDefinition CR を作成していることを確認します。CNO が CR を作成するまでに遅延が生じる可能性があります。
$ oc get network-attachment-definitions -n <namespace> NAME AGE test-network-1 14m
7.5.1.1. macvlan CNI プラグインの設定
以下の YAML は、macvlan Container Network Interface (CNI) プラグインの設定パラメーターについて説明しています。
macvlan YAML の設定
name: <name> 1 namespace: <namespace> 2 type: SimpleMacvlan simpleMacvlanConfig: master: <master> 3 mode: <mode> 4 mtu: <mtu> 5 ipamConfig: 6 ...
- 1
- 作成している追加ネットワーク割り当ての名前を指定します。名前は指定された
namespace内で一意である必要があります。 - 2
- ネットワークの割り当てを作成する namespace を指定します。値が指定されない場合は、
defaultnamespace が使用されます。 - 3
- 仮想インターフェースに関連付けるイーサネットインターフェース。
masterの値が指定されない場合、ホストシステムのプライマリーイーサネットインターフェースが使用されます。 - 4
- 仮想ネットワークのトラフィックの可視性を設定します。
bridge、passthru、private、またはvepaのいずれかである必要があります。modeの値が指定されない場合、デフォルトの値はbridgeになります。 - 5
- 最大転送単位 (MTU) を指定された値に設定します。デフォルト値はカーネルによって自動的に設定されます。
- 6
- IPAM CNI プラグインの設定オブジェクトを指定します。プラグインは、割り当て定義についての IP アドレスの割り当てを管理します。
7.5.1.1.1. macvlan 設定の例
以下の例では、macvlan-net という名前の追加のネットワークを設定します。
name: macvlan-net
namespace: work-network
type: SimpleMacvlan
simpleMacvlanConfig:
ipamConfig:
type: DHCP7.5.1.2. IPAM CNI プラグインの設定
IP アドレス管理 (IPAM) CNI プラグインは、他の CNI プラグインの IP アドレスの割り当てを管理します。DHCP を使用して、静的 IP アドレスの割り当てまたは動的 IP アドレスの割り当てのいずれかに IPAM を設定することができます。指定する DHCP サーバーは、追加のネットワークから到達可能である必要があります。
OpenShift Container Platform 4.2.0 では、Pod を、IP アドレス管理に DHCP を使用する追加ネットワークに割り当てると、Pod は起動に失敗します。これは OpenShift Container Platform 4.2.1 で修正されています。詳細は、BZ#1754686 を参照してください。
以下の YAML 設定は設定可能なパラメーターについて説明しています。
type パラメーターを DHCP 値に設定すると、その他のパラメーターを設定することはできません。
IPAM CNI プラグイン YAML 設定オブジェクト
ipamConfig: type: <type> 1 ... 2
7.5.1.2.1. 静的 IPAM 設定 YAML
以下の YAML は、静的 IP アドレスの割り当ての設定について説明しています。
静的 IPAM 設定 YAML
ipamConfig:
type: static
staticIPAMConfig:
addresses: 1
- address: <address> 2
gateway: <gateway> 3
routes: 4
- destination: <destination> 5
gateway: <gateway> 6
dns: 7
nameservers: 8
- <nameserver>
domain: <domain> 9
search: 10
- <search_domain>
- 1
- 仮想インターフェースに割り当てる IP アドレスを定義するマッピングのコレクション。IPv4 と IPv6 の IP アドレスの両方がサポートされます。
- 2
10.1.1.0/24など、ワーカーノードの Pod に割り当てる CIDR 形式で指定する IP アドレスのブロック。- 3
- egress ネットワークトラフィックをルーティングするデフォルトのゲートウェイ。
- 4
- Pod 内で設定するルートを記述するマッピングのコレクション。
- 5
- CIDR 形式の IP アドレス範囲。
- 6
- ネットワークトラフィックのルーティングに使用するゲートウェイ。
- 7
- DNS 設定。オプション。
- 8
- DNS クエリーを送信する 1 つ以上の IP アドレスのコレクション。
- 9
- ホスト名に追加するデフォルトのドメイン。たとえば、ドメインが
example.comに設定されている場合、example-hostの DNS ルックアップクエリー はexample-host.example.comとして書き換えられます。 - 10
- DNS ルックアップクエリー時に非修飾ホスト名に追加されるドメイン名の配列 (例:
example-host)。
7.5.1.2.2. 動的 IPAM 設定 YAML
以下の YAML は、静的 IP アドレスの割り当ての設定について説明しています。
動的 IPAM 設定 YAML
ipamConfig: type: DHCP
7.5.1.2.3. 静的 IP アドレス割り当ての設定例
以下の例は、静的 IP アドレスの IPAM 設定を示しています。
ipamConfig:
type: static
staticIPAMConfig:
addresses:
- address: 198.51.100.11/24
gateway: 198.51.100.10
routes:
- destination: 0.0.0.0/0
gateway: 198.51.100.1
dns:
nameservers:
- 198.51.100.1
- 198.51.100.2
domain: testDNS.example
search:
- testdomain1.example
- testdomain2.example7.5.1.2.4. 動的 IP アドレス割り当ての設定例
以下の例では、DHCP の IPAM 設定を示しています。
ipamConfig: type: DHCP
次のステップ
