Automatisée : mise à niveau en ligne

Ansible est utilisé pour automatiser la mise à niveau de l'ensemble du cluster Automation Suite, en effectuant certaines opérations sur une machine du cluster.

Dans l'illustration suivante, le nœud du serveur 1 (ou le nœud hôte Ansible) utilise Ansible pour orchestrer la mise à niveau de l'ensemble du cluster Automation Suite.

Préparation

Important :

Avant la mise à niveau, assurez-vous d'avoir préparé votre environnement pour l'utilisation du script uipathctl.sh . Pour plus de détails, consultez Utilisation de uipathctl.sh.

Assurez-vous que vous disposez de 10 Go d'espace libre dans le dossier /opt/UiPathAutomationSuite sur tous les nœuds. Si vous ne disposez pas de suffisamment d'espace, vous pouvez augmenter la capacité de ce dossier ou supprimer tous les fichiers du programme d'installation précédents, à l'exception de cluster_config.json . Vous pouvez toujours télécharger à nouveau le programme d'installation précédent.

Pour vérifier l'espace disponible, exécutez la commande suivante : df -h /opt/UiPathAutomationSuite .

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

1. Connectez-vous au nœud de serveur que vous avez précédemment identifié comme étant le nœud hôte Ansible via SSH.
2. Devenez utilisateur root.

   sudo su -

3. Créez un dossier d'installation sous le répertoire /opt/UiPathAutomationSuite .

   # Please replace {version} with installer version
   mkdir -p /opt/UiPathAutomationSuite/{version}/installer

4. Téléchargez as-installer.zip et copiez-le dans /opt/UiPathAutomationSuite/{version}/installer. Pour obtenir des instructions de téléchargement, consultez as-installer.zip.

   cp /path/to/as-installer.zip /opt/UiPathAutomationSuite/{version}/installer

5. Décompressez as-installer.zip .

   cd /opt/UiPathAutomationSuite/{version}/installer
   unzip as-installer.zip -d .

6. Fournissez les autorisations nécessaires au programme d'installation.

   chmod 755 -R /opt/UiPathAutomationSuite/{version}/installer .

7. Générez le dernier fichier cluster_config.json sur le nœud hôte Ansible.
   Remarque : Pour plus de détails sur la configuration des paramètres cluster_config.json, voir Expérience d'installation avancée.

   • Si vous avez l'ancien cluster_config.json , générez le fichier de configuration à partir du cluster :

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -i /path/to/old/cluster_config.json -o ./cluster_config.json

   • Si vous ne disposez pas de l'ancien fichier cluster_config.json , générez un remplacement des valeurs par défaut, ce que vous avez peut-être fait au moment de l'installation de la version précédente :

     cd /opt/UiPathAutomationSuite/{version}/installer
     
     ./configureUiPathAS.sh config get -o ./cluster_config.json

   • Si vous effectuez une mise à niveau d'Automation Suite 2022.10 vers Automation Suite 2023.4 ou une version ultérieure, et qu'Orchestrator est activé sur l'ancienne et la nouvelle version, vous devez définir l'indicateur orchestrator.block_classic_executions sur true dans le fichier cluster_config.json. L'utilisation de l'indicateur montre que vous êtes d'accord avec le blocage des exécutions de dossiers classiques. La non-utilisation de l'indicateur entraîne l'échec de l'opération de mise à niveau. Pour obtenir un exemple de configuration, consultez Configuration spécifique à Orchestrator.
   • Si vous mettez à niveau Automation Suite à partir d'une version précédente et activez également Process Mining, vous devez mettre à jour l'élément sql_connection_string_template_sqlalchemy_pyodbc. Voici un exemple.

     "sql_connection_string_template_sqlalchemy_pyodbc": "mssql+pyodbc://[e-mail]:[e-mail]:1433/DB_NAME_PLACEHOLDER?driver=ODBC+Driver+17+for+SQL+Server"

   • Si vous mettez à niveau Automation Suite à partir d'une version antérieure à 2023.4 et qu'Apps est activé, vous devez créer la base de données SQL pour Apps , puis mettre à jour le fichier cluster_config.json avec la configuration suivante :

     "apps": {
     "enabled": "true" // This will already be true in existing cluster_config.json if apps is enabled
     "sql_connection_str": "" // Provide ODBC database connection string if apps is enabled
     }

     Remarque :

     Utilisez le fichier cluster_config.json mis à jour dans les prochaines étapes de mise à niveau.

Consultez également la section Manuel : expérience d’installation avancée.

