Chapitre 24. Configuration d'un cluster à haute disponibilité à l'aide du rôle de système RHEL ha_cluster

(RHEL 9.2 et versions ultérieures) Indicateur booléen qui détermine si le rôle système ha_cluster gère le pare-feu. Lorsque ha_cluster_manage_firewall vaut true, le service de haute disponibilité du pare-feu et le port fence-virt sont activés. Lorsque ha_cluster_manage_firewall a pour valeur false, le rôle système ha_cluster ne gère pas le pare-feu. Si votre système exécute le service firewalld, vous devez définir le paramètre sur true dans votre playbook.

Vous pouvez utiliser le paramètre ha_cluster_manage_firewall pour ajouter des ports, mais vous ne pouvez pas l'utiliser pour en supprimer. Pour supprimer des ports, utilisez directement le rôle de système firewall.

Depuis RHEL 9.2, le pare-feu n'est plus configuré par défaut, car il n'est configuré que lorsque ha_cluster_manage_firewall est défini sur true.

(RHEL 9.2 et versions ultérieures) Indicateur booléen qui détermine si le rôle système ha_cluster gère les ports appartenant au service de haute disponibilité du pare-feu à l'aide du rôle système selinux. Lorsque ha_cluster_manage_selinux a la valeur true, les ports appartenant au service de haute disponibilité du pare-feu sont associés au type de port SELinux cluster_port_t. Lorsque ha_cluster_manage_selinux est défini sur false, le rôle système ha_cluster ne gère pas SELinux.

Si votre système exécute le service selinux, vous devez définir ce paramètre sur true dans votre playbook. La configuration du pare-feu est une condition préalable à la gestion de SELinux. Si le pare-feu n'est pas installé, la politique de gestion de SELinux est ignorée.

Vous pouvez utiliser le paramètre ha_cluster_manage_selinux pour ajouter une stratégie, mais vous ne pouvez pas l'utiliser pour la supprimer. Pour supprimer une stratégie, utilisez directement le rôle de système selinux.

Un drapeau booléen qui, s'il vaut true, détermine que le cluster HA sera configuré sur les hôtes selon les variables passées au rôle. Toute configuration de cluster non spécifiée dans le rôle et non supportée par le rôle sera perdue.

Si ha_cluster_cluster_present est défini sur false, toute la configuration du cluster HA sera supprimée des hôtes cibles.

La valeur par défaut de cette variable est true.

L'exemple suivant supprime toute la configuration du cluster sur node1 et node2

- hosts: node1 node2
  vars:
    ha_cluster_cluster_present: false

  roles:
    - rhel-system-roles.ha_cluster

Liste des paquets supplémentaires à installer. La valeur par défaut de cette variable est aucun paquet.

Cette variable peut être utilisée pour installer des paquets supplémentaires qui ne sont pas installés automatiquement par le rôle, par exemple des agents de ressources personnalisés.

Il est possible de spécifier des agents de clôture comme membres de cette liste. Toutefois, ha_cluster_fence_agent_packages est la variable de rôle qu'il est recommandé d'utiliser pour spécifier les agents de clôture, de sorte que sa valeur par défaut est remplacée.

Le chemin d'accès au fichier Corosync authkey, qui est la clé d'authentification et de cryptage pour la communication Corosync. Il est fortement recommandé d'avoir une valeur authkey unique pour chaque cluster. La clé doit être composée de 256 octets de données aléatoires.

Si vous spécifiez une clé pour cette variable, il est recommandé de chiffrer la clé dans la chambre forte, comme décrit dans Chiffrer le contenu avec Ansible Vault.

Si aucune clé n'est spécifiée, une clé déjà présente sur les nœuds sera utilisée. Si les nœuds n'ont pas la même clé, une clé d'un nœud sera distribuée aux autres nœuds afin que tous les nœuds aient la même clé. Si aucun nœud ne possède de clé, une nouvelle clé sera générée et distribuée aux nœuds.

Si cette variable est définie, ha_cluster_regenerate_keys est ignoré pour cette touche.

La valeur par défaut de cette variable est null.

Le chemin d'accès au fichier Pacemaker authkey, qui est la clé d'authentification et de cryptage pour la communication Pacemaker. Il est fortement recommandé d'avoir une valeur authkey unique pour chaque cluster. La clé doit être constituée de 256 octets de données aléatoires.

Si vous spécifiez une clé pour cette variable, il est recommandé de chiffrer la clé dans la chambre forte, comme décrit dans Chiffrer le contenu avec Ansible Vault.

