将网络服务迁移到 ML2/OVN 机制驱动程序

流程

1. 创建 ML2/OVN 阶段部署，以获取目标 ML2/OVN 部署的基础配置，并测试目标部署的可行性。

   使用与迁移后生产部署相同的基本角色、路由和拓扑设计阶段部署。保存 overcloud-deploy.sh 文件以及部署引用的任何文件，如环境文件。稍后需要这些文件来配置迁移目标环境。

   注意

   这些文件仅用于创建 stage 部署并在迁移中。迁移后不要重新使用它们。

2. 如果您的 ML2/OVS 部署使用 VXLAN 或 GRE 项目网络，请在 setup-mtu-t1 步骤后调度等待最多 24 小时。

   • 此等待周期允许虚拟机实例续订其 DHCP 租期并接收新的 MTU 值。在此期间，您可能需要在一些实例上手动设置 MTU，并重新启动一些实例。
   • 24 小时是基于 86400 秒默认配置的时间。实际时间取决于 /var/lib/config-data/puppet-generated/neutron/dhcp_agent.ini dhcp_renewal_time 和 /var/lib/config-data/puppet-generated/neutron/etc/neutron/neutron.conf dhcp_lease_duration 参数。

3. 安装 python3-networking-ovn-migration-tool。

   sudo dnf install python3-networking-ovn-migration-tool @container-tools

   @container-tools 参数也会安装容器工具（如果容器工具尚不存在）。

4. 在 undercloud 上创建目录，再复制 Ansible playbook：

   mkdir ~/ovn_migration
   cd ~/ovn_migration
   cp -rfp /usr/share/ansible/networking-ovn-migration/playbooks .

5. 将 ML2/OVN 阶段部署文件复制到迁移主目录，如 ~/ovn_migration。

   阶段迁移部署文件包括 overcloud-deploy.sh 和部署引用的任何文件，如环境文件。将 overcloud-deploy.sh 副本重命名为 overcloud-deploy-ovn.sh。只将这个脚本用于迁移。不要将它用于其他目的。

6. 在以下列表中找到您的迁移场景，并执行适当的步骤，以在 overcloud-deploy-ovn.sh 中自定义 openstack deploy 命令。

   情景 1： DVR 到 DVR，计算节点具有连接到外部网络

   • 在 overcloud-deploy-ovn.sh 中的 openstack deploy 命令中添加以下环境文件。按照所示的顺序添加它们。此命令使用默认的 neutron-ovn-dvr-ha.yaml 文件。如果您使用其他文件，替换命令中的文件名。

     -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovn-dvr-ha.yaml \
     -e $HOME/ovn-extras.yaml

   情景 2：集中路由到集中式路由（无 DVR）

   • 如果您的部署使用 SR-IOV，请将服务定义 OS::TripleO::Services::OVNMetadataAgent 添加到文件 roles_data.yaml 中的 Controller 角色。

   • 保留迁移前自定义网桥映射。

     • 在网络人员或组合的 networker/controller 节点上运行这个命令来获取当前的网桥映射：

       sudo podman exec -it neutron_ovs_agent crudini --get /etc/neutron/plugins/ml2/openvswitch_agent.ini ovs bridge_mappings

       输出示例

       datacentre:br-ex,tenant:br-isolated

     • 在 undercloud 上，为网桥映射创建一个环境文件： /home/stack/neutron_bridge_mappings.yaml。

     • 在环境文件中设置默认值。例如：

       parameter_defaults:
         ComputeParameters:
           NeutronBridgeMappings: "datacentre:br-ex,tenant:br-isolated"

   • 在 overcloud-deploy-ovn.sh 中的 openstack deploy 命令中添加以下环境文件。按照所示的顺序添加它们。如果您的环境没有使用 SR-IOV，请省略 neutron-ovn-sriov.yaml 文件。文件 ovn-extras.yaml 尚不存在，但在运行 openstack deploy 命令前由脚本 ovn_migration.sh 创建。

     -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovn-ha.yaml \
     -e /usr/share/openstack-tripleo-heat-templates/environments/services/neutron-ovn-sriov.yaml \
     -e /home/stack/ovn-extras.yaml  \
     -e /home/stack/neutron_bridge_mappings.yaml

   • 保留任何自定义网络修改与迁移前相同。

   情景 3：利用 Geneve 类型驱动程序到 DVR 的集中式路由，以及通过 br-ex连接到外部网络的计算节点

   警告

   如果您的 ML2/OVS 部署使用集中式路由和 VLAN 项目（租户）网络，请不要使用 DVR 迁移到 ML2/OVN。您可以使用集中式路由迁移到 ML2/OVN。要跟踪这个限制的进度，请参阅 https://bugzilla.redhat.com/show_bug.cgi?id=1766930。

   • 确保计算节点通过 br-ex 网桥连接到外部网络。例如，在一个环境文件中（如 compute-dvr.yaml）中设置以下内容：

     type: ovs_bridge
         # Defaults to br-ex, anything else requires specific # bridge mapping entries for it to be used.
         name: bridge_name
         use_dhcp: false
         members:
          -
           type: interface
           name: nic3
           # force the MAC address of the bridge to this interface
           primary: true