Important : si vous avez précédemment déployé votre installation à nœud unique à l'aide de n'importe quelle version de modèle Azure antérieure à 2022.10.3, et que vous souhaitez désormais effectuer une mise à niveau vers une version plus récente d'Automation Suite, vous devez définir l'indicateur zone_resilience sur false dans le fichier cluster_config.json sous /opt/UiPathAutomationSuite/Installer.

Exécution

Important :

Si des erreurs ou des problèmes se produisent pendant ou après la mise à niveau, vous pouvez revenir à la version précédente, à condition d'avoir préalablement configuré une sauvegarde.

Pour obtenir des instructions, consultez la section Annulation en cas d'erreur.

Configuration de la sauvegarde

Pour configurer la sauvegarde, procédez comme suit :

1. Assurez-vous d'avoir activé la sauvegarde sur le cluster. Vous devez créer la sauvegarde à l'aide de la même version du programme d'installation que celle que vous avez utilisée pour le déploiement actuel. Pour obtenir des instructions, consultez la documentation de sauvegarde et de restauration correspondant à la version d'Automation Suite à partir de laquelle vous prévoyez d'effectuer la mise à niveau. Par exemple, si vous prévoyez d'effectuer une mise à niveau à partir d'Automation Suite 2021.10, suivez les instructions du guide 2021.10.
2. Connectez-vous au nœud de serveur que vous avez précédemment identifié comme étant le nœud hôte Ansible via SSH.
3. Vérifiez que tous les volumes souhaités ont des sauvegardes dans le cluster :

   /path/to/old-installer/configureUiPathAS.sh verify-volumes-backup

   Remarque : la sauvegarde peut prendre un certain temps, attendez environ 15 à 20 minutes, puis vérifiez à nouveau la sauvegarde des volumes.

Une fois la sauvegarde créée, passez aux étapes suivantes.

Mettre le cluster en mode maintenance

Mettre le cluster en mode maintenance arrêtera le contrôleur d'entrée et tous les services UiPath, bloquant ainsi tout le trafic entrant vers le cluster Automation Suite.

Attention : Cette opération entraînera des temps d'arrêt et l'automatisation de votre entreprise sera suspendue pendant tout le processus de mise à niveau.

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

   cd /opt/UiPathAutomationSuite/{version}/installer
   ./configureUiPathAS.sh enable-maintenance-mode

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

   ./configureUiPathAS.sh is-maintenance-enabled

   Attention : Créez une sauvegarde de votre serveur SQL après avoir activé le mode maintenance afin qu'aucune autre transaction ne soit enregistrée dans votre base de données SQL.

Mise à niveau du cluster

Pour mettre à niveau le cluster Automation Suite, procédez comme suit :

