25.5. OpenShift SDN ネットワークプラグインからの移行

手順

1. ansible-core パッケージをインストールします（最小バージョン 2.15）。以下のコマンド例は、Red Hat Enterprise Linux (RHEL)に ansible-core パッケージをインストールする方法を示しています。

   $ sudo dnf install -y ansible-core

2. ansible.cfg ファイルを作成し、以下の例のような情報をファイルに追加します。ansible-galaxy コマンドおよび Playbook が実行されるのと同じディレクトリーにファイルが存在することを確認します。

   $ cat << EOF >> ansible.cfg
   [galaxy]
   server_list = automation_hub, validated
   
   [galaxy_server.automation_hub]
   url=https://console.redhat.com/api/automation-hub/content/published/
   auth_url=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
   token=
   
   #[galaxy_server.release_galaxy]
   #url=https://galaxy.ansible.com/
   
   [galaxy_server.validated]
   url=https://console.redhat.com/api/automation-hub/content/validated/
   auth_url=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token
   token=
   EOF

3. Ansible Automation Platform Web コンソールから、Connect to Hub ページに移動し、次の手順を実行します。

   1. ページの Offline token セクションで、Load token ボタンをクリックします。
   2. トークンがロードされたら、Copy to clipboard アイコンをクリックします。
   3. ansible.cfg ファイルを開き、API トークンを token= パラメーターに貼り付けます。API トークンは、ansible.cfg ファイルで指定されたサーバー URL に対して認証するために必要です。

4. 以下の ansible-galaxy コマンドを入力して、network.offline_migration_sdn_to_ovnk Ansible コレクションをインストールします。

   $ ansible-galaxy collection install network.offline_migration_sdn_to_ovnk

5. network.offline_migration_sdn_to_ovnk Ansible コレクションがシステムにインストールされていることを確認します。

   $ ansible-galaxy collection list | grep network.offline_migration_sdn_to_ovnk

   出力例

   network.offline_migration_sdn_to_ovnk   1.0.2

   network.offline_migration_sdn_to_ovnk Ansible コレクションは、~/.ansible/collections/ansible_collections/network/offline_migration_sdn_to_ovnk/ のデフォルトパスに保存されます。

6. playbooks/playbook-migration.yml ファイルで移行機能を設定します。

   # ...
       migration_interface_name: eth0
       migration_disable_auto_migration: true
       migration_egress_ip: false
       migration_egress_firewall: false
       migration_multicast: false
       migration_routing_via_host: true
       migration_ip_forwarding: Global
       migration_cidr: "10.240.0.0/14"
       migration_prefix: 23
       migration_mtu: 1400
       migration_geneve_port: 6081
       migration_ipv4_subnet: "100.64.0.0/16"
   # ...

   migration_interface_name

   プライマリーインターフェイスで NodeNetworkConfigurationPolicy (NNCP)リソースを使用する場合は、移行プロセス中に NNCP リソースがプライマリーインターフェイスで削除されるように、migration-playbook.yml ファイルでインターフェイス名を指定します。

   migration_disable_auto_migration

   OVN-Kubernetes プラグインへの OpenShift SDN CNI プラグイン機能の自動移行を無効にします。機能の自動移行を無効にする場合は、migration_egress_ip パラメーター、migration_egress_firewall パラメーター、および migration_multicast パラメーターも false に設定する必要があります。機能の自動移行を有効にする必要がある場合は、パラメーターを false に設定します。

   migration_routing_via_host

   ローカルゲートウェイモードを設定するには true に設定し、クラスターのノードの共有ゲートウェイモードを設定するには false に設定します。デフォルト値は false です。ローカルゲートウェイモードでは、トラフィックはホストネットワークスタックを介してルーティングされます。共有ゲートウェイモードでは、トラフィックはホストネットワークスタック経由でルーティングされません。

   migration_ip_forwarding

   ローカルゲートウェイモードを設定している場合は、ノードのホストネットワークが OVN-Kubernetes に関係のないトラフィックのルーターとして機能する必要がある場合は、IP 転送を Global に設定します。

   migration_cidr

   クラスターの Classless Inter-Domain Routing (CIDR) IP アドレスブロックを指定します。OVN-Kubernetes ネットワークプロバイダーはこのブロックを内部で使用するため、100.64.0.0/16 CIDR ブロックと重複する CIDR ブロックは使用できません。

   migration_prefix

   クラスター内の各ノードに割り当てられる CIDR ブロックのスライスである prefix 値を指定します。

   migration_mtu

   移行プロセス後にクラスターネットワークに特定の最大伝送単位(MTU)を設定するオプションのパラメーター。

   migration_geneve_port

   OVN-Kubernetes の Geneve ポートを設定するオプションのパラメーター。デフォルトのポートは 6081 です。

   migration_ipv4_subnet

   OVN-Kubernetes による内部使用の IPv4 アドレス範囲を設定するオプションのパラメーター。パラメーターのデフォルト値は 100.64.0.0/16 です。

7. playbooks/playbook-migration.yml ファイルを実行するには、以下のコマンドを入力します。

   $ ansible-playbook -v playbooks/playbook-migration.yml