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.

• You must grant the existing MSI rights to read/write/manage secrets in the deployed key vault (named like <basename>-VAULT). To do this, go to the keyvault, click Access Policies, then Add, select all Secret Operations, choose the MSI, then 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 :

  Remarque :

  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.

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

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

• We strongly recommend updating to the latest RHEL OS version supported by Automation Suite. For details, see Deployment profiles at a glance.
• 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.
• For details on the upgrade errors you might encounter, see Manual: Online upgrade and Automated: Online upgrade.

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}

     The script asks you to provide a series of parameters during the run. For details on the required parameters, see 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" }.

        For details on the required parameters, see Deploying Automation Suite to 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.