Mettre à niveau Automation Suite

Effectuer des mises à niveau de version majeure et mineure d’Automation Suite sur EKS/AKS.

Automation Suite se compose de plusieurs composants. En tant que client, vous partagez avec UiPath® la responsabilité de ces composants. Pour de plus amples informations, consultez la section Matrice de responsabilité.

Vous êtes responsable de la mise à niveau :

• Infrastructure Kubernetes où Automation Suite est déployée (AKS ou EKS)
• Les composants que vous choisissez d'apporter dans le cadre d'Automation Suite (par ex., Gatekeeper, FluentD, etc.)

UiPath® est responsable de la mise à niveau des éléments suivants :

• Services UiPath® (Orchestrator, par exemple)
• Composants déployés dans le cadre d' Automation Suite (par exemple, ArgoCD)

Mise à niveau des services et des composants UiPath®

Préparation

Remarque :

• Si vous effectuez une mise à niveau vers Automation Suite 2.2510, vous devez apporter une base de données PostgreSQL pour AutomationSuite_Airflow et configurer la chaîne de connexion correspondante dans input.json Pour des détails, reportez-vous à Configuration spécifique à Process Mining.
• Si vous effectuez une mise à niveau à partir des versions antérieures à la version 2.2510.0 à l’aide de Studio Web, assurez-vous d’utiliser le même nom de classe de stockage que celui spécifié dans storage_class_single_replica pour prendre en charge le mode d’accès RWX. Pour plus de détails, consultez la section Configuration de input.json.

En outre, consultez les conseils de maintenance de la base de données suivants avant de lancer la mise à niveau.

Important :

Les tables de base de données Automation Suite très volumineuses peuvent entraîner beaucoup plus de temps ou ne pas se terminer lors de la mise à niveau. Le fait de bien gérer les tables de base de données réduit ce risque.

Nous vous recommandons d’archiver ou de supprimer les données qui ne sont plus nécessaires dans les tables à volume élevé avant de démarrer la mise à niveau; pour de plus amples informations, consultez la section Effectuer la maintenance de la base de données.

Pour préparer la mise à niveau, procédez comme suit :

1. Vérifiez la matrice de compatibilité pour déterminer les versions prises en charge pour chaque scénario de mise à niveau disponible. Si vous avez apporté vos propres composants, assurez-vous que les versions de vos composants sont compatibles avec la version vers laquelle vous prévoyez d'effectuer la mise à niveau. Pour plus de détails, consultez la section Matrice de compatibilité.

2. Téléchargez versions.json et uipathctl pour la version vers laquelle vous souhaitez effectuer la mise à niveau sur votre machine de gestion. Pour obtenir des instructions, consultez la section Téléchargement des packages d’installation.

3. Générez le dernier fichier input.json comme suit :

   • Option A : pour obtenir la dernière révision de votre fichier input.json , exécutez la commande suivante :

     uipathctl manifest get-revision
     

   • Option B : pour répertorier tous les fichiers input.json précédents et déterminer celui que vous souhaitez choisir, exécutez la commande suivante :

     uipathctl manifest list-revisions
     

4. Si vous utilisez une configuration hors ligne avec un registre externe compatible OCI, vous devez hydrater le registre avec des images de conteneur et des graphiques Helm avant la mise à niveau. Pour plus de détails, consultez la section Hydratation du registre avec le package hors ligne.

5. Si Process Mining est installé et que vous souhaitez utiliser la dernière version de Airflow qui a besoin de PostgreSQL, vous devez ajouter ou mettre à jour le modèle de chaîne de connexion sqlalchemy applicable pour PostgreSQL dans le fichier input.json avant la mise à niveau : postgresql_connection_string_template_sqlalchemy_pyodbc.

   postgresql+psycopg2://<user>:<password>@<postgresql host>:<postgresql port>/<airflow db name>
   

6. Si Integration Service est installé, assurez-vous que vos files d'attente cloud externes (SQS) sont synchronisées et que la réplication entre régions est activée. Par exemple :

   • Dans Azure Queue Storage, configurez les options de redondance GRS/RA-RGS ou GZRS/RA-GZRS. Pour des détails, reportez-vous à:
     • Redondance des données dans le stockage Azure
     • Fiabilité dans le stockage de files d'attente Azure
     • Guide de conception géo-redondant
   • Dans Amazon SQS, créez des files d'attente SQS dans chaque région et répliquez les messages à l'aide du déploiement VPN ou d'une logique personnalisée. Pour des détails, reportez-vous à:
     • Amazon SQS - Récupération d'urgence active/active
     • Livraison des messages DNS multi-régions

7. Si vous effectuez une mise à niveau vers Automation Suite 2.2510.0 ou une version ultérieure à partir des versions précédentes d’Automation Suite 2024.10 et que Studio Web est activé, vous devez également activer Solutions. Pour de plus amples informations, consultez la section Activer ou désactiver des solutions. Veillez également à examiner la configuration matérielle requise supplémentaire pour les solutions. Pour plus de détails, consultez la section Planification de la capacité.

Exécution

