director 的安装和使用

步骤

1. 以下示例在 nova-compute 镜像上运行自定义 Dockerfile：

   ContainerImagePrepare:
   - push_destination: true
     ...
     includes:
     - nova-compute
     modify_role: tripleo-modify-image
     modify_append_tag: "-hotfix"
     modify_vars:
       tasks_from: modify_image.yml
       modify_dir_path: /home/stack/nova-custom
     ...

2. 以下示例显示了 /home/stack/nova-custom/Dockerfile 文件。运行任何 USER 根指令后，必须切换回原始镜像默认用户：

   FROM registry.redhat.io/rhosp-rhel9/openstack-nova-compute:latest
   
   USER "root"
   
   COPY customize.sh /tmp/
   RUN /tmp/customize.sh
   
   USER "nova"

步骤

1. 创建所有容器镜像的列表：

   $ sudo podman search --limit 1000 "registry.redhat.io/rhosp-rhel9" --format="{{ .Name }}" | sort > satellite_images
   $ sudo podman search --limit 1000 "registry.redhat.io/rhceph" | grep rhceph-5-dashboard-rhel8
   $ sudo podman search --limit 1000 "registry.redhat.io/rhceph" | grep rhceph-5-rhel8
   $ sudo podman search --limit 1000 "registry.redhat.io/openshift" | grep ose-prometheus

   • 如果您计划安装 Ceph 并启用 Ceph 仪表板，则需要以下 ose-prometheus 容器：

     registry.redhat.io/openshift4/ose-prometheus-node-exporter:v4.6
     registry.redhat.io/openshift4/ose-prometheus:v4.6
     registry.redhat.io/openshift4/ose-prometheus-alertmanager:v4.6

2. 将 satellite_images 文件复制到包含 Satellite 6 hammer 工具的系统中。或者，根据 Hammer CLI 指南中的说明将 hammer 工具安装到 undercloud 中。

3. 运行以下 hammer 命令以在 Satellite 机构中创建新产品(OSP 容器)：

   $ hammer product create \
     --organization "ACME" \
     --name "OSP Containers"

   该定制产品将会包含您的镜像。

4. 添加 satellite_images 文件中的 overcloud 容器镜像：

   $ while read IMAGE; do \
     IMAGE_NAME=$(echo $IMAGE | cut -d"/" -f3 | sed "s/openstack-//g") ; \
     IMAGE_NOURL=$(echo $IMAGE | sed "s/registry.redhat.io\///g") ; \
     hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name $IMAGE_NOURL \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name $IMAGE_NAME ; done < satellite_images

5. 添加 Ceph Storage 容器镜像：

   $ hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name rhceph/rhceph-5-rhel8 \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name rhceph-5-rhel8

   注意

   如果要安装 Ceph 仪表板，请在 hammer repository create 命令中包含 --name rhceph-5-dashboard-rhel8 ：

   $ hammer repository create \
     --organization "ACME" \
     --product "OSP Containers" \
     --content-type docker \
     --url https://registry.redhat.io \
     --docker-upstream-name rhceph/rhceph-5-dashboard-rhel8 \
     --upstream-username USERNAME \
     --upstream-password PASSWORD \
     --name rhceph-5-dashboard-rhel8

6. 同步容器镜像：

   $ hammer product synchronize \
     --organization "ACME" \
     --name "OSP Containers"

   等待 Satellite 服务器完成同步。

   注意

   根据具体配置情况，hammer 可能会询问您的 Satellite 服务器用户名和密码。您可以使用配置文件将 hammer 配置为自动登录。有关更多信息，请参阅 Hammer CLI 指南中的身份验证章节。

7. 如果您的 Satellite 6 服务器使用内容视图，请创建一个用于纳入镜像的新内容视图版本，并在应用生命周期的不同环境之间推进这个视图。这在很大程度上取决于您如何构建应用程序的生命周期。例如，如果您的生命周期中有一个称为 production 的环境，并且希望容器镜像在该环境中可用，则创建一个包含容器镜像的内容视图，并将该内容视图推进到 production 环境中。有关更多信息，请参阅管理内容视图。

