第 22 章 使用系统角色配置高可用性集群

布尔值标志（如果设为 yes ）决定主机上的 HA 集群将根据传递给角色的变量进行配置。角色中没有指定且不受角色支持的任何集群配置都将丢失。

如果 ha_cluster_cluster_present 设为 no，则将从目标主机中删除所有 HA 集群配置。

此变量的默认值为 yes。

以下示例 playbook 删除了 node1 和 node2 上的所有集群配置

- hosts: node1 node2
  vars:
    ha_cluster_cluster_present: no

  roles:
    - rhel-system-roles.ha_cluster

要安装的其他软件包列表。此变量的默认值是 no packages。

此变量可用于安装角色未自动安装的其他软件包，如自定义资源代理。

可以将隔离代理指定为这个列表的成员。但是，ha_cluster_fence_agent_packages 是用于指定隔离代理的推荐的角色变量，因此其默认值会被覆盖。

Corosync authkey 文件的路径，它是 Corosync 通信的身份验证和加密密钥。强烈建议您对每个集群都有一个唯一的 authkey 值。密钥应为 256 字节的随机数据。

如果为此变量指定一个密钥，则建议您使用 vault 加密密钥，如 使用 Ansible Vault 加密内容 中所述。

如果没有指定密钥，则使用节点上已存在的密钥。如果节点没有相同的密钥，则一个节点的密钥将被分发到其他节点，以便所有节点都有相同的密钥。如果节点都没有密钥，则将生成一个新的密钥，并将其分发到节点。

如果设置了此变量，则忽略这个密钥的 ha_cluster_regenerate_keys。

此变量的默认值为 null。

Pacemaker authkey 文件的路径，它是 Pacemaker 通信的身份验证和加密密钥。强烈建议您对每个集群都有一个唯一的 authkey 值。密钥应为 256 字节的随机数据。

如果为此变量指定一个密钥，则建议您使用 vault 加密密钥，如 使用 Ansible Vault 加密内容 中所述。

如果没有指定密钥，则使用节点上已存在的密钥。如果节点没有相同的密钥，则一个节点的密钥将被分发到其他节点，以便所有节点都有相同的密钥。如果节点都没有密钥，则将生成一个新的密钥，并将其分发到节点。

如果设置了此变量，则忽略这个密钥的 ha_cluster_regenerate_keys。

此变量的默认值为 null。

fence-virt 或 fence-xvm 预共享密钥文件的路径，它是 fence-virt 或 fence-xvm 隔离代理验证密钥的位置。

如果为此变量指定一个密钥，则建议您使用 vault 加密密钥，如 使用 Ansible Vault 加密内容 中所述。

如果没有指定密钥，则使用节点上已存在的密钥。如果节点没有相同的密钥，则一个节点的密钥将被分发到其他节点，以便所有节点都有相同的密钥。如果节点都没有密钥，则将生成一个新的密钥，并将其分发到节点。如果 ha_cluster 系统角色以这种方式生成新的密钥，您应该将密钥复制到节点的虚拟机监控程序，以确保隔离正常工作。

如果设置了此变量，则忽略这个密钥的 ha_cluster_regenerate_keys。

此变量的默认值为 null。

pcsd TLS 证书和私钥的路径。如果没有指定，则使用节点上已存在的证书密钥对。如果没有证书密钥对，则会生成一个随机的新密钥对。

如果为此变量指定了私钥值，则建议您使用 vault 加密密钥，如 使用 Ansible Vault 加密内容 中所述。

如果设置了这些变量，则将忽略此证书密钥对的 ha_cluster_regenerate_keys。

这些变量的默认值为 null。

布尔值标志，当设置为 yes 时，其决定将重新生成预共享密钥和 TLS 证书。有关何时重新生成密钥和证书的更多信息，请参阅 ha_cluster_corosync_key_src 、ha_cluster_pacemaker_key_src 、ha_cluster_fence_virt_key_src 、ha_cluster_pcsd_public_key_src 和 ha_cluster_pcsd_private_key_src 变量的描述。

此变量的默认值为 no。

配置使用 pcsd 管理集群的权限。您使用这个变量配置的项目如下：

ha_cluster_pcs_permission_list 变量的结构及其默认值如下：

ha_cluster_pcs_permission_list:
  - type: group
    name: hacluster
    allow_list:
      - grant
      - read
      - write

(RHEL 9.1 及更高版本) 设置集群传输方法。您使用这个变量配置的项目如下：

(RHEL 9.1 及更高版本) 配置 Corosync totem。有关允许的选项列表，请查看 pcs -h cluster setup 帮助页或 pcs(8) man page 的 cluster 部分中的 setup 描述。有关更详细的说明，请查看 corosync.conf(5) man page。

ha_cluster_totem 变量的结构如下：

ha_cluster_totem:
  options:
    - name: option1_name
      value: option1_value
    - name: option2_name
      value: option2_value

有关配置 Corosync totem 的 ha_cluster 系统角色 playbook 示例，请参阅在高可用性集群中配置 Corosync 值。

