Activation du module complémentaire Redis High Availability Add-on pour 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. En bash, vous pouvez le faire en utilisant echo 'license_text_here' | 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
         }
     }

3. Réexécutez le programme d'installation Fabric :
   • Installation en ligne

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

   • Installation hors ligne

     ./install-uipath.sh -i cluster_config.json -f --install-type offline -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, cliquez vous-même sur 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.