8. 检查 base 镜像的可用标签：

   $ hammer docker tag list --repository "base" \
     --organization "ACME" \
     --lifecycle-environment "production" \
     --product "OSP Containers"

   此命令显示内容视图中特定环境的 OpenStack Platform 容器镜像的标签。

9. 返回到 undercloud，并生成默认的环境文件，它将您的 Satellite 服务器用作源来准备镜像。运行以下示例命令以生成环境文件：

   $ sudo openstack tripleo container image prepare default \
     --output-env-file containers-prepare-parameter.yaml

   • --output-env-file 是环境文件名称。此文件的内容包括用于为 undercloud 准备容器镜像的参数。在本例中，文件的名称是 containers-prepare-parameter.yaml。

10. 编辑 containers-prepare-parameter.yaml 文件并修改以下参数：

    • push_destination - 根据您选择的容器镜像管理策略，将此参数设置为 true 或 false。如果将此参数设置为 false，则 overcloud 节点直接从 Satellite 拉取镜像。如果将此参数设置为 true，则 director 将镜像从 Satellite 拉取到 undercloud registry，overcloud 从 undercloud registry 拉取镜像。
    • namespace - Satellite 服务器上 registry 的 URL。

    • name_prefix - 该前缀基于 Satellite 6 规范。它的值根据您是否使用了内容视图而不同：

      • 如果您使用了内容视图，则前缀的结构为 [组织]-[环境]-[内容视图]-[产品]-。例如： acme-production-myosp16-osp_containers-。
      • 如果不使用内容视图，则前缀的结构为 [组织]-[产品]-。例如： acme-osp_containers-。
    • ceph_namespace、ceph_image、ceph_tag - 如果使用 Ceph Storage，请额外纳入这些参数以定义 Ceph Storage 容器镜像的位置。请注意，ceph_image 现包含特定于 Satellite 的前缀。这个前缀与 name_prefix 选项的值相同。

流程

1. 以 stack 用户的身份登录 undercloud。

2. Source stackrc 文件：

   [stack@director ~]$ source ~/stackrc

3. 安装 rhosp-director-images-uefi-x86_64 和 rhosp-director-images-ipa-x86_64 软件包：

   (undercloud) [stack@director ~]$ sudo dnf install rhosp-director-images-uefi-x86_64 rhosp-director-images-ipa-x86_64

4. 在 stack 用户的主目录 /home/ stack / images 中创建 images 目录：

   (undercloud) [stack@director ~]$ mkdir /home/stack/images

   如果目录已存在，请跳过这一步。

5. 将镜像存档提取到 images 目录中：

   (undercloud) [stack@director ~]$ cd ~/images
   (undercloud) [stack@director images]$ for i in /usr/share/rhosp-director-images/ironic-python-agent-latest.tar /usr/share/rhosp-director-images/overcloud-hardened-uefi-full-latest.tar; do tar -xvf $i; done

6. 将镜像导入 director：

   (undercloud) [stack@director images]$ openstack overcloud image upload --image-path /home/stack/images/

   此命令将镜像格式从 QCOW 转换为 RAW，并提供镜像上传进度状态的详细更新。

7. 验证 overcloud 镜像是否已复制到 /var/lib/ironic/images/ 中：

   (undercloud) [stack@director images]$ ls -l /var/lib/ironic/images/
   total 1955660
   -rw-r--r--. 1 root 42422 40442450944 Jan 29 11:59 overcloud-hardened-uefi-full.raw

8. 验证 director 是否已将内省 PXE 镜像复制到 /var/lib/ironic/httpboot ：

   (undercloud) [stack@director images]$ ls -l /var/lib/ironic/httpboot
   total 417296
   -rwxr-xr-x. 1 root  root    6639920 Jan 29 14:48 agent.kernel
   -rw-r--r--. 1 root  root  420656424 Jan 29 14:48 agent.ramdisk
   -rw-r--r--. 1 42422 42422       758 Jan 29 14:29 boot.ipxe
   -rw-r--r--. 1 42422 42422       488 Jan 29 14:16 inspector.ipxe

流程

1. 以 stack 用户的身份登录 undercloud。

2. Source stackrc 文件：

   [stack@director ~]$ source ~/stackrc

3. 安装 overcloud-minimal 软件包：

   (undercloud) [stack@director ~]$ sudo dnf install rhosp-director-images-minimal