Si aucune clé n'est spécifiée, une clé déjà présente sur les nœuds sera utilisée. Si les nœuds n'ont pas la même clé, une clé d'un nœud sera distribuée aux autres nœuds afin que tous les nœuds aient la même clé. Si aucun nœud ne possède de clé, une nouvelle clé sera générée et distribuée aux nœuds.

Si cette variable est définie, ha_cluster_regenerate_keys est ignoré pour cette touche.

La valeur par défaut de cette variable est null.

Chemin d'accès au fichier de clé prépartagée fence-virt ou fence-xvm, qui est l'emplacement de la clé d'authentification pour l'agent de clôture fence-virt ou fence-xvm.

Si vous spécifiez une clé pour cette variable, il est recommandé de chiffrer la clé dans la chambre forte, comme décrit dans Chiffrer le contenu avec Ansible Vault.

Si aucune clé n'est spécifiée, une clé déjà présente sur les nœuds sera utilisée. Si les nœuds n'ont pas la même clé, une clé d'un nœud sera distribuée aux autres nœuds afin que tous les nœuds aient la même clé. Si aucun nœud ne possède de clé, une nouvelle clé est générée et distribuée aux nœuds. Si le rôle de système ha_cluster génère une nouvelle clé de cette manière, vous devez copier la clé dans l'hyperviseur de vos nœuds afin de garantir le bon fonctionnement de la clôture.

Si cette variable est définie, ha_cluster_regenerate_keys est ignoré pour cette touche.

La valeur par défaut de cette variable est null.

Le chemin d'accès au certificat TLS et à la clé privée de pcsd. Si ce chemin n'est pas spécifié, une paire certificat-clé déjà présente sur les nœuds sera utilisée. Si ce n'est pas le cas, une nouvelle paire de clés sera générée de manière aléatoire.

Si vous spécifiez une valeur de clé privée pour cette variable, il est recommandé de chiffrer la clé dans la chambre forte, comme décrit dans Chiffrer le contenu avec Ansible Vault.

Si ces variables sont définies, ha_cluster_regenerate_keys est ignoré pour cette paire certificat-clé.

La valeur par défaut de ces variables est null.

(RHEL 9.2 et versions ultérieures) Crée une clé privée et un certificat pcsd à l'aide du rôle système certificate.

Si votre système n'est pas configuré avec une clé privée et un certificat pcsd, vous pouvez les créer de deux manières :

Les considérations opérationnelles suivantes s'appliquent à l'utilisation de la variable ha_cluster_pcsd_certificate:

La valeur par défaut de cette variable est [].

Pour un exemple de playbook ha_cluster System Role qui crée des certificats TLS et des fichiers clés dans un cluster à haute disponibilité, voir Création de certificats TLS pcsd et de fichiers clés pour un cluster à haute disponibilité.

Configure les permissions pour gérer un cluster en utilisant pcsd. Les éléments que vous configurez avec cette variable sont les suivants :

La structure de la variable ha_cluster_pcs_permission_list et ses valeurs par défaut sont les suivantes :

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

(RHEL 9.1 et ultérieur) Définit la méthode de transport du cluster. Les éléments que vous configurez avec cette variable sont les suivants :

(RHEL 9.1 et ultérieur) Configure le totem Corosync. Pour une liste des options autorisées, voir la page d'aide pcs -h cluster setup ou la description setup dans la section cluster de la page de manuel pcs(8). Pour une description plus détaillée, voir la page de manuel corosync.conf(5).

La structure de la variable ha_cluster_totem est la suivante :

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

Pour un exemple de playbook ha_cluster System Role qui configure un totem Corosync, voir Configuration des valeurs Corosync dans un cluster à haute disponibilité.

(RHEL 9.1 et versions ultérieures) Configure le quorum du cluster. Vous pouvez configurer les éléments suivants pour le quorum de cluster :

La structure de la variable ha_cluster_quorum est la suivante :

ha_cluster_quorum:
  options:
    - name: option1_name
      value: option1_value
    - name: option2_name
      value: option2_value
  device:
    model: string
    model_options:
      - name: option1_name
        value: option1_value
      - name: option2_name
        value: option2_value
    generic_options:
      - name: option1_name
        value: option1_value
      - name: option2_name
        value: option2_value
    heuristics_options:
      - name: option1_name
        value: option1_value
      - name: option2_name
        value: option2_value

