6.5. 检查角色参数

每个角色都包含以下参数：

name
（必需） 角色的名称，这是没有空格或特殊字符的纯文本名称。检查所选名称不会导致与其他资源冲突。例如，使用 Networker 作为名称而不是 Network。
description
（可选） 角色的纯文本描述。
tags

（可选） 定义角色属性的标签的 YAML 列表。使用此参数定义主角色，带有 controller 和 primary 标签： 

- name: Controller
  ...
  tags:
    - primary
    - controller
  ...
重要

如果没有标记主角色，您定义的第一个角色将变为主角色。确保此角色是 Controller 角色。

网络

您要在角色上配置的网络的 YAML 列表或字典。如果使用 YAML 列表，请列出每个可组合网络： 

  networks:
    - External
    - InternalApi
    - Storage
    - StorageMgmt
    - Tenant

如果您使用一个字典，请将每个网络映射到可组合网络中的一个特定的子网。 

  networks:
    External:
      subnet: external_subnet
    InternalApi:
      subnet: internal_api_subnet
    Storage:
      subnet: storage_subnet
    StorageMgmt:
      subnet: storage_mgmt_subnet
    Tenant:
      subnet: tenant_subnet

默认网络包括 External, InternalApi, Storage, StorageMgmt, Tenant, 和 Management。

CountDefault
（可选） 定义要为此角色部署的默认节点数。
HostnameFormatDefault

（可选） 定义角色的默认主机名格式。默认命名约定使用以下格式： 

[STACK NAME]-[ROLE NAME]-[NODE ID]

例如，默认 Controller 节点被命名为： 

overcloud-controller-0
overcloud-controller-1
overcloud-controller-2
...
disable_constraints
（可选） 定义在使用 director 部署时是否禁用 OpenStack Compute (nova)和 OpenStack Image Storage (glance)约束。当您使用预置备节点部署 overcloud 时，请使用此参数。有关更多信息，请参阅 Director 安装和使用指南中的 使用预置备节点配置 基本 Overcloud。
update_serial

（可选） 定义 OpenStack 更新选项期间要同时更新的节点数量。在默认的 roles_data.yaml 文件中：

  • Controller、Object Storage 和 Ceph Storage 节点的默认值为 1。
  • Compute 和 Block Storage 节点的默认值为 25。

如果您从自定义角色中省略此参数，则默认为 1。

ServicesDefault
（可选） 定义要包含在节点上的默认服务列表。更多信息请参阅 第 6.8 节 “检查可组合服务架构”。

您可以使用这些参数创建新角色，并定义要包含在角色中的服务。

openstack overcloud deploy 命令将 roles_data 文件中的参数集成到一些基于 Jinja2 的模板中。例如，在某些时候，overcloud.j2.yaml heat 模板会迭代 roles_data.yaml 中的角色列表，并创建特定于每个相应角色的参数和资源。

例如，以下片段包含 overcloud.j2.yaml heat 模板中各个角色的资源定义： 

  {{role.name}}:
    type: OS::Heat::ResourceGroup
    depends_on: Networks
    properties:
      count: {get_param: {{role.name}}Count}
      removal_policies: {get_param: {{role.name}}RemovalPolicies}
      resource_def:
        type: OS::TripleO::{{role.name}}
        properties:
          CloudDomain: {get_param: CloudDomain}
          ServiceNetMap: {get_attr: [ServiceNetMap, service_net_map]}
          EndpointMap: {get_attr: [EndpointMap, endpoint_map]}
...

此片段演示基于 Jinja2 的模板如何纳入 {{role.name}} 变量，以将每个角色的名称定义为 OS::114::ResourceGroup 资源。这依次使用 roles_data 文件中的每个 name 参数来命名每个对应的 OS::114::ResourceGroup 资源。