7. 确保所有用户在文件 overcloud-deploy-ovn.sh 上具有执行权限。这个脚本在迁移过程中需要执行特权。

   $ chmod a+x ~/overcloud-deploy-ovn.sh

8. 使用 导出 命令设置以下与迁移相关的环境变量。例如：

   $ export PUBLIC_NETWORK_NAME=my-public-network

   • STACKRC_FILE - undercloud 中的 stackrc 文件。

     默认： ~/stackrc

   • OVERCLOUDRC_FILE - undercloud 中的 overcloudrc 文件。

     默认： ~/overcloudrc

   • OVERCLOUD_OVN_DEPLOY_SCRIPT - 部署脚本。

     默认值： ~/overcloud-deploy-ovn.sh

   • PUBLIC_NETWORK_NAME -您的公共网络的名称。

     默认： public。

   • IMAGE_NAME - 用于引导测试服务器的 glance 镜像的名称或 ID。

     默认值： cirros.

     镜像会在 pre-validation / post-validation 进程中自动下载。

   • VALIDATE_MIGRATION - 创建迁移资源以验证迁移。在开始迁移前，迁移脚本会引导服务器并验证在迁移后是否可以访问服务器。

     默认值：True。

     警告

     迁移验证至少需要两个可用的浮动 IP 地址、两个网络、两个子网、两个实例和两个路由器作为 admin。

     另外，由 PUBLIC_NETWORK_NAME 指定的网络必须有可用的浮动 IP 地址，且您必须能够从 undercloud ping它们。

     如果您的环境没有满足这些要求，请将 VALIDATE_MIGRATION 设置为 False。

   • SERVER_USER_NAME - 用于登录迁移实例的用户名。

     默认值： cirros.

   • DHCP_RENEWAL_TIME - DHCP 续订时间（以秒为单位）在 DHCP 代理配置文件中配置。

     默认：30

9. 确保位于 ovn-migration 目录中，再运行命令 ovn_migration.sh generate-inventory 生成清单文件 host _for_migration 和 ansible.cfg 文件。

   $ ovn_migration.sh generate-inventory   | sudo tee -a /var/log/ovn_migration_output.txt

10. 检查 host_for_migration 文件的准确性。

    1. 确保列表与您的环境匹配。
    2. 确保每个节点上存在 ovn 控制器。
    3. 确保没有列表标题（如 [ovn-controllers]）下没有列表项。
    4. 从 ovn 迁移目录中，运行命令 ansible -i hosts_for_migration -m ping all

11. 如果您的原始部署使用 VXLAN 或 GRE，则需要调整最大传输单元(MTU)值。继续 调整 MTU，以便从 OVS 机制驱动程序迁移到 OVN 机制驱动程序。

    如果您的原始部署使用 VLAN 网络，您可以跳过 MTU 调整，并继续 准备从 OVS 机制驱动程序迁移到 OVN 机制驱动程序的容器镜像。

流程

1. 运行 ovn_migration.sh setup-mtu-t1。这会降低运行 DHCP 代理的所有节点中 DHCP 服务器的 T1 参数，该服务器在 /var/lib/config-data/puppet-generated/neutron/etc/neutron/dhcp_agent.ini 中配置 dhcp_renewal_time。

   $ ovn_migration.sh setup-mtu-t1   | sudo tee -a /var/log/ovn_migration_output.txt

2. 如果您的原始 OVS 部署使用 VXLAN 或 GRE 项目网络，请等待 DHCP 租期已在所有虚拟机实例上续订。这可能需要 24 小时，具体取决于租期续订设置和实例数量。

3. 验证 T1 参数是否已传播到现有虚拟机。

   • 连接到其中一个计算节点。

   • 通过附加到项目网络的 VM tap 之一运行 tcpdump。

     如果 T1 传播成功，预计大约每 30 秒发生请求：

     [heat-admin@overcloud-novacompute-0 ~]$ sudo tcpdump -i tap52e872c2-e6 port 67 or port 68 -n
     tcpdump: verbose output suppressed, use -v or -vv for full protocol decode
     listening on tap52e872c2-e6, link-type EN10MB (Ethernet), capture size 262144 bytes
     13:17:28.954675 IP 192.168.99.5.bootpc > 192.168.99.3.bootps: BOOTP/DHCP, Request from fa:16:3e:6b:41:3d, length 300
     13:17:28.961321 IP 192.168.99.3.bootps > 192.168.99.5.bootpc: BOOTP/DHCP, Reply, length 355
     13:17:56.241156 IP 192.168.99.5.bootpc > 192.168.99.3.bootps: BOOTP/DHCP, Request from fa:16:3e:6b:41:3d, length 30013:17:56.249899 IP 192.168.99.3.bootps > 192.168.99.5.bootpc: BOOTP/DHCP, Reply, length 355

     注意

     这个验证无法使用 cirros 虚拟机。cirros udhcpc' 实现不会响应 DHCP 选项 58 (T1)。在属于完整的 Linux 虚拟机的端口中尝试此验证。红帽建议您检查工作负载中代表的所有不同操作系统，如 Windows 和 Linux 发行版本的变体。

