Configuration de High Availability Add-on

Automation Suite prend en charge High Availability Add-on (HAA) installé dans le même cluster ou sur des machines externes.

Remarque :

Vous devez configurer HAA afin de pouvoir réellement activer la configuration haute disponibilité pour la configuration multi-nœuds. Pour ce faire, vous pouvez soit fournir la licence HAA au programme d’installation, soit installer HAA sur les machines externes, puis fournir les configurations HAA au programme d’installation.

Configuration de Redis High Availability Add-on dans le cluster

Dans une configuration en mode de production multi-nœuds compatible haute disponibilité, la haute disponibilité (HA) est activée par défaut. Cependant, le cache en mémoire basé sur Redis utilisé par les services de cluster s’exécute sur un seul nœud et représente un point de défaillance unique. Par conséquent, si vous n’avez pas acheté de licence High Availability Add-on (HAA), un échec ou un redémarrage d’un nœud de cache pourra entraîner des temps d’arrêt sur l’ensemble du cluster. Pour éviter un incident de ce type, vous pouvez acheter le module HAA, qui permet un déploiement redondant du cache en mode production multi-nœuds compatible haute disponibilité.

Remarque :

Toutes les installations incluent le logiciel HAA avec une licence à nœud unique. Cette licence est gratuite, aucun achat requis.

Si vous souhaitez activer le module complémentaire haute disponibilité (HAA) sur plusieurs nœuds, l'achat d'une licence HAA est nécessaire. Cela permettra de profiter d'une haute disponibilité complète pour le cluster dans une configuration en mode de production multi-nœuds compatible haute disponibilité.

HAA est basé sur la technologie Redis.

Pour ce faire, procédez comme suit :

1. Achetez une licence HAA. Contactez UiPath® pour plus de détails.
2. Mettez à jour les champs suivants dans le fichier cluster_config.json :
   • fabric.redis.license - saisissez la licence HAA convertie en une seule string base64. Vous devez encoder l'intégralité de la clé de licence en base64, y compris le texte -----LICENSE START----- and -----LICENSE END-----. En bash, vous pouvez le faire à l'aide de la commande suivante :

     echo '-----LICENSE START-----<license_key_here>-----LICENSE END-----' | base64 -w0

   • fabric.redis.ha - utilisez true pour activer HAA et assurez-vous de configurer également le paramètre fabric.redis.license. Cela active la réplication de la base de données HAA et augmente le nombre de pods HAA à 3. Par défaut, fabric.redis.ha est défini sur false.
     Remarque : Si redis.ha est activé, redis.license doit être défini sur une licence prenant en charge plus de deux partitions.

     "fabric": {
         "redis": { 
             "ha": "true",
             "license": "Base64String" // Replace Base64String with the encoded full license string.
         }
     }

3. Réexécutez le programme d'installation Fabric :

   ./install-uipath.sh -i cluster_config.json -f -o output.json --accept-license-agreement

Mise à jour de la licence Redis

Pour mettre à jour la licence Redis, procédez comme suit :

1. Configurez l'accès à kubectl et ArgoCD :
   1. Activez l'accès à kubectl sur le nœud principal. Référez-vous à Activation de kubectl (Enabling kubectl) pour davantage d'instructions.
   2. Activez l'accès à ArgoCD. Référez-vous à Accéder à ArgoCD (Accessing ArgoCD) pour davantage d'instructions.
2. Vérifiez le statut actuel de la licence :

   Pour vérifier l'état de la licence actuelle, exécutez la commande Shell suivante :

   kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq

   • Les clusters déployés après la date d'expiration de la licence incluse dans le programme d'installation afficheront la licence d'essai à 4 partitions expirant sous 30 jours, comme dans l'exemple suivant :

     
     

     

     
     
   • Les clusters qui étaient en cours d'exécution lors de l'expiration de la licence afficheront l'état suivant :

     
     

     

     
     
3. Mettez à jour la licence existante :
   1. Pour mettre à jour la licence existante, exécutez la commande Shell suivante :

      kubectl patch application fabric-installer -n argocd \
      --type=json -p '[{"op":"add","path":"/spec/source/helm/parameters/-","value":{"name": "global.redis.license", "value": "<LICENSE_KEY_IN_BASE64>"}}]'

      
      

      

      
      
   2. Pour voir si la modification a été appliquée, accédez à ArgoCD. Référez-vous à Accéder à ArgoCD (Accessing ArgoCD) pour davantage d'instructions.
   3. Si l'application fabric-installer ne semble pas synchronisée et que le processus de synchronisation ne s'est pas déclenché automatiquement, sélectionnez vous-même le bouton Synchroniser (Sync) . Cela peut se produire si vous utilisez une ancienne version d'Automation Suite.
      
      

      

      
      

      
      

      

      
      

      
      

      

      
      

      Remarque : Il y a un petit délai entre le moment où l'interface utilisateur ArgoCD affiche l'application synchronisée et le moment où l'opérateur Redis applique avec succès la nouvelle licence.
   4. Pour afficher les journaux de l'opérateur Redis lorsque celui-ci tente d'appliquer la licence, exécutez la commande suivante :

      kubectl logs -n redis-system --since=300s -l name=redis-enterprise-operator -c redis-enterprise-operator --tail=-1 | grep license

      
      

      

      
      
   5. Si vous essayez d'appliquer une licence expirée ou que vous exécutez le programme d'installation fourni avec une licence expirée, vous obtiendrez le résultat suivant :
      
      

      

      
      
   6. Pour mettre à jour la licence Redis utilisée par les anciens programmes d'installation avant d'exécuter ces derniers, mettez à jour la clé fabric.redis.license dans le dossier <installer_folder>/defaults.json :
      
      

      

      
      
4. Vérifiez que la nouvelle licence est appliquée :

   Pour vérifier si la nouvelle licence est appliquée, exécutez la commande Shell suivante :

   kubectl get rec -n redis-system redis-cluster -o jsonpath='{.status.licenseStatus}' | jq

   Sur l'image suivante, vous pouvez voir que le cluster Redis est passé de la licence d'essai de 30 jours à une licence à partition unique de 10 ans.

   
   

   

   
   

Configuration externe de High Availability Add-on

Lorsque vous optez pour une configuration actif/actif d’Automation Suite, il est nécessaire de disposer d’une version de High Availability Add-on hébergée dans un cluster externe. Dans toutes les autres situations, celle-ci est simplement facultative.

Pour configurer le module complémentaire High Availability Add-on, vous devez mettre à jour les paramètres suivants dans le fichier cluster_config.json :

Paramètre	Description
fabric.redis.hostname	Fournissez le nom de domaine complet du serveur de High Availability Add-on (HAA).
fabric.redis.password	Fournissez le mot de passe permettant de vous connecter au serveur de HAA.
fabric.redis.port	Fournissez le port du serveur de HAA.
fabric.redis.tls	Activez le protocole TLS. Celui-ci est activé par défaut. Remarque : Si un certificat est requis lorsque TLS est activé, veillez à bien le fournir via l’indicateur additional_ca_certs. Pour plus de détails, consultez la section Configuration du certificat.

"fabric": {
  "redis": {
    "hostname": "redis_fqdn",
    "password": "credential_to_connect_redis",
    "port": 6380,
    "tls": true,
  }
}