4. 将镜像存档解包到 stack 用户主目录 (/home/stack/images) 中的 images 目录中：

   (undercloud) [stack@director ~]$ cd ~/images
   (undercloud) [stack@director images]$ tar xf /usr/share/rhosp-director-images/overcloud-minimal-latest-17.0.tar

5. 将镜像导入 director：

   (undercloud) [stack@director images]$ openstack overcloud image upload --image-path /home/stack/images/ --image-type os --os-image-name overcloud-minimal.qcow2

   该命令提供镜像上传进度状态的更新：

   Image "file:///var/lib/ironic/images/overcloud-minimal.vmlinuz" was copied.
   +---------------------------------------------------------+-------------------+----------+
   |                           Path                          |        Name       |   Size   |
   +---------------------------------------------------------+-------------------+----------+
   | file:///var/lib/ironic/images/overcloud-minimal.vmlinuz | overcloud-minimal | 11172880 |
   +---------------------------------------------------------+-------------------+----------+
   Image "file:///var/lib/ironic/images/overcloud-minimal.initrd" was copied.
   +--------------------------------------------------------+-------------------+----------+
   |                          Path                          |        Name       |   Size   |
   +--------------------------------------------------------+-------------------+----------+
   | file:///var/lib/ironic/images/overcloud-minimal.initrd | overcloud-minimal | 63575845 |
   +--------------------------------------------------------+-------------------+----------+
   Image "file:///var/lib/ironic/images/overcloud-minimal.raw" was copied.
   +-----------------------------------------------------+-------------------+------------+
   |                         Path                        |        Name       |    Size    |
   +-----------------------------------------------------+-------------------+------------+
   | file:///var/lib/ironic/images/overcloud-minimal.raw | overcloud-minimal | 2912878592 |
   +-----------------------------------------------------+-------------------+------------+

流程

1. 创建网络 YAML 定义文件：

   $ cp /usr/share/openstack-tripleo-heat-templates/network-data-samples/default-network-isolation-ipv6.yaml /home/stack/templates/network_data.yaml

2. 更新 network_data.yaml 文件中的选项，使其与 overcloud 网络环境的要求匹配：

   - name: Storage
     name_lower: storage
     vip: true
     ipv6: true
     mtu: 1500
     subnets:
       storage_subnet:
         ipv6_subnet: fd00:fd00:fd00:3000::/64
         ipv6_allocation_pools:
           - start: fd00:fd00:fd00:3000::10
             end: fd00:fd00:fd00:3000:ffff:ffff:ffff:fffe
         vlan: 30
   - name: StorageMgmt
     name_lower: storage_mgmt
     vip: true
     ipv6: true
     mtu: 1500
     subnets:
       storage_mgmt_subnet:
         ipv6_subnet: fd00:fd00:fd00:4000::/64
         ipv6_allocation_pools:
           - start: fd00:fd00:fd00:4000::10
             end: fd00:fd00:fd00:4000:ffff:ffff:ffff:fffe
         vlan: 40
   - name: InternalApi
     name_lower: internal_api
     vip: true
     ipv6: true
     mtu: 1500
     subnets:
       internal_api_subnet:
         ipv6_subnet: fd00:fd00:fd00:2000::/64
         ipv6_allocation_pools:
           - start: fd00:fd00:fd00:2000::10
             end: fd00:fd00:fd00:2000:ffff:ffff:ffff:fffe
         vlan: 20
   - name: Tenant
     name_lower: tenant
     vip: false # Tenant networks do not use VIPs
     ipv6: true
     mtu: 1500
     subnets:
       tenant_subnet:
         ipv6_subnet: fd00:fd00:fd00:5000::/64
         ipv6_allocation_pools:
           - start: fd00:fd00:fd00:5000::10
             end: fd00:fd00:fd00:5000:ffff:ffff:ffff:fffe
         vlan: 50
   - name: External
     name_lower: external
     vip: true
     ipv6: true
     mtu: 1500
     subnets:
       external_subnet:
         ipv6_subnet: 2001:db8:fd00:1000::/64
         ipv6_allocation_pools:
           - start: 2001:db8:fd00:1000::10
             end: 2001:db8:fd00:1000:ffff:ffff:ffff:fffe
         gateway_ipv6: 2001:db8:fd00:1000::1
         vlan: 10