4. 如果任何虚拟机实例没有更新，以反映对 DHCP 的 T1 参数的更改，重启它们。

5. 降低预迁移 VXLAN 和 GRE 网络的 MTU：

   $ ovn_migration.sh reduce-mtu   | sudo tee -a /var/log/ovn_migration_output.txt

   这一步会降低 MTU 网络，并使用 adapted_mtu 标记已完成的网络。该工具仅适用于 VXLAN 和 GRE 网络。如果您的部署只有 VLAN 项目网络，此步骤不会更改任何值。

6. 如果您在 VXLAN 或 GRE 项目网络上有任何静态 IP 分配的实例，请手动修改这些实例的配置来配置新的 Geneve MTU，这是当前的 VXLAN MTU 减 8 字节。例如，如果基于 VXLAN 的 MTU 是 1450，请将其改为 1442。

   注意

   只有在 VXLAN 或 GRE 项目网络上手动提供了静态 IP 分配和 MTU 设置，才执行此步骤。默认情况下，DHCP 提供 IP 分配和 MTU 设置。

7. 继续 准备容器镜像以从 OVS 机制驱动程序迁移到 OVN 机制驱动程序。

流程

1. 准备新容器镜像，以便在迁移到 ML2/OVN 后使用。

   1. 如果不存在，请在主目录中创建 containers-prepare-parameter.yaml 文件。

      $ test -f $HOME/containers-prepare-parameter.yaml || sudo openstack tripleo container image prepare default \
      --output-env-file $HOME/containers-prepare-parameter.yaml

   2. 验证 $HOME/overcloud-deploy-ovn.sh 和 $HOME/overcloud-deploy.sh 文件的末尾是否存在 containers-prepare-parameter.yaml。

   3. 将 containers-prepare-parameter.yaml 文件中的 neutron_driver 更改为 ovn:

      $ sed -i -E 's/neutron_driver:([ ]\w+)/neutron_driver: ovn/' $HOME/containers-prepare-parameter.yaml

   4. 验证对 neutron_driver 的更改：

      $ grep neutron_driver $HOME/containers-prepare-parameter.yaml
      neutron_driver: ovn

   5. 更新镜像：

      $ sudo openstack tripleo container image prepare \
      --environment-file /home/stack/containers-prepare-parameter.yaml

      注意

      提供 containers-prepare-parameter.yaml 文件的完整路径。否则，命令可以快速完成，而无需更新镜像列表或提供错误消息。

2. 在 undercloud 上，验证更新的镜像。

   . Log in to the undercloud as the user `stack` and source the stackrc file.
   $ source ~/stackrc
   $ openstack tripleo container image list | grep  '\-ovn'

   您的列表应类似以下示例。它包含 OVN 数据库、OVN 控制器、元数据代理和 neutron 服务器代理的容器。

   docker://undercloud-0.ctlplane.redhat.local:8787/rh-osbs/rhosp16-openstack-ovn-northd:16.2_20211110.2
   docker://undercloud-0.ctlplane.redhat.local:8787/rh-osbs/rhosp16-openstack-ovn-sb-db-server:16.2_20211110.2
   docker://undercloud-0.ctlplane.redhat.local:8787/rh-osbs/rhosp16-openstack-ovn-controller:16.2_20211110.2
   docker://undercloud-0.ctlplane.redhat.local:8787/rh-osbs/rhosp16-openstack-neutron-server-ovn:16.2_20211110.2
   docker://undercloud-0.ctlplane.redhat.local:8787/rh-osbs/rhosp16-openstack-ovn-nb-db-server:16.2_20211110.2
   docker://undercloud-0.ctlplane.redhat.local:8787/rh-osbs/rhosp16-openstack-neutron-metadata-agent-ovn:16.2_20211110.2

3. 继续 从 ML2/OVS 迁移到 ML2/OVN。

流程

1. 停止与网络服务(neutron) API 交互的所有操作，如创建新网络、子网或路由器，或在计算节点之间迁移虚拟机实例。

   在迁移过程中与网络 API 交互可能会导致未定义的行为。您可以在完成迁移后重启 API 操作。

2. 运行 ovn_migration.sh start-migration 以开始迁移过程。tee 命令创建脚本输出的副本，以进行故障排除。

   $ ovn_migration.sh start-migration  | sudo tee -a /var/log/ovn_migration_output.txt