Mettre à niveau Automation Suite

Automation Suite est composé de plusieurs composants. En tant que client, vous partagez avec UiPath® la responsabilité de ces composants. Pour plus de détails, consultez Matrice de responsabilité.

Vous êtes responsable de la mise à niveau :

• Infrastructure Kubernetes dans laquelle 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 :

• If you upgrade to Automation Suite 2.2510 or higher, you need to bring a PostgreSQL database for AutomationSuite_Airflow and configure the connection string for it in input.json.

  Reportez-vous à la section Configuration spécifique à Process Mining pour plus de détails.

• If you upgarde from versions prior to 2.2510.0 using Studio Web, make sure to use the same storage class name as specified in storage_class_single_replica, to support RWX access mode.

  Refer to Configuring input.json for details.

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 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 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 cluster_config.json avant la mise à niveau : postgresql_connection_string_template_sqlalchemy_pyodbc.

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

6. If Integration Service is installed, make sure your external cloud queues (SQS) are synced and cross-region replication is enabled. For example:
   • In Azure Queue Storage, configure the GRS/RA-GRS or GZRS/RA-GZRS redundancy options. For more details, see:
     • Data redundancy in Azure Storage
     • Reliability in Azure Queue Storage
     • Geo-redundant design guidance
   • In Amazon SQS, create SQS queues in each region and replicate messages using SNS fan-out or custom logic. For more details, see:
     • Amazon SQS – Active/Active Disaster Recovery
     • SNS Cross-region message delivery

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

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 déroulée correctement.
   Important :

   Il est fortement recommandé de créer une sauvegarde du cluster et de la base de données SQL avant de mettre à niveau Automation Suite. Cela permet de garantir que vous pouvez restaurer le cluster en cas de problème lors de l'opération de mise à niveau. Cela s'applique également avant la mise à niveau de votre infrastructure Kubernetes.

   Make sure to copy the value of global.userInputs.identity.krb5KeytabSecret to global.kerberosAuthConfig.userKeytab, if you simultaneously meet the following requirements:

   • 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. 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.

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

   uipathctl health check

   Note: If you upgraded to Automation Suite 2.2510 or higher, you can uninstall Dapr and Cert Manager, if you previously installed these add-ons for Process Mining or Task Mining. For details, refer to the Uninstall Dapr and Uninstall Cert Manager sections.

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

The following table describes the possible scenarios where you must perform to perform post-upgrade operations:

Condition	Action
1. You upgraded to Automation Suite 2.2510.0 or newer.	You must immediately reactivate your existing licenses for each organization and host. Online activation: Reactivate directly after upgrade. Offline activation: Generate a new activation payload file from the Automation Suite instance, then upload it in Activation. Reusing old activation files is not allowed and will result in an invalid license.