流程

1. 列出可用的示例配置文件：

   $ ll /usr/share/openstack-tripleo-heat-templates/network-data-samples/
   -rw-r--r--. 1 root root 1554 May 11 23:04 default-network-isolation-ipv6.yaml
   -rw-r--r--. 1 root root 1181 May 11 23:04 default-network-isolation.yaml
   -rw-r--r--. 1 root root 1126 May 11 23:04 ganesha-ipv6.yaml
   -rw-r--r--. 1 root root 1100 May 11 23:04 ganesha.yaml
   -rw-r--r--. 1 root root 3556 May 11 23:04 legacy-routed-networks-ipv6.yaml
   -rw-r--r--. 1 root root 2929 May 11 23:04 legacy-routed-networks.yaml
   -rw-r--r--. 1 root root  383 May 11 23:04 management-ipv6.yaml
   -rw-r--r--. 1 root root  290 May 11 23:04 management.yaml
   -rw-r--r--. 1 root root  136 May 11 23:04 no-networks.yaml
   -rw-r--r--. 1 root root 2725 May 11 23:04 routed-networks-ipv6.yaml
   -rw-r--r--. 1 root root 2033 May 11 23:04 routed-networks.yaml
   -rw-r--r--. 1 root root  943 May 11 23:04 vip-data-default-network-isolation.yaml
   -rw-r--r--. 1 root root  848 May 11 23:04 vip-data-fixed-ip.yaml
   -rw-r--r--. 1 root root 1050 May 11 23:04 vip-data-routed-networks.yaml

2. 复制最适合您的需要的网络配置文件示例：

   $ cp /usr/share/openstack-tripleo-heat-templates/network-data-samples/default-network-isolation.yaml /home/stack/templates/network_data.yaml

3. 编辑 network_data.yaml 配置文件并为新网络添加一个部分：

   - name: StorageBackup
     vip: false
     name_lower: storage_backup
     subnets:
       storage_backup_subnet:
         ip_subnet: 172.16.6.0/24
         allocation_pools:
           - start: 172.16.6.4
           - end: 172.16.6.250
         gateway_ip: 172.16.6.1

   您可以在 network_data.yaml 文件中使用以下参数：

   name

   设置网络的名称。

   vip

   启用在网络中创建虚拟 IP 地址。

   name_lower

   设置名称的小写版本，director 映射到分配给 roles_data.yaml 文件中角色的相应网络。

   subnets

   一个或多个子网防御。

   subnet_name

   设置子网的名称。

   ip_subnet

   以 CIDR 格式设置 IPv4 子网。

   allocation_pools

   为 IPv4 子网设置 IP 范围。

   gateway_ip

   设置网络的网关。

   vlan

   设置网络的 VLAN ID。

   ipv6

   将值设为 true 或 false。

   ipv6_subnet

   设置 IPv6 子网。

   gateway_ipv6

   设置 IPv6 网络的网关。

   ipv6_allocation_pools

   为 IPv6 子网设置 IP 范围。

   routes_ipv6

   设置 IPv6 网络的路由。

4. 将所需的网络 VIP 定义模板示例从 /usr/share/openstack-tripleo-heat-templates/network-data-samples 复制到环境文件目录中。以下示例将 vip-data-default-network-isolation.yaml 复制到名为 vip_data.yaml 的本地环境文件：

   $ cp /usr/share/openstack-tripleo-heat-templates/network-data-samples/vip-data-default-network-isolation.yaml  /home/stack/templates/vip_data.yaml

5. 编辑 vip_data.yaml 配置文件。虚拟 IP 数据是虚拟 IP 地址定义列表，各自包含分配 IP 地址的网络名称。

   - network: storage_mgmt
     dns_name: overcloud
   - network: internal_api
     dns_name: overcloud
   - network: storage
     dns_name: overcloud
   - network: external
     dns_name: overcloud
     ip_address: <vip_address>
   - network: ctlplane
     dns_name: overcloud

   • 将 <vip_address > 替换为所需的虚拟 IP 地址。

   您可以在 vip_data.yaml 文件中使用以下参数：

   network

   设置 neutron 网络名称。这是唯一需要的参数。

   ip_address

   设置 VIP 的 IP 地址。

   子网

   设置 neutron 子网名称。在创建虚拟 IP neutron 端口时，用于指定子网。当部署使用路由网络时，需要此参数。

   dns_name

   设置 FQDN （完全限定域名）。

   name

   设置虚拟 IP 名称。

