2.5. 检查角色参数
每个角色包含以下参数：
- name
-
（必需） 角色的名称，这是没有空格或特殊字符的纯文本名称。检查所选名称不会导致与其他资源冲突。例如，使用
Networker作为名称而不是Network。 - description
- （可选） 角色的纯文本描述。
- tags
（可选） 定义角色属性的标签的 YAML 列表。使用此参数定义主角色，带有
controller和primary标签：- name: Controller ... tags: - primary - controller ...
如果您没有标记主要角色，则您定义的第一个角色将成为主要角色。确保此角色是 Controller 角色。
- networks
要在角色上配置的网络的 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。-
对于 Controller、Object Storage 和 Ceph Storage 节点，默认为
- ServicesDefault
- （可选） 定义要在节点上包含的默认服务列表。更多信息请参阅 第 2.10 节 “检查可组合服务架构”。
您可以使用这些参数创建新角色，并定义角色中包含的服务。
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::Heat::ResourceGroup 资源。这会依次使用 roles_data 文件中的每个 name 参数来命名各个对应的 OS::Heat::ResourceGroup 资源。