(RHEL 9.1 及更高版本) 配置集群仲裁。您可以配置 auto_tie_breaker、last_man_standing、last_man_standing_window 和 wait_for_all 仲裁选项。有关仲裁选项的详情，请查看 votequorum(5) man page。

ha_cluster_quorum 变量的结构如下：

ha_cluster_quorum:
  options:
    - name: option1_name
      value: option1_value
    - name: option2_name
      value: option2_value

有关配置集群仲裁的 ha_cluster 系统角色 playbook 的示例，请参阅在高可用性集群中配置 Corosync 值。

(RHEL 9.1 和更高版本) 一个布尔值标记，它决定集群是否可以使用 SBD 节点隔离机制。此变量的默认值为 no。

有关启用 SBD 的 ha_cluster 系统角色 playbook 示例，请参阅使用 SBD 节点隔离配置高可用性集群。

(RHEL 9.1 及更高版本) 指定 SBD 选项的 name-value 字典列表。支持的选项包括：

使用 SBD 时，您可以选择性地为清单中的每个节点配置 watchdog 和 SBD 设备。有关在清单文件中配置 watchdog 和 SBD 设备的详情，请参阅为 ha_cluster 系统角色指定清单。

Pacemaker 集群范围配置的集群属性集列表。仅支持一组集群属性。

一组集群属性的结构如下：

ha_cluster_cluster_properties:
  - attrs:
      - name: property1_name
        value: property1_value
      - name: property2_name
        value: property2_value

默认情况下，不设置任何属性。

以下示例 playbook 配置包含 node1 和 node2 的集群，并设置 stonith-enabled 和 no-quorum-policy 集群属性。

- hosts: node1 node2
  vars:
    ha_cluster_cluster_name: my-new-cluster
    ha_cluster_hacluster_password: password
    ha_cluster_cluster_properties:
      - attrs:
          - name: stonith-enabled
            value: 'true'
          - name: no-quorum-policy
            value: stop

  roles:
    - rhel-system-roles.ha_cluster

此变量定义由系统角色配置的 pacemaker 资源，包括 stonith 资源。您可以为每个资源配置的项目如下：

使用 ha_cluster 系统角色配置的资源定义的结构如下：

  - id: resource-id
    agent: resource-agent
    instance_attrs:
      - attrs:
          - name: attribute1_name
            value: attribute1_value
          - name: attribute2_name
            value: attribute2_value
    meta_attrs:
      - attrs:
          - name: meta_attribute1_name
            value: meta_attribute1_value
          - name: meta_attribute2_name
            value: meta_attribute2_value
    operations:
      - action: operation1-action
        attrs:
          - name: operation1_attribute1_name
            value: operation1_attribute1_value
          - name: operation1_attribute2_name
            value: operation1_attribute2_value
      - action: operation2-action
        attrs:
          - name: operation2_attribute1_name
            value: operation2_attribute1_value
          - name: operation2_attribute2_name
            value: operation2_attribute2_value

默认情况下不定义任何资源。

有关包含资源配置的 ha_cluster 系统角色 playbook 示例，请参阅 配置具有隔离和资源的高可用性集群

此变量定义由系统角色配置的 pacemaker 资源组。您可以为每个资源组配置的项目如下：

使用 ha_cluster 系统角色配置的资源组定义的结构如下：

ha_cluster_resource_groups:
  - id: group-id
    resource_ids:
      - resource1-id
      - resource2-id
    meta_attrs:
      - attrs:
          - name: group_meta_attribute1_name
            value: group_meta_attribute1_value
          - name: group_meta_attribute2_name
            value: group_meta_attribute2_value

默认情况下，不定义任何资源组。

有关包含资源组配置的 ha_cluster 系统角色 playbook 示例，请参阅 配置据有隔离和资源的高可用性集群

此变量定义由系统角色配置的 pacemaker 资源克隆。您可以为资源克隆配置的项目如下：

使用 ha_cluster 系统角色配置的资源克隆定义的结构如下。

ha_cluster_resource_clones:
  - resource_id: resource-to-be-cloned
    promotable: yes
    id: custom-clone-id
    meta_attrs:
      - attrs:
          - name: clone_meta_attribute1_name
            value: clone_meta_attribute1_value
          - name: clone_meta_attribute2_name
            value: clone_meta_attribute2_value

默认情况下，没有定义资源克隆。

有关包含资源克隆配置的 ha_cluster 系统角色 playbook 示例，请参阅 配置具有隔离和资源的高可用性集群

此变量定义资源位置限制。资源位置限制表示资源可在哪些节点上运行。您可以指定资源 ID 或模式匹配的资源，它们可以匹配多个资源。您可以通过节点名称或规则指定节点。

您可以为资源位置约束配置的项目如下：

默认情况下，没有定义资源位置限制。

指定资源 ID 和节点名称的资源位置约束的结构如下：