6. 复制示例网络配置模板。Jinja2 模板用于定义 NIC 配置模板。浏览 /usr/share/ansible/roles/tripleo_network_config/templates/ 目录中提供的示例（如果其中一个示例与您的要求匹配），请使用它。如果示例与您的要求不匹配，请复制示例配置文件并根据您的需要进行修改：

   $ cp /usr/share/ansible/roles/tripleo_network_config/templates/single_nic_vlans/single_nic_vlans.j2 /home/stack/templates/

7. 编辑 single_nic_vlans.j2 配置文件：

   ---
   {% 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 %}
   network_config:
   - type: ovs_bridge
     name: {{ neutron_physical_bridge_name }}
     mtu: {{ min_viable_mtu }}
     use_dhcp: false
     dns_servers: {{ ctlplane_dns_nameservers }}
     domain: {{ dns_search_domains }}
     addresses:
     - ip_netmask: {{ ctlplane_ip }}/{{ ctlplane_subnet_cidr }}
     routes: {{ ctlplane_host_routes }}
     members:
     - type: interface
       name: nic1
       mtu: {{ min_viable_mtu }}
       # force the MAC address of the bridge to this interface
       primary: true
   {% 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 %}

8. 在 overcloud-baremetal-deploy.yaml 配置文件中设置 network_config 模板：

   - name: CephStorage
     count: 3
     defaults:
       networks:
       - network: storage
       - network: storage_mgmt
       - network: storage_backup
       network_config:
         template: /home/stack/templates/single_nic_vlans.j2

9. 置备 overcloud 网络。此操作会生成一个输出文件，该文件将在部署 overcloud 时使用环境文件：

   (undercloud)$ openstack overcloud network provision --output <deployment_file> /home/stack/templates/<networks_definition_file>.yaml

   • 将 <networks_definition_file > 替换为网络定义文件的名称，如 network_data.yaml。
   • 将 <deployment_file > 替换为用于部署命令生成的 heat 环境文件名称，如 /home/stack/templates/overcloud-networks-deployed.yaml。

10. 置备网络 VIP，并生成 vip-deployed-environment.yaml 文件。在部署 overcloud 时，您可以使用此文件：

    (overcloud)$ openstack overcloud network vip provision  --stack <stack> --output <deployment_file> /home/stack/templates/vip_data.yaml

    • 将 & lt;stack > 替换为置备网络 VIP 的堆栈的名称。如果未指定，则默认为 overcloud。
    • 将 <deployment_file > 替换为用于部署命令生成的 heat 环境文件名称，如 /home/stack/templates/overcloud-vip-deployed.yaml。

流程

1. 如果您还没有自定义 roles_data.yaml 文件，请将默认值复制到您的主目录中：

   $ cp /usr/share/openstack-tripleo-heat-templates/roles_data.yaml /home/stack/templates/roles_data.yaml

2. 编辑自定义 roles_data.yaml 文件。

3. 将网络名称包含在您要添加 网络 的角色的网络列表中。例如，要将 StorageBackup 网络添加到 Ceph Storage 角色中，请使用以下示例片断：

   - name: CephStorage
     description: |
       Ceph OSD Storage node role
     networks:
       Storage
         subnet: storage_subnet
       StorageMgmt
         subnet: storage_mgmt_subnet
       StorageBackup
         subnet: storage_backup_subnet

4. 将自定义网络添加到其各自角色后，保存文件。

流程

1. 查找 stackrc undercloud 凭证文件：

   $ source ~/stackrc

2. 置备 overcloud 网络：

   $ openstack overcloud network provision \
     --output overcloud-networks-deployed.yaml \
     custom_network_data.yaml

3. 置备网络 VIP：

   $ openstack overcloud network vip provision \
       --stack overcloud \
       --output overcloud-networks-vips-deployed.yaml \
        custom_vip_data.yaml