Pour un exemple ha_cluster System Role playbook qui configure le quorum du cluster, voir Configuration des valeurs Corosync dans un cluster à haute disponibilité. Pour un exemple de manuel de rôle système ha_cluster qui configure un cluster à l'aide d'un dispositif de quorum, voir Configuration d'un cluster haute disponibilité à l'aide d'un dispositif de quorum.

(RHEL 9.1 et versions ultérieures) Indicateur booléen qui détermine si le cluster peut utiliser le mécanisme de clôture des nœuds SBD. La valeur par défaut de cette variable est false.

Pour un exemple de playbook de rôle de système ha_cluster qui active le SBD, voir Configuration d'un cluster à haute disponibilité avec des clôtures de nœuds SBD.

(RHEL 9.1 et versions ultérieures) Liste de dictionnaires nom-valeur spécifiant les options SBD. Les options prises en charge sont les suivantes :

Pour un exemple de playbook ha_cluster System Role qui configure les options SBD, voir Configuration d'un cluster à haute disponibilité avec des clôtures de nœuds SBD.

Lorsque vous utilisez le SBD, vous pouvez éventuellement configurer des dispositifs de chien de garde et de SBD pour chaque nœud d'un inventaire. Pour plus d'informations sur la configuration des dispositifs de surveillance et de SBD dans un fichier d'inventaire, voir Spécification d'un inventaire pour le rôle de système ha_cluster.

Liste des ensembles de propriétés de cluster pour la configuration de Pacemaker à l'échelle du cluster. Un seul ensemble de propriétés de cluster est pris en charge.

La structure d'un ensemble de propriétés de grappes est la suivante :

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

Par défaut, aucune propriété n'est définie.

L'exemple suivant configure un cluster composé de node1 et node2 et définit les propriétés des clusters stonith-enabled et 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

Cette variable définit les ressources du pacemaker configurées par le rôle système, y compris les ressources stonith, y compris les ressources stonith. Vous pouvez configurer les éléments suivants pour chaque ressource :

La structure de la définition des ressources que vous configurez avec le rôle de système ha_cluster est la suivante.

  - 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

Par défaut, aucune ressource n'est définie.

Pour un exemple de playbook ha_cluster System Role qui inclut la configuration des ressources, voir Configuration d'un cluster à haute disponibilité avec des clôtures et des ressources.

Cette variable définit les groupes de ressources de pacemaker configurés par le rôle de système. Vous pouvez configurer les éléments suivants pour chaque groupe de ressources :

La structure de la définition du groupe de ressources que vous configurez avec le rôle de système ha_cluster est la suivante.

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

Par défaut, aucun groupe de ressources n'est défini.

Pour un exemple de playbook ha_cluster System Role qui inclut la configuration des groupes de ressources, voir Configuration d'un cluster à haute disponibilité avec des clôtures et des ressources.

Cette variable définit les clones de ressources de pacemaker configurés par le rôle de système. Vous pouvez configurer les éléments suivants pour un clone de ressources :

La structure de la définition du clone de ressources que vous configurez avec le rôle de système ha_cluster est la suivante.

ha_cluster_resource_clones:
  - resource_id: resource-to-be-cloned
    promotable: true
    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

Par défaut, aucun clone de ressources n'est défini.

Pour un exemple de playbook ha_cluster System Role qui inclut la configuration des clones de ressources, voir Configuration d'un cluster à haute disponibilité avec des clôtures et des ressources.

Cette variable définit les contraintes de localisation des ressources. Les contraintes d'emplacement des ressources indiquent les nœuds sur lesquels une ressource peut s'exécuter. Vous pouvez spécifier une ressource par un identifiant de ressource ou par un modèle, qui peut correspondre à plusieurs ressources. Vous pouvez spécifier un nœud par un nom de nœud ou par une règle.

Vous pouvez configurer les éléments suivants pour une contrainte de localisation des ressources :

Par défaut, aucune contrainte de localisation des ressources n'est définie.

La structure d'une contrainte de localisation de ressource spécifiant un identifiant de ressource et un nom de nœud est la suivante :

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

Les éléments que vous configurez pour une contrainte d'emplacement de ressource qui spécifie un modèle de ressource sont les mêmes que ceux que vous configurez pour une contrainte d'emplacement de ressource qui spécifie un identifiant de ressource, à l'exception de la spécification de ressource elle-même. L'élément que vous spécifiez pour la spécification de ressource est le suivant :