ha_cluster_constraints_location:
  - resource:
      id: resource-id
    node: node-name
    id: constraint-id
    options:
      - name: score
        value: score-value
      - name: option-name
        value: option-value

您为资源位置约束配置的项目，用于指定资源模式是为资源位置约束配置的相同项目，用于指定资源 ID，但资源规格本身除外。您为资源规格指定的项目如下：

指定资源模式和节点名称的资源位置约束结构如下：

ha_cluster_constraints_location:
  - resource:
      pattern: resource-pattern
    node: node-name
    id: constraint-id
    options:
      - name: score
        value: score-value
      - name: resource-discovery
        value: resource-discovery-value

您可以为资源位置约束配置的项目，它指定资源 ID 和规则如下：

指定资源 ID 和规则的资源位置约束的结构如下：

ha_cluster_constraints_location:
  - resource:
      id: resource-id
      role: resource-role
    rule: rule-string
    id: constraint-id
    options:
      - name: score
        value: score-value
      - name: resource-discovery
        value: resource-discovery-value

为资源位置约束配置的项目，用于指定资源模式，规则是用于资源位置约束的相同项目，用于指定资源 ID 和规则，但资源规格本身除外。您为资源规格指定的项目如下：

指定资源模式和规则的资源位置约束结构如下：

ha_cluster_constraints_location:
  - resource:
      pattern: resource-pattern
      role: resource-role
    rule: rule-string
    id: constraint-id
    options:
      - name: score
        value: score-value
      - name: resource-discovery
        value: resource-discovery-value

有关创建具有资源约束的集群的 ha_cluster 系统角色 playbook 示例，请参阅 配置具有资源约束的高可用性集群

此变量定义资源 colocation 约束。资源共存限制表示一个资源的位置取决于另一个资源的位置。存在两种类型的 colocation 约束：两个资源的一个简单 colocation 约束，并为多个资源设置 colocation 约束。

您可以为简单资源 colocation 约束配置的项目如下：

默认情况下，没有定义资源 colocation 约束。

简单资源 colocation 约束的结构如下：

ha_cluster_constraints_colocation:
  - resource_follower:
      id: resource-id1
      role: resource-role1
    resource_leader:
      id: resource-id2
      role: resource-role2
    id: constraint-id
    options:
      - name: score
        value: score-value
      - name: option-name
        value: option-value

您可以为资源集 colocation 约束配置的项目如下：

资源集 colocation 约束的结构如下：

ha_cluster_constraints_colocation:
  - resource_sets:
      - resource_ids:
          - resource-id1
          - resource-id2
        options:
          - name: option-name
            value: option-value
    id: constraint-id
    options:
      - name: score
        value: score-value
      - name: option-name
        value: option-value

有关创建具有资源约束的集群的 ha_cluster 系统角色 playbook 示例，请参阅 配置具有资源约束的高可用性集群

此变量定义资源顺序约束。资源顺序限制表示应发生某些资源操作的顺序。有两种资源顺序约束：两个资源的简单顺序约束，以及多个资源的设置顺序约束。

您可以为简单的资源顺序约束配置的项目如下：

默认情况下，没有定义资源顺序限制。

简单资源顺序约束的结构如下：

ha_cluster_constraints_order:
  - resource_first:
      id: resource-id1
      action: resource-action1
    resource_then:
      id: resource-id2
      action: resource-action2
    id: constraint-id
    options:
      - name: score
        value: score-value
      - name: option-name
        value: option-value

您可以为资源设置顺序约束配置的项目如下：

资源集顺序约束的结构如下：

ha_cluster_constraints_order:
  - resource_sets:
      - resource_ids:
          - resource-id1
          - resource-id2
        options:
          - name: option-name
            value: option-value
    id: constraint-id
    options:
      - name: score
        value: score-value
      - name: option-name
        value: option-value

有关创建具有资源约束的集群的 ha_cluster 系统角色 playbook 示例，请参阅 配置具有资源约束的高可用性集群

此变量定义资源 ticket 约束。资源票据限制表示依赖于特定票据的资源。有两种类型的资源 ticket 约束：一个资源的简单 ticket 约束，多个资源的 ticket 顺序约束。

您可以为简单资源 ticket 约束配置的项目如下：

默认情况下，没有定义资源 ticket 约束。

简单资源票据约束的结构如下：

ha_cluster_constraints_ticket:
  - resource:
      id: resource-id
      role: resource-role
    ticket: ticket-name
    id: constraint-id
    options:
      - name: loss-policy
        value: loss-policy-value
      - name: option-name
        value: option-value

您可以为资源设置 ticket 约束配置的项目如下：

资源集 ticket 约束的结构如下：

ha_cluster_constraints_ticket:
  - resource_sets:
      - resource_ids:
          - resource-id1
          - resource-id2
        options:
          - name: option-name
            value: option-value
    ticket: ticket-name
    id: constraint-id
    options:
      - name: option-name
        value: option-value

有关创建具有资源约束的集群的 ha_cluster 系统角色 playbook 示例，请参阅 配置具有资源约束的高可用性集群