10.7. 更新网络配置文件的格式

流程

1. 下载转换工具：

   • /usr/share/openstack-tripleo-heat-templates/tools/convert_v1_net_data.py

2. 将 RHOSP 16+ 网络配置文件转换为 RHOSP 17+ 格式：

   $ python3 convert_v1_net_data.py <network_config>.yaml

   • 将 < network_config > 替换为您要转换的现有配置文件的名称，如 network_data.yaml。

流程

1. 下载转换工具：

   • /usr/share/openstack-tripleo-heat-templates/tools/convert_heat_nic_config_to_ansible_j2.py

2. 将您的 Compute 和 Controller NIC 临时文件以及任何其他自定义网络文件转换为 Jinja2 Ansible 格式：

   $ python3 convert_heat_nic_config_to_ansible_j2.py \
    [--stack <overcloud> | --standalone] --networks_file <network_config.yaml> \
    <network_template>.yaml

   • 将 <overcloud> 替换为 overcloud 堆栈的名称或 UUID。如果未指定-- stack，堆栈默认为 overcloud。

     注意

     您只能在 RHOSP 16 部署中使用-- stack 选项，因为它需要在 undercloud 节点上运行编排服务(heat)。从 RHOSP 17 开始，RHOSP 部署使用临时 heat，它在容器中运行编排服务。如果编排服务不可用，或者您没有堆栈，则使用- standalone 选项，而不是- stack。

   • 将 <network_config.yaml > 替换为描述网络部署的配置文件的名称，如 network_data.yaml。
   • 将 < network_template > 替换为您要转换的网络配置文件的名称。

   重复此命令，直到您转换了所有自定义网络配置文件。convert_heat_nic_config_to_ansible_j2.py 脚本为您传递给它的每个 yaml 文件生成一个 .j2 文件以进行转换。

3. 检查每个生成的 .j2 文件，以确保配置正确并完成您的环境，并手动解决工具生成的任何注释，突出显示无法转换配置的位置。有关手动将 NIC 配置转换为 Jinja2 格式的更多信息，请参阅 Heat 参数到 Ansible 变量映射。

4. 在 network-environment.yaml 文件中配置 *NetworkConfigTemplate 参数以指向生成的 .j2 文件：

   parameter_defaults:
     ControllerNetworkConfigTemplate: '/home/stack/templates/custom-nics/controller.j2'
     ComputeNetworkConfigTemplate: '/home/stack/templates/custom-nics/compute.j2'

5. 为旧网络配置文件从 network-environment.yaml 文件中删除 resource_registry 映射：

   resource_registry:
     OS::TripleO::Compute::Net::SoftwareConfig: /home/stack/templates/nic-configs/compute.yaml
     OS::TripleO::Controller::Net::SoftwareConfig: /home/stack/templates/nic-configs/controller.yaml

流程

1. 创建 Jinja2 模板。您可以使用 os-net-config 模式创建新模板，或者从 undercloud 节点上的 /usr/share/ansible/roles/tripleo_network_config/templates/ 目录中复制并编辑示例模板。

2. 将 heat 内部函数替换为 Jinja2 过滤器。例如，使用以下过滤器来计算 min_viable_mtu ：

   {% set mtu_list = [ctlplane_mtu] %}
   {% for network in role_networks %}
   {{ mtu_list.append(lookup('vars', networks_lower[network] ~ '_mtu')) }}
   {%- endfor %}
   {% set min_viable_mtu = mtu_list | max %}

3. 使用 Ansible 变量为您的部署配置网络属性。您可以手动配置每个单独的网络，或者通过迭代 role_networks 来编程地配置每个网络：

   • 要手动配置每个网络，请将每个 get_param 函数替换为对应的 Ansible 变量。例如，如果您的当前部署使用 get_param: InternalApiNetworkVlanID 配置 vlan_id，那么请在模板中添加以下配置：

     vlan_id: {{ internal_api_vlan_id }}

     Expand

     表 10.12. 从 heat 参数映射到 Ansible vars的示例网络属性

     yaml 文件格式	Jinja2 ansible 格式, j2
     - type: vlan device: nic2 vlan_id: get_param: InternalApiNetworkVlanID addresses: - ip_netmask: get_param: InternalApiIpSubnet	- type: vlan device: nic2 vlan_id: {{ internal_api_vlan_id }} addresses: - ip_netmask: {{ internal_api_ip }}/{{ internal_api_cidr }}

     Show more

   • 为了通过编程方式配置每个网络，请将 Jinja2 for-loop 结构添加到您的模板中，通过使用 role_networks 检索可用网络。

     示例

     {% for network in role_networks %}
       - type: vlan
         mtu: {{ lookup('vars', networks_lower[network] ~ '_mtu') }}
         vlan_id: {{ lookup('vars', networks_lower[network] ~ '_vlan_id') }}
         addresses:
         - ip_netmask: {{ lookup('vars', networks_lower[network] ~ '_ip') }}/{{ lookup('vars', networks_lower[network] ~ '_cidr') }}
         routes: {{ lookup('vars', networks_lower[network] ~ '_host_routes') }}
     {%- endfor %}

   有关 heat 参数与 Ansible vars 等效的映射的完整列表，请参阅 Heat 参数到 Ansible 变量映射。

4. 在 network-environment.yaml 文件中配置 *NetworkConfigTemplate 参数以指向生成的 .j2 文件：

   parameter_defaults:
     ControllerNetworkConfigTemplate: '/home/stack/templates/custom-nics/controller.j2'
     ComputeNetworkConfigTemplate: '/home/stack/templates/custom-nics/compute.j2'

5. 为旧网络配置文件从 network-environment.yaml 文件中删除 resource_registry 映射：

   resource_registry:
     OS::TripleO::Compute::Net::SoftwareConfig: /home/stack/templates/nic-configs/compute.yaml
     OS::TripleO::Controller::Net::SoftwareConfig: /home/stack/templates/nic-configs/controller.yaml