Finalisation d'une mise à niveau

Context

Après avoir effectué une mise à niveau du cluster Automation Suite, certaines modifications sont nécessaires pour garantir qu'un nouveau nœud rejoint correctement le cluster. Pour automatiser les modifications, nous vous recommandons d'utiliser le script upgradeUiPathAS.sh.

Cette page fournit des instructions sur la façon de remplacer l'extension de script personnalisé (CSE) au niveau des ressources de calcul afin que de nouveaux nœuds puissent être ajoutés à votre cluster lors de la mise à niveau vers une nouvelle version d'Automation Suite.

Le processus décrit dans les sections suivantes télécharge les scripts requis pour apporter des modifications mineures aux ressources Azure ainsi que pour valider certains prérequis. Les scripts se trouvent dans les dossiers <targetVersion> et Modules. Si le processus échoue, il vous est demandé si vous souhaitez conserver les fichiers.

Après avoir vérifié que les prérequis sont valides, les objets CustomScriptExtension sont mis à jour sur toutes nos ressources de calcul afin que les nœuds nouvellement ajoutés utilisent Automation Suite <targetVersion>. Enfin, les fichiers des nœuds de cluster initiaux sont écrasés pour correspondre également aux fichiers <targetVersion>.

Préparation

Prérequis

Assurez-vous de répondre aux exigences suivantes :

• Vous devez ajouter le Managed Service Identity (MSI) associée au déploiement (nommée au format <basename>-MSI) en tant qu'identité attribuée par l'utilisateur à tous les groupes identiques/machines virtuelles du déploiement. Pour ce faire, accédez à Groupe unique/machine virtuelle (Scaleset/virtual machine) > Identity > Attribué par l'utilisateur (User Assigned ) > Ajouter (Add). Cet ajout a peut-être déjà été effectué dans les versions plus récentes des modèles Automation Suite.
• Vous devez accorder les droits MSI existants pour lire/écrire/gérer les clés secrètes dans le coffre de clés déployé (nommé <basename>-VAULT). Pour ce faire, accédez au coffre de clés, cliquez sur Stratégies d'accès (Access Policies), puis sur Ajouter (Add), sélectionnez toutes les opérations secrètes, choisissez le MSI, puis cliquez sur Ajouter (Add).
• Assurez-vous de consulter le fichier cluster_config.json et de remplacer toutes les valeurs booléennes marquées comme chaîne ("true"/"false") par des valeurs booléennes réelles (true/false). Par exemple :
  • pour activer la résilience de zone, utilisez "zone_resilience": true.
  • pour permettre au programme d'installation de créer les bases de données, utilisez "sql.create_db": true.
• Assurez-vous que votre version RHEL des groupes de machines virtuelles identiques (serveur, agent, etc.) est mise à jour et correspond à la version vers laquelle vous effectuez la mise à niveau.
• 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. Ce paramètre n'est pas requis dans les nouvelles installations.
• Si vous effectuez une mise à niveau vers Automation Suite 2023.10 ou une version ultérieure, et qu'Insights est activé sur l'ancien et le nouvel environnement, vous devez définir l'indicateur insights.external_object_storage.bucket_name sur le même compartiment utilisé pour platform dans le fichier cluster_config.json. La non-utilisation de l'indicateur entraîne l'échec de l'opération de mise à niveau. Ce paramètre n'est pas requis dans les nouvelles installations.
• Si vous effectuez une mise à niveau vers Automation Suite 2023.10 ou une version ultérieure, veillez à remplir les champs suivants dans le fichier cluster_config.json si sql.create_db est défini sur true :

  sql.server_url = "<db_endpoint>"
  sql.port = "1433"
  sql.username = <SQL Username>
  sql.password = <SQL password>

• Après le processus de mise à niveau, exportez le contenu du nouveau fichier cluster_config.json vers une clé secrète Azure Key Vault nommée clusterConfig dans le coffre de clés de déploiement (pour plus de détails, consultez l’élément de liste précédent). Utilisez la valeur du champ FixedRKEAddress comme adresse IP de l'équilibreur de charge interne. Pour ce faire, exécutez une commande similaire à ce qui suit :

  az keyvault secret set --name clusterConfig --vault-name "<vaultName>" --value "$(cat path/to/cluster_config.json)

• Sur la machine exécutant le script de mise à niveau, vous devez être connecté à Azure et définir le contexte sur l'abonnement approprié. Le compte doit avoir le rôle Owner par rapport au groupe de ressources où le cluster a été déployé.

Considérations et recommandations

Avant de commencer l'opération de mise à niveau, veillez à prendre en compte les recommandations suivantes :

• Nous vous recommandons vivement d'effectuer la mise à jour vers la dernière version du système d'exploitation RHEL prise en charge par Automation Suite. Pour plus de détails, consultez la section Configuration matérielle et logicielle requise.
• Avant de commencer l'opération de mise à niveau, vous pouvez créer deux conteneurs nommés logs et flags dans le compte de stockage de déploiement (nommé <basename>st). Si vous ne les créez pas, le script de mise à niveau peut le faire pour vous.
• Si les groupes identiques de serveurs déployés ne sont pas associés à un disque Ceph, le script en crée un et le rattache au groupe identique de serveurs.
• Le processus de mise à niveau modifie le modèle VMSS mais ne l'applique pas aux instances plus anciennes.
• 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é.

Exécution

Pour réussir la mise à niveau vers une nouvelle version d'Automation Suite, procédez comme suit :

1. Téléchargez le script upgradeUiPathAS.sh ici.
2. Accédez au chemin où vous avez téléchargé le script et exécutez la commande suivante : chmod +x ./upgradeUiPathAS.sh.
3. Exécutez le processus de mise à niveau en mode interactif ou non interactif dans un environnement Linux :

   • Option A : pour exécuter le processus en mode interactif, utilisez la commande suivante :

     sh upgradeUiPathAS.sh --targetVersion {ASversion}

     Le script vous demande de fournir une série de paramètres pendant l'exécution. Pour plus de détails sur les paramètres requis, voir Déploiement d'Automation Suite sur Azure (Deploying Automation Suite to Azure).

   • Option B : pour exécuter le processus en mode non interactif, procédez comme suit :

     1. Créez un dossier <targetVersion> à côté du script téléchargé.
     2. Dans le dossier <targetVersion>, créez un fichier nommé paramValues.json avec la structure suivante :
        { "param1":"value1", "param2":"value2" }.

        Pour plus de détails sur les paramètres requis, consultez la section Déploiement d'Automation Suite vers Azure.

     3. Exécutez le script upgradeUiPathAS.sh :

        sh upgradeUiPathAS.sh --targetVersion {ASversion} --uninteractive true

        Remarque : assurez-vous de remplacer {ASversion} par la version d'Automation Suite dans les commandes susmentionnées. La version d'Automation Suite peut différer de la version du modèle Azure.

Paramètres

Vous pouvez trouver des descriptions des paramètres nécessaires à la mise à jour vers une version spécifique d'Automation Suite dans le fichier cluster_config.json. Vous pouvez trouver le fichier cluster_config.json en suivant ce lien.