4. 置备 overcloud 节点：

   $ openstack overcloud node provision \
       --stack overcloud \
       --output overcloud-baremetal-deployed.yaml \
       overcloud-baremetal-deploy.yaml

5. 构建 openstack overcloud deploy 命令，按所需顺序指定配置文件和模板，例如：

   $ openstack overcloud deploy --templates \
     --networks-file network_data_v2.yaml \
     -e overcloud-networks-deployed.yaml \
     -e overcloud-networks-vips-deployed.yaml \
     -e overcloud-baremetal-deployed.yaml
     -e custom-net-single-nic-with-vlans.yaml

流程

1. 在 network_data.yaml 文件中，为您要重命名的每个网络的 name_lower 参数输入新名称：

   - name: InternalApi
     name_lower: MyCustomInternalApi

2. 在 service_net_map_replace 参数中包含 name_lower 参数的默认值：

   - name: InternalApi
     name_lower: MyCustomInternalApi
     service_net_map_replace: internal_api

流程

1. 从 /home/stack/templates/custom-nics 目录在自定义 NIC 模板中创建 接口 条目，为接口定义路由，并定义与您的部署相关的规则：

     network_config:
     - type: interface
       name: em1
       use_dhcp: false
       addresses:
         - ip_netmask: {{ external_ip }}/{{ external_cidr}}
       routes:
         - default: true
           next_hop: {{ external_gateway_ip }}
         - ip_netmask: {{ external_ip }}/{{ external_cidr}}
           next_hop: {{ external_gateway_ip }}
           route_table: 2
           route_options: metric 100
       rules:
         - rule: "iif em1 table 200"
           comment: "Route incoming traffic to em1 with table 200"
         - rule: "from 192.0.2.0/24 table 200"
           comment: "Route all traffic from 192.0.2.0/24 with table 200"
         - rule: "add blackhole from 172.19.40.0/24 table 200"
         - rule: "add unreachable iif em1 from 192.168.1.0/24"

2. 在部署命令中包含自定义 NIC 配置和网络环境文件，以及与部署相关的任何其他环境文件：

   $ openstack overcloud deploy --templates \
   -e /home/stack/templates/<custom-nic-template>
   -e <OTHER_ENVIRONMENT_FILES>

流程

1. 在 ml2_conf.ini 的 [ovn] 部分中设置以下值：

   ovn_emit_need_to_frag = True

流程

1. 以 stack 用户身份登录 undercloud 主机。

2. 查找 undercloud 凭证文件：

   $ source ~/stackrc

3. 创建自定义 YAML 环境文件。

   示例

   $ vi /home/stack/templates/custom-environment.yaml

4. 您的环境文件必须包含 keywords parameter_defaults 和 ExtraSysctlSettings。为 netfilter 可在变量 net.nf_conntrack_max 中跟踪的最大连接数输入一个新值。

   示例

   在本例中，您可以在 RHOSP 部署中的所有主机上设置 conntrack 限制：

   parameter_defaults:
     ExtraSysctlSettings:
       net.nf_conntrack_max:
         value: 500000

   使用 & lt;role>Parameter 参数为特定角色设置 conntrack 限制：

   parameter_defaults:
     <role>Parameters:
       ExtraSysctlSettings:
         net.nf_conntrack_max:
           value: <simultaneous_connections>

   • 将 <role > 替换为角色的名称。

     例如，使用 ControllerParameters 为 Controller 角色设置 conntrack 限制，或 ComputeParameters 为 Compute 角色设置 conntrack 限制。

   • 将 < simultaneous_connections > 替换为您要同时允许的连接数量。

     示例

     在本例中，您只能为 RHOSP 部署中的 Controller 角色设置 conntrack 限制：

     parameter_defaults:
       ControllerParameters:
         ExtraSysctlSettings:
           net.nf_conntrack_max:
             value: 500000

     注意

     net.nf_conntrack_max 的默认值为 500000 连接。最大值为：429 496739）。

5. 运行部署命令，包括核心 heat 模板、环境文件和新的自定义环境文件。

   重要

   环境文件的顺序非常重要，因为后续环境文件中定义的参数和资源具有优先权。

   示例

   $ openstack overcloud deploy --templates \
   -e /home/stack/templates/custom-environment.yaml

