Mettre à niveau Automation Suite

Automation Suite est constituée 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é.

Important :

À partir d'Automation Suite 2025.10, si vous utilisez Automation Suite sur AWS EKS ou Azure AKS, vous devrez tirer parti de la solution de sauvegarde gérée AWS ou Azure pour les sauvegardes. Cela vous permet d'harmoniser votre stratégie de sauvegarde dans le cloud. La solution de sauvegarde précédemment gérée par UiPath ne sera plus disponible.

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 2024.10.3 ou une version ultérieure et que vous souhaitez la dernière version de Airflow, vous devez apporter une base de données PostgreSQL pour AutomationSuite_Airflow et configurer la chaîne de connexion correspondante dans input.json.

Pour de plus amples informations, consultez la section Configuration spécifique à Process Mining.

Il existe un problème connu avec la logique de sauvegarde dans Automation Suite pour les versions AKS/EKS 2024.10.0 vers 2024.10.1. Plus précisément, ce problème exclut la sauvegarde des tableaux de bord Insights et des données Studio Web. Cependant, toutes les données historiques sont sauvegardées avec succès. Pour inclure les données d’Insights et de Studio Web dans la sauvegarde, vous devez reconfigurer la solution de sauvegarde à l’aide du script dr.sh. Ce script vous permet de reconfigurer la solution de sauvegarde et de créer la sauvegarde. Pour plus de détails sur la façon d'exécuter la commande, consultez cette section.

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 de plus amples informations, 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 de plus amples informations, 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 cluster_config.json avant la mise à niveau : postgresql_connection_string_template_sqlalchemy_pyodbc.

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

   Remarque :

   Cela s’applique uniquement à Process Mining sur Automation Suite 2024.10.3 ou version ultérieure.

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. Désactivez le mode maintenance :

   uipathctl cluster maintenance disable
   

   Remarque :

   Vous devez désactiver le mode de maintenance avant la mise à niveau. Le processus de mise à niveau d'Automation Suite ne prend pas en charge l'activation du mode de maintenance.

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

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

   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. 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 2024.10.3 ou une version ultérieure, vous pouvez désinstaller Dapr et Cert Manager si vous n'avez pas activé Task Mining. Pour plus de détails, reportez-vous aux sections Désinstaller Dapr et Désinstaller Cert 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.