Configuration du nom complet de domaine après l'installation

Référence pour la mise à jour du nom de domaine complet d'Automation Suite après l'installation via cluster_config.json et uipathctl.

Pour mettre à jour le nom de domaine complet d'Automation Suite, vous devez mettre à jour le fichier cluster_config.json et exécuter le programme d'installation uipathctl .

Le processus de mise à jour du nom de domaine complet s’applique à la fois au mode d’évaluation à nœud unique et au mode de production multi-nœuds compatible avec la haute disponibilité.

Remarque :

La modification du nom de domaine complet nécessite de nouveaux certificats serveur. Si un nouveau certificat n'est pas disponible, vous avez deux options : soit continuer avec le nouveau certificat auto-signé configuré automatiquement par le programme d'installation, soit arrêter l'installation et fournir un nouveau certificat émis par une autorité de certification publique.

Vous pouvez configurer le certificat via le champ server_certificate du fichier cluster_config.json .

Mise à jour du fichier de configuration avec la nouvelle valeur du nom de domaine complet

Remarque :

Nous prenons uniquement en charge les noms de domaine complets en minuscules. N’utilisez pas de majuscules dans votre nom de domaine complet.

Vous devez mettre à jour les paramètres suivants dans le fichier input.json . Toute combinaison de ces valeurs est autorisée, en fonction de vos besoins.

• fqdn : mettez à jour ce champ avec le nouveau nom de domaine complet dont vous avez besoin pour accéder au cluster.
• fixed_rke_address - si cette valeur est identique au champ fqdn dans cluster_config.json, vous devez vous assurer que les deux valeurs correspondent afin de refléter le nouveau nom de domaine complet. Dans le cas d’une configuration actif/passif ou actif/actif, cette valeur doit correspondre à cluster_fqdn.
• cluster_fqdn : mettez à jour ce champ pour le cluster actif/passif ou actif/actif.
  Remarque :

  La mise à jour cluster_fqdn est requise lorsque vous modifiez les configurations DNS au niveau de l'équilibreur de charge pour l'un des clusters

L’exemple suivant vous indique la configuration cluster_config.json requise pour mettre à jour le nom de domaine complet.

{
  "fqdn": "new-automationsuite.mycompany.com" //this is the fqdn for accessing the automation suite cluster
  "fixed_rke2_address": "new-automationsuite.mycompany.com,"//this is only required for the node joining, if customer wish to change "cluster_fqdn": "new-primary-automationsuite.mycompany.com" //this is only required for the a/p or a/a cluster
}

Étape 1 : mise à jour du nom de domaine complet au niveau de l’infrastructure

Pour mettre à jour le nom de domaine complet au niveau de l’infrastructure, exécutez le programme d’installation sur la première machine serveur uniquement. Cela mettra à jour tous les autres nœuds du cluster, y compris les nœuds de serveur restants, les nœuds d’agent et les nœuds d’agent spécialisés.

Pour mettre à jour le nom de domaine complet, exécutez la commande suivante :

./bin/uipathctl rke2 update-fqdn -i /path/to/cluster_config.json --versions versions/helm-charts.json

Remarque :

Si vous exécutez la commande avec l'indicateur --force , elle remplacera les invites d'avertissement et effectuera directement les modifications du nom de domaine complet.

Le programme d'installation vous avertit des conséquences de la mise à jour du nom de domaine complet. Il demande votre confirmation avant de continuer.

[WARN]  You are about to change the FQDN of the Automation Suite Cluster.
        Changing the fqdn is a disruptive operation, and it will result in 
        disconnecting your robots, mobile orchestrator users, ML Activities, 
        and ML Skills and invalidating any pending user invites. 
        
        If you wish to continue type 'yes' and hit enter to continue.

Étape 2 : activation du mode de maintenance

Avant de déclencher la mise à jour du nom de domaine complet au niveau des composants et des services, vous devez activer le mode de maintenance. Cela arrête le contrôleur d’entrée et tous les services UiPath®, bloquant ainsi tout le trafic entrant vers le cluster Automation Suite.

Pour mettre le cluster en mode maintenance, exécutez :

./bin/uipathctl cluster maintenance enable

Pour vérifier que le cluster est en mode maintenance, exécutez :

./bin/uipathctl cluster maintenance is-enabled

Étape 3 : Mise à jour du nom de domaine complet au niveau des composants et des services

Pour mettre à jour le nom de domaine complet, exécutez la commande suivante :

./bin/uipathctl manifest apply /path/to/cluster_config.json --versions versions/helm-charts.json

Remarque :

Si vous exécutez la commande avec l'indicateur --force , elle remplacera les invites d'avertissement et effectuera directement les modifications du nom de domaine complet.

Le programme d'installation vous avertit des conséquences de la mise à jour du nom de domaine complet. Il demande votre confirmation avant de continuer.

[WARN]  You are about to change the FQDN of the Automation Suite Cluster.
        Changing the fqdn is a disruptive operation, and it will result in 
        disconnecting your robots, mobile orchestrator users, ML Activities, 
        and ML Skills and invalidating any pending user invites. 
        If you wish to continue type 'yes' and hit enter to continue.

Le programme d’installation vous avertit également s’il n’y a pas de nouveau certificat valide lié au nom de domaine complet. Si la validation du certificat échoue, le programme d’installation vous demande de fournir le nouveau certificat émis par l’autorité de certification, ou bien de poursuivre avec le nouveau certificat auto-signé.

************************************************************************************
[ERROR] Validating certificate... Failed
[ERROR] Certificate doesn't have new-automationsuite.mycompany.com in the SAN
************************************************************************************

Certificate provided is invalid for the new fqdn, would you like us to configure the new self signed certificate?
If you wish to continue type `yes` and hit enter to continue.

Remarque :

Assurez-vous d'effacer toutes les données de votre base de données Redis. Vous pouvez le faire en exécutant la commande FLUSHALL.

Étape 4 : désactivation du mode de maintenance

Après avoir mis à jour le nom de domaine complet, désactivez le mode de maintenance pour restaurer le trafic vers le cluster Automation Suite.

Pour désactiver le mode maintenance, exécutez :

./bin/uipathctl cluster maintenance disable

Pour plus de détails, consultez la section uipathctl cluster maintenance disabled.

Mise à jour du nom de domaine complet dans un déploiement actif/actif

Si vous modifiez le nom de domaine complet du cluster principal dans une configuration actif/actif, vous devez effectuer les étapes supplémentaires suivantes :

1. Activez le mode maintenance sur le cluster principal :

   ./bin/uipathctl cluster maintenance enable
   

2. Générer un nouveau kubeconfig pour le cluster principal.

3. Ajoutez le nouveau fichier kubeconfig dans le cluster_config.json du cluster secondaire, sous other_kube_config.

4. Sur le cluster secondaire, exécutez la commande suivante :

   uipathctl manifest apply cluster_config.json --versions versions/helm-charts.json
   

5. Désactivez le mode maintenance sur le cluster principal :

   ./bin/uipathctl cluster maintenance disable
   

   Pour plus de détails, consultez la section uipathctl cluster maintenance disabled.