流程

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 文件中配置 192.168.1.0/24 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 }}

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

     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 }}

   • 要编程配置每个网络，请在模板中添加 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 变量等效的映射的完整列表，请参阅 Heat 参数到 Ansible 变量映射。

4. 在 network-environment.yaml 文件中配置 192.168.1.0/24 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. 查找 stackrc undercloud 凭据文件：

   $ source ~/stackrc

2. 将所需的网络定义模板示例从 /usr/share/openstack-tripleo-heat-templates/network-data-samples 复制到环境文件目录中：

   (undercloud)$ cp /usr/share/openstack-tripleo-heat-templates/network-data-samples/default-network-isolation.yaml /home/stack/templates/network_data.yaml

3. 为您的网络环境配置网络定义文件。例如，您可以更新外部网络定义：

   - name: External
     name_lower: external
     vip: true
     mtu: 1500
     subnets:
       external_subnet:
         ip_subnet: 10.0.0.0/24
         allocation_pools:
           - start: 10.0.0.4
             end: 10.0.0.250
         gateway_ip: 10.0.0.1
         vlan: 10

4. 为您的环境配置任何其他网络和网络属性。有关您可以在网络定义文件中配置网络属性的属性的更多信息，请参阅配置 overcloud 网络。

5. 置备 overcloud 网络：

   (undercloud)$ openstack overcloud network provision \
    [--templates <templates_directory> \]
    --output  <deployment_file> \
    /home/stack/templates/<networks_definition_file>

   • 可选：包含 --templates 选项，以使用您自己的模板，而不是位于 /usr/share/openstack-tripleo-heat-templates 中的默认模板。将 <templates_directory > 替换为包含模板的目录的路径。
   • 将 <deployment_file > 替换为用于部署命令生成的 heat 环境文件名称，如 /home/stack/templates/overcloud-networks-deployed.yaml。
   • 将 <networks_definition_file > 替换为网络定义文件的名称，如 network_data.yaml。

6. 在网络置备完成后，您可以使用以下命令检查创建的网络和子网：

   (undercloud)$ openstack network list
   (undercloud)$ openstack subnet list
   (undercloud)$ openstack network show <network>
   (undercloud)$ openstack subnet show <subnet>

   • 将 <network > 替换为您要检查的网络的名称或 UUID。
   • 将 <subnet > 替换为您要检查的子网的名称或 UUID。

流程

1. 查找 stackrc undercloud 凭据文件：

   $ source ~/stackrc

2. 将所需的网络 VIP 定义模板示例从 /usr/share/openstack-tripleo-heat-templates/network-data-samples 复制到环境文件目录中：

   (undercloud)$ cp /usr/share/openstack-tripleo-heat-templates/network-data-samples/vip-data-default-network-isolation.yaml /home/stack/templates/vip_data.yaml

3. 可选：为环境配置 VIP 定义文件。例如，以下定义了外部网络和 control plane VIP：

   - network: external
     dns_name: overcloud
   - network: ctlplane
     dns_name: overcloud

4. 为环境配置任何其他网络 VIP 属性。有关您可以在 VIP 定义文件中配置 VIP 属性的属性的更多信息，请参阅 添加可组合网络。

5. 置备网络 VIP：

   (undercloud)$ openstack overcloud network vip provision \
    [--templates <templates_directory> \]
    --stack <stack> \
    --output <deployment_file> \
    /home/stack/templates/<vip_definition_file>

   • 可选：包含 --templates 选项，以使用您自己的模板，而不是位于 /usr/share/openstack-tripleo-heat-templates 中的默认模板。将 <templates_directory > 替换为包含模板的目录的路径。
   • 将 &lt;stack> 替换为置备网络 VIP 的堆栈的名称，如 overcloud。
   • 将 <deployment_file > 替换为用于部署命令生成的 heat 环境文件名称，如 /home/stack/templates/overcloud-vip-deployed.yaml。
   • 将 <vip_definition_file > 替换为 VIP 定义文件的名称，如 vip_data.yaml。

6. 当网络 VIP 置备完成后，您可以使用以下命令检查创建的 VIP：

   (undercloud)$ openstack port list
   (undercloud)$ openstack port show <port>

   • 将 <port > 替换为您要检查的端口的名称或 UUID。

