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

Mettez à jour la configuration du nom de domaine complet après l'installation d'Automation Suite sur EKS/AKS.

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

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 input.json .

Pour une installation d'Automation Suite dans un cluster partagé, le programme d'installation ne peut configurer automatiquement un nouveau certificat que s'il dispose de privilèges d'administrateur dans l'espace de noms <istio-system> .

Si le programme d'installation d'Automation Suite ne dispose pas de privilèges d'administrateur, vous devez suivre les instructions de la note à la fin de Configuration d'Istio et de l'installation du plug-in WASM pour le routage avant de passer aux étapes suivantes.

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.

Dans le fichier input.json , mettez à jour le paramètre fqdn avec le nouveau nom de domaine complet utilisé pour accéder au cluster.

L’exemple suivant vous indique la configuration input.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
}

Mise à jour du nom de domaine complet au niveau des composants et des services

Étape 1 : activation du mode de maintenance

Avant de déclencher la mise à jour du nom de domaine complet, 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 :

uipathctl cluster maintenance enable

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

uipathctl cluster maintenance is-enabled

Étape 2 : 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 :

uipathctl manifest apply input.json --versions versions.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 3 : 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 :

uipathctl cluster maintenance disable

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