1. Connectez-vous au nœud hôte Ansible via SSH et devenez l'utilisateur root.
2. Pour effectuer les étapes de mise à niveau sur tous les nœuds, exécutez la commande suivante avec les paramètres de base. Pour un contrôle plus précis, consultez la section Paramètres.
   Remarque : Assurez-vous d'avoir mis à jour cluster_config.json généré comme décrit dans les étapes de préparation.

   ./uipathctl.sh upgrade --cluster-config ./cluster_config.json --install-type online --steps all --accept-license-agreement

   Important :

   Le processus de mise à niveau nécessite la migration de Canal CNI vers Cilium CNI. La mise à niveau automatisée exécute cette étape automatiquement, puis redémarre tous les nœuds du cluster pour terminer la migration.

   Une fois les nœuds redémarrés, attendez quelques minutes pour vous assurer que tous les services sont à nouveau en ligne. Vous pouvez vous connecter à ArgoCD pour surveiller le statut de toutes les applications.

   Important :

   Si vous obtenez l'erreur suivante, suivez les instructions de Rétrogradation de Ceph de la version 16.2.6 à la version 15.2.9.

   Ceph cluster is running on version: 16.2.6 with known bug(https://docs.ceph.com/en/quincy/releases/pacific/#v16-2-6-pacific). Please provide temporary backup directory (via environment variable 'TMP_CEPH_BACKUP_PATH') to downgrade ceph

Paramètres de base

Paramètre	Valeur (Value)
--install-type	Valeurs possibles : online et offline . Étant donné que cette page fournit des instructions pour un environnement en ligne, choisissez la valeur online .
--steps	Les valeurs possibles sont : all , infra , fabric et services . Indique chaque étape du processus d'installation et de mise à niveau. all – Un sur-ensemble de toutes les autres étapes, qui met à niveau l'ensemble d'Automation Suite. infra – Met à niveau Kubernetes et d'autres composants d'infrastructure sur Automation Suite sur tous les nœuds. fabric – Met à niveau tous les composants Fabric et partagés d'Automation Suite. services – Met à niveau tous les services produit UiPath installés sur Automation Suite. Si une erreur se produit pendant la mise à niveau, vous pouvez utiliser ces points de contrôle pour reprendre l'opération de mise à niveau au lieu de réessayer depuis le début.
--cluster-config	cluster_config.json , qui définit les paramètres, les paramètres et les préférences appliqués aux services UiPath déployés via Automation Suite.

Paramètres avancés

Paramètre	Valeur (Value)
--ansible-username	Spécifiez le nom d'utilisateur à utiliser pour les connexions SSH à tous les nœuds. La valeur par défaut est l'utilisateur actuel. Si vous utilisez un nom d'utilisateur différent pour tous les nœuds, au lieu d'utiliser ce paramètre, définissez le nom d'utilisateur pour tous les nœuds dans inventory.ini et transmettez-le au script. Exemple : Lors de l'exécution du script, vous êtes connecté sous le nom d'utilisateur myadminuser . Cependant, si vous souhaitez utiliser le nom d'utilisateur testadmin pour vous connecter via SSH, vous devez fournir testadmin à ce paramètre.
--inventory	Spécifiez un fichier d'inventaire Ansible existant. S'il n'est pas spécifié, un sera généré automatiquement à partir du cluster existant avec la configuration de base. Dans certains scénarios où vous souhaitez avoir un contrôle plus précis, vous souhaiterez peut-être fournir votre propre fichier d'inventaire. Par exemple, si vous souhaitez utiliser un nom d'utilisateur SSH ou une clé SSH différent pour tous les nœuds du cluster. Pour plus de détails, voir Génération du fichier Inventory.ini Ansible.

Remarque : Une fois la mise à niveau terminée, le mode maintenance est automatiquement désactivé.

Une fois la mise à niveau effectuée, vous pourrez effectuer les étapes supplémentaires suivantes.

• Pour vérifier si Automation Suite est sain, exécutez :

  kubectl get applications -n argocd

• Lors de la mise à niveau à partir d'une version d'Automation Suite antérieure à 2023.4.0, vérifiez si Apps est en cours d'exécution, puis supprimez MongoDB :

  ./configureUiPathAS.sh mongodb uninstall --force

• Si vous rencontrez une erreur lors de la suppression de MongoDB avec la commande ./configureUiPathAS.sh mongodb uninstall --force, exécutez la commande suivante :

  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": false }}}}'
  
  ./configureUiPathAS.sh mongodb uninstall --force
  
  kubectl patch application "fabric-installer" -n argocd --type=merge -p '{"spec" : {"syncPolicy" : {"automated" : {"selfHeal": true }}}}'

• Si vous rencontrez des problèmes de vulnérabilité d’image ou de consommation de stockage après avoir effectué une mise à niveau, supprimez les images de l’ancien programme d’installation. Pour plus de détails, consultez la section Résolution des problèmes (Troubleshooting).

Activation de la sauvegarde après la mise à niveau

Remarque : Assurez-vous qu'Automation Suite est opérationnel et que votre automatisation se poursuit comme prévu avant de passer aux étapes suivantes.

Avant de commencer à mettre à niveau le cluster, le script de mise à niveau crée automatiquement une sauvegarde du cluster, puis la désactive temporairement. Vous souhaiterez peut-être activer la sauvegarde manuellement une fois la mise à niveau terminée.

Pour activer la sauvegarde, suivez les instructions décrites dans la documentation Sauvegarder et restaurer le cluster.

Finalisation d'une mise à niveau avec un modèle de déploiement

Après avoir effectué une mise à niveau du cluster Automation Suite, les déploiements de modèles Azure et AWS nécessitent quelques modifications pour garantir qu'un nouveau nœud rejoint correctement le cluster via des opérations de mise à l'échelle. Pour automatiser les modifications, nous vous recommandons d'utiliser les scripts dédiés. Pour obtenir des instructions, consultez la documentation relative aux modèles de déploiement Azure et la documentation relative aux modèles de déploiement AWS.

Considérations spéciales

Lors de l'exécution d'une mise à niveau pour un cluster déployé avec des modèles Azure, une erreur similaire à celle illustrée dans l'image suivante peut se produire :

Cela est dû au mode de fonctionnement de l'équilibreur de charge Azure. Pour résoudre le problème, modifiez le champ fixed_rke_address dans le fichier cluster_config.json. Vous devez remplacer la valeur de ce champ par l'adresse IP de la première instance de serveur avant d'exécuter la commande de mise à niveau. Le fichier cluster_config.json téléchargé vers le coffre de clés doit continuer à avoir l’adresse IP de l’ILB, car le nœud n’est pas sain et le trafic ne sera pas équilibré.