流程

1. 创建名为 nodes.json 或 nodes.yaml 的模板，它将列出您的节点。使用以下 JSON 和 YAML 模板示例了解如何创建节点定义模板的结构：

   示例 JSON 模板

   {
     "nodes": [{
       "name": "node01",
       "ports": [{
         "address": "aa:aa:aa:aa:aa:aa",
         "physical_network": "ctlplane",
         "local_link_connection": {
           "switch_id": "52:54:00:00:00:00",
           "port_id": "p0"
         }
       }],
       "cpu": "4",
       "memory": "6144",
       "disk": "40",
       "arch": "x86_64",
       "pm_type": "ipmi",
       "pm_user": "admin",
       "pm_password": "p@55w0rd!",
       "pm_addr": "192.168.24.205"
     },
     {
       "name": "node02",
       "ports": [{
         "address": "bb:bb:bb:bb:bb:bb",
         "physical_network": "ctlplane",
         "local_link_connection": {
           "switch_id": "52:54:00:00:00:00",
           "port_id": "p0"
         }
       }],
       "cpu": "4",
       "memory": "6144",
       "disk": "40",
       "arch": "x86_64",
       "pm_type": "ipmi",
       "pm_user": "admin",
       "pm_password": "p@55w0rd!",
       "pm_addr": "192.168.24.206"
     }]
   }

   示例 YAML 模板

   nodes:
     - name: "node01"
       ports:
         - address: "aa:aa:aa:aa:aa:aa"
           physical_network: ctlplane
           local_link_connection:
             switch_id: 52:54:00:00:00:00
             port_id: p0
       cpu: 4
       memory: 6144
       disk: 40
       arch: "x86_64"
       pm_type: "ipmi"
       pm_user: "admin"
       pm_password: "p@55w0rd!"
       pm_addr: "192.168.24.205"
     - name: "node02"
       ports:
         - address: "bb:bb:bb:bb:bb:bb"
           physical_network: ctlplane
           local_link_connection:
             switch_id: 52:54:00:00:00:00
             port_id: p0
       cpu: 4
       memory: 6144
       disk: 40
       arch: "x86_64"
       pm_type: "ipmi"
       pm_user: "admin"
       pm_password: "p@55w0rd!"
       pm_addr: "192.168.24.206"

   此模板包含以下属性：

   name

   节点的逻辑名称。

   ports

   访问特定 IPMI 设备的端口。您可以定义以下可选端口属性：

   • 地址 ：节点上网络接口的 MAC 地址。对于每个系统的 Provisioning NIC，只使用 MAC 地址。
   • physical_network ：连接到 Provisioning NIC 的物理网络。
   • local_link_connection ：如果您使用 IPv6 置备，且 LLDP 在内省过程中没有正确填充本地链路连接，您必须在 local_link_connection 参数中包含带有 switch_id 和 port_id 字段的虚拟数据。有关如何包含虚拟数据的更多信息，请参阅使用 director 内省来收集裸机节点硬件信息。

   cpu

   节点上的 CPU 数量。（可选）

   memory

   以 MB 为单位的内存大小。（可选）

   disk

   以 GB 为单位的硬盘的大小。（可选）

   arch

   系统架构。 （可选）

   pm_type

   要使用的电源管理驱动程序。此示例使用 IPMI 驱动程序 (ipmi)。

   注意

   IPMI 是首选的受支持电源管理驱动程序。有关支持的电源管理类型及其选项的更多信息，请参阅 电源管理驱动程序。如果这些电源管理驱动程序不能正常工作，请将 IPMI 用于电源管理。

   pm_user; pm_password

   IPMI 的用户名和密码。

   pm_addr

   IPMI 设备的 IP 地址。

2. 验证模板格式和语法：

   $ source ~/stackrc
   (undercloud)$ openstack overcloud node import --validate-only ~/nodes.json

3. 将模板文件保存到 stack 用户的主目录(/home/stack/nodes.json)。

4. 将模板导入到 director，将每个节点从模板注册到 director：

   (undercloud)$ openstack overcloud node import ~/nodes.json

5. 等待节点完成注册和配置。完成后，确认 director 已成功注册节点：

   (undercloud)$ openstack baremetal node list