Pour effectuer une mise à niveau des services et des composants UiPath®, procédez comme suit :

1. Confirmez que votre cluster est sain :

   uipathctl health check --namespace <uipath> --versions versions.json
   

2. Mettez le cluster en mode maintenance pour garantir une sauvegarde cohérente :

   uipathctl cluster maintenance enable
   

   Important :

   Cette opération entraîne des temps d'arrêt et l'automatisation de votre entreprise est suspendue lorsque le mode de maintenance est activé.

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

   uipathctl cluster maintenance is-enabled
   

4. Sauvegardez le cluster et la base de données SQL, puis vérifiez que la sauvegarde s’est terminée correctement. Créez également une sauvegarde avant de mettre à niveau votre infrastructure Kubernetes.

   Si vous remplissez simultanément les exigences suivantes, assurez-vous de copier la valeur de global.userInputs.identity.krb5KeytabSecret dans global.kerberosAuthConfig.userKeytab:

   • vous avez configuré l'intégration d'Active Directory à l'aide d'un nom d'utilisateur et d'un mot de passe
   • vous avez activé l'authentification Windows
   • vous n'utilisez pas l'authentification intégrée SQL

5. À partir d'Automation Suite 2.2510.2, le mode de maintenance doit rester activé pendant la mise à niveau. Pour les versions antérieures à Automation Suite 2.2510.2, désactivez le mode de maintenance avant d’effectuer la mise à niveau :

   uipathctl cluster maintenance disable
   

   Remarque :

   Si vous effectuez une mise à niveau vers Automation Suite 2.2510.2 ou une version ultérieure, ignorez cette étape et désactivez le mode de maintenance uniquement une fois la mise à niveau terminée.

6. Effectuez la mise à niveau des services et composants UiPath® :

   uipathctl cluster upgrade input.json --versions versions.json
   

   Dans Automation Suite 2.2510.0, la commande uipathctl cluster upgrade échoue avec l'erreur suivante lorsque le mode de maintenance est désactivé: Please enable maintenance mode prior to attempting an upgrade. Use 'uipathctl cluster maintenance enable'.

   Pour éviter le message d’erreur, utilisez la commande suivante pour effectuer la mise à niveau. Assurez-vous d'avoir créé toutes les sauvegardes requises avant de continuer.

   uipathctl cluster upgrade input.json --versions versions.json --skip-upgrade-readiness
   

   Important :

   Cette opération entraîne des temps d'arrêt et l'automatisation de votre entreprise est suspendue pendant le processus de mise à niveau. Il est important que vous effectuiez la mise à niveau uniquement pendant votre période de maintenance.

7. À partir d'Automation Suite 2.2510.2, désactivez le mode maintenance :

   uipathctl cluster maintenance disable
   

8. Vérifiez que le cluster est sain après la mise à niveau :

   uipathctl health check --namespace <uipath> --versions versions.json
   

   Remarque :

   Si vous avez effectué une mise à niveau vers Automation Suite 2.2510 ou une version ultérieure, vous pouvez désinstaller Dapr et Ert Manager, si vous avez précédemment installé ces modules complémentaires pour Process Mining ou Task Mining. Pour de plus amples informations, reportez-vous aux sections Désinstaller Dapr et Désinstaller Cet Manager .

Mise à niveau de l'infrastructure Kubernetes

Remarque :

Automation Suite prend en charge les versions en amont N-1 à N-3 de Kubernetes, quel que soit le fournisseur Cloud. Par exemple, si la version en amont est la version 1.27, nous prenons en charge les versions 1.26, 1.25 et 1.24. Pour connaître les versions prises en charge, consultez la section Matrice de compatibilité.

Vous êtes responsable de la mise à niveau de l’infrastructure Kubernetes hébergeant Automation Suite. Vous devez suivre les pratiques standard de votre entreprise pour mettre à niveau l’infrastructure Kubernetes.

Exécution d'opérations post-mise à niveau

Les scénarios suivants décrivent les opérations post-mise à niveau requises pour votre environnement:

• Si vous avez effectué une mise à niveau vers Automation Suite 2.2510.0 ou une version ultérieure, et que Process Mining ou Task Mining était activé sur la version précédente:

  • Désinstallez Dapr. Pour des détails, reportez-vous à Comment désinstaller Dapr.
  • Désinstallez le gestionnaire de certificats. Pour plus de détails, consultez la section Comment désinstaller Alert Manager.

• Si vous avez effectué une mise à niveau vers Automation Suite 2.2510.0 ou une version plus récente, vous devez immédiatement réactiver vos licences existantes pour chaque organisation et hôte:

  • Activation en ligne : réactivez directement après la mise à niveau.
  • Activation hors ligne : générez un nouveau fichier de charge utile d'activation à partir de l'instance Automation Suite, puis téléchargez-le dans Activation.

  La réutilisation des anciens fichiers d’activation n’est pas autorisée et entraînera une licence non valide. La réactivation de la licence doit être effectuée à l'aide du bouton Mettre à jour la licence . Ne désactivez pas, puis réactivez manuellement la licence, car cela désactivera les services.