La structure d'une contrainte d'emplacement de ressource spécifiant un modèle de ressource et un nom de nœud est la suivante :

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

Vous pouvez configurer les éléments suivants pour une contrainte d'emplacement de ressource qui spécifie un identifiant de ressource et une règle :

La structure d'une contrainte de localisation des ressources qui spécifie un identifiant de ressource et une règle est la suivante :

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

Les éléments que vous configurez pour une contrainte d'emplacement de ressource qui spécifie un modèle de ressource et une règle sont les mêmes que ceux que vous configurez pour une contrainte d'emplacement de ressource qui spécifie un identifiant de ressource et une règle, à l'exception de la spécification de ressource elle-même. L'élément que vous spécifiez pour la spécification de ressource est le suivant :

La structure d'une contrainte de localisation des ressources qui spécifie un modèle de ressource et une règle est la suivante :

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

Pour un exemple de playbook de rôle système ha_cluster qui crée un cluster avec des contraintes de ressources, voir Configuration d'un cluster de haute disponibilité avec des contraintes de ressources.

Cette variable définit les contraintes de colocalisation des ressources. Les contraintes de colocalisation des ressources indiquent que l'emplacement d'une ressource dépend de l'emplacement d'une autre ressource. Il existe deux types de contraintes de colocalisation : une contrainte de colocalisation simple pour deux ressources et une contrainte de colocalisation définie pour plusieurs ressources.

Vous pouvez configurer les éléments suivants pour une contrainte simple de colocation des ressources :

Par défaut, aucune contrainte de colocation des ressources n'est définie.

La structure d'une contrainte simple de colocation des ressources est la suivante :

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

Vous pouvez configurer les éléments suivants pour une contrainte de colocalisation d'un ensemble de ressources :

La structure d'une contrainte de colocalisation d'un ensemble de ressources est la suivante :

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

Pour un exemple de playbook de rôle système ha_cluster qui crée un cluster avec des contraintes de ressources, voir Configuration d'un cluster de haute disponibilité avec des contraintes de ressources.

Cette variable définit les contraintes d'ordre des ressources. Les contraintes d'ordre des ressources indiquent l'ordre dans lequel certaines actions des ressources doivent se produire. Il existe deux types de contraintes d'ordre pour les ressources : une contrainte d'ordre simple pour deux ressources et une contrainte d'ordre défini pour plusieurs ressources.

Vous pouvez configurer les éléments suivants pour une contrainte d'ordre de ressources simple :

Par défaut, aucune contrainte d'ordre de ressources n'est définie.

La structure d'une simple contrainte d'ordre de ressources est la suivante :

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

Vous pouvez configurer les éléments suivants pour une contrainte de commande d'ensemble de ressources :

La structure d'une contrainte de commande d'un ensemble de ressources est la suivante :

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

Pour un exemple de playbook de rôle système ha_cluster qui crée un cluster avec des contraintes de ressources, voir Configuration d'un cluster de haute disponibilité avec des contraintes de ressources.

Cette variable définit les contraintes des tickets de ressources. Les contraintes de ticket de ressource indiquent les ressources qui dépendent d'un certain ticket. Il existe deux types de contraintes de ticket de ressource : une contrainte de ticket simple pour une ressource et une contrainte d'ordre de ticket pour plusieurs ressources.

Vous pouvez configurer les éléments suivants pour une simple contrainte de ticket de ressource :

Par défaut, aucune contrainte de ticket de ressource n'est définie.

La structure d'une simple contrainte de ticket de ressources est la suivante :

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

Vous pouvez configurer les éléments suivants pour une contrainte de ticket d'ensemble de ressources :

La structure d'une contrainte de ticket d'ensemble de ressources est la suivante :

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

Pour un exemple de playbook de rôle système ha_cluster qui crée un cluster avec des contraintes de ressources, voir Configuration d'un cluster de haute disponibilité avec des contraintes de ressources.

(RHEL 9.1 et versions ultérieures) Cette variable configure un hôte qnetd qui peut ensuite servir de périphérique quorum externe pour les clusters.

Vous pouvez configurer les éléments suivants pour un hôte qnetd:

Vous ne pouvez pas exécuter qnetd sur un nœud de cluster car la clôture perturberait le fonctionnement de qnetd.

Pour un exemple de playbook ha_cluster System Role qui configure un cluster à l'aide d'un dispositif de quorum, voir Configuration d'un cluster à l'aide d'un dispositif de quorum.