Étape 3 : étapes post-déploiement

Remarque :

Lorsque vous utilisez Azure Bastion, gardez à l'esprit que les commandes copier-coller réparties sur plusieurs lignes à l'aide de \ peuvent ne pas fonctionner comme prévu. Pour vous assurer que les nouvelles lignes sont interprétées correctement, utilisez le widget Presse-papiers de la console.

Validation de l'installation

Pour vérifier si Automation Suite a été installée avec succès, vous devez accéder au compte de stockage, à l'intérieur du conteneur d' indicateurs . L'installation est terminée si le contenu du fichier généré automatiquement appelé installResult (dans le conteneur) est successful . Le contenu sera failed si l'installation a échoué.

Mise à jour des certificats

Important :

Le processus d'installation génère des certificats auto-signés en votre nom. Toutefois, le modèle de déploiement Azure vous donne également la possibilité de fournir un certificat de serveur émis par une autorité de certification au moment de l'installation au lieu d'utiliser un certificat auto-signé généré automatiquement.

Ces certificats expireront sous 90 jours et vous devrez les remplacer par des certificats signés par une autorité de certification (CA) approuvée dès que l'installation sera terminée. Si vous ne mettez pas à jour les certificats, l'installation cessera d'être opérationnelle après 90 jours.

For instructions, see Managing certificates.

Exploration des indicateurs et des journaux

Si vous avez besoin de plus amples informations sur le processus d'installation d'Automation Suite ou d'autres opérations, le compte de stockage utilisé pour stocker divers indicateurs et journaux lors du déploiement et de la maintenance du cluster est un bon point de départ.

Pour localiser le compte de stockage, procédez comme suit :

1. Accédez au groupe de ressources dans lequel le déploiement a été effectué.

2. Filtrer par type de ressource Compte de stockage ( Storage Account) .

3. Localisez le compte de stockage dont le nom se termine par st . Par exemple :

   

4. Sélectionnez le compte de stockage, puis sélectionnez Conteneurs. Vous les options sont des indicateurs et des journaux.

   

Conteneur d'indicateurs

Le conteneur d' indicateurs stocke divers indicateurs ou fichiers nécessaires à l'orchestration ou simplement pour signaler l'état de diverses opérations. Sur un nouveau cluster, le contenu du conteneur d' indicateurs ressemble généralement à l'exemple suivant :

Les fichiers des conteneurs d' indicateurs sont utilisés pour orchestrer diverses opérations, telles que le processus d'installation d'Automation Suite sur le cluster, ou des opérations de cluster spécifiques, telles que l'actualisation de l'instance. Par exemple :

• uipath-server-000000.success indique que l'installation de l'infrastructure s'est terminée avec succès sur ce nœud spécifique du cluster ;
• installResult lit success si l'installation globale est réussie.

Conteneur de journaux

Lors de l'exécution d'une opération, il génère généralement un fichier journal dans le conteneur de journaux . Sur un nouveau cluster, le contenu du conteneur de journaux ressemble généralement à l'exemple suivant :

Chaque fichier du conteneur de journaux représente les journaux d'une étape spécifique du processus d'installation. Par exemple :

• infra-uipath-server-000000.log stocke les journaux d'installation de l'infrastructure ;
• fabric.log stocke les journaux pour l'installation de Fabric ;
• services.log stocke les journaux d'installation de l'application et des services.

Accéder aux sorties du déploiement

Une fois l'installation terminée, vous devez accéder aux sorties de déploiement (Deployment Outputs) dans l'onglet Sorties (Outputs).

Pour ce faire, accédez à votre groupe de ressources (Resource Group), puis à Déploiements (Deployments) → mainTemplate (ou quelque chose comme Microsoft.Template-DateTime) → Sorties (Outputs).

Sorties du déploiement

Sortie	Description
Documentation	Un lien vers la documentation.
URL	L'URL de l'équilibreur de charge. Peut être utilisé pour un accès direct. Si les domaines personnalisés étaient activés, il s'agirait du domaine que vous utiliseriez pour la liaison CNAME.
KeyVaultURL	L'URL du portail Azure pour le Key Vault créé par le déploiement. Il contient toutes les clés secrètes (informations d'identification) utilisées dans le déploiement.
ArgoCDURL	The URL for accessing ArgoCD. This is available within the VNet. External access to this URL must be set up as described in: Step 4: Configuring the DNS.
ArgoCDPassword	Le mot de passe utilisé pour se connecter au portail ArgoCD.
Nom de l'hôte administrateur et l'hôte administrateur mot de passe	Les informations d'identification utilisées pour l'administration de l'hôte.
ClusterAdministrationURL	The URL for the Cluster Administration portal.

Toutes les informations d'identification utilisées dans le déploiement sont stockées en tant que clés secrètes dans un Key Vault enregistré pendant le déploiement. Pour accéder aux clés secrètes, filtrez les ressources dans le groupe de ressources, recherchez Coffre (Vault), puis cliquez sur Clés Secrètes (Secrets).

Remarque :

Si l'avertissement The operation “List” is not enabled in the key vault’s access policy s'affiche sous l'onglet Clés secrètes (Secrets), procédez comme suit :

1. Accédez à Politiques d'accès (Access policies) → Ajouter une politique d'accès (Add access policy) → Configurer le modèle (Configure the template) → Gestion des clés secrètes (Secret Management) → Sélectionner principal (Select Principal).
2. Sélectionnez votre utilisateur, puis cliquez sur Enregistrer (Save).
3. Revenez à Clés secrètes (Secrets). L'avertissement devrait disparaître et les clés secrètes devraient être visibles.

Accéder aux machines virtuelles du cluster

Les machines virtuelles sont enregistrées dans un réseau virtuel privé. Vous pouvez y accéder via Azure Bastion en suivant ces étapes :

1. Accédez au groupe de ressources dans lequel vous avez déployé Automation Suite.

2. Étant donné que les agents, les agents GPU et les machines virtuelles de serveur se situent dans des groupes identiques, vous devez accéder au groupe identique contenant l'instance souhaitée.

   

3. Accédez à la section Instances dans l'onglet Paramètres (Settings).

   

4. Sélectionnez le nom de la machine virtuelle que vous souhaitez connecter.

   

5. Sélectionnez le bouton Connecter , puis choisissez Bastion dans le menu déroulant.

   

6. Saisissez les informations d'identification fournies dans le déploiement (paramètres Nom d'utilisateur administrateur et Mot de passe administrateur ), que vous trouverez dans le coffre d'informations d'identification, sous Clés secrètes) et sélectionnez Connect.

   

Exigences DNS

As mentioned in Step 1: Preparing your Azure Deployment, the Automation Suite Azure deployment creates a Load Balancer with a public IP and a DNS label associated. This DNS label is Microsoft-owned.

Le déploiement enregistre également une zone DNS privée à l'intérieur du réseau virtuel du cluster et ajoute plusieurs enregistrements qui sont utilisés pendant le processus d'installation et de configuration.

Si vous choisissez de vous connecter à partir d'une machine externe, vous ne pourrez pas utiliser la zone DNS privée pour résoudre le DNS pour divers services, vous devez donc ajouter ces enregistrements à votre fichier hôte.

See Step 4: Configuring the DNS for more details.

Vous devriez maintenant pouvoir vous connecter à divers services exécutés sur votre cluster.

Accéder au portail d'administration du cluster

The Cluster Administration portal is a centralized location where you can find all the resources required to complete an Automation Suite installation and perform common post-installation operations. For details, see Getting started with the Cluster Administration portal.

Pour accéder au portail d'administration du cluster, procédez comme suit :

Accédez à l'URL suivante : https://${CONFIG_CLUSTER_FQDN}/uipath-management.

Remarque :

You do not need any credentials to access the Cluster Administration portal.

Accéder à l'interface générale d'Automation Suite

L'interface utilisateur à usage général d'Automation Suite sert de portail pour les administrateurs et les utilisateurs de l'organisation. Il s'agit d'une ressource commune au niveau de l'organisation à partir de laquelle chacun peut accéder à toutes les zones d'Automation Suite : pages d'administration, pages au niveau de la plate-forme, pages spécifiques au service et pages spécifiques à l'utilisateur.

Pour accéder à Automation Suite, procédez comme suit :

1. Accédez à l'URL suivante : https://${Loadbalancer_dns}, où <loadbalancer_dns> est le libellé DNS de l'équilibreur de charge et se trouve sous les sorties.
2. Passez à l'organisation par défaut (Default).
3. Le nom d'utilisateur est orgadmin.
4. Récupérez le mot de passe en allant dans Keyvault, puis Clés secrètes (Secrets) ; il se trouve sous hostAdminPassword.

Accéder à l'administration de l'hôte

Le portail hôte est l'endroit où les administrateurs système configurent l'instance Automation Suite. Les paramètres configurés à partir de ce portail sont hérités par toutes vos organisations, et certains peuvent être remplacés au niveau de l'organisation.

Pour accéder à l'administration de l'hôte, procédez comme suit :

1. Accédez à l'URL suivante : https://${Loadbalancer_dns}, où <loadbalancer_dns> est le libellé DNS de l'équilibreur de charge et se trouve sous sorties (Outputs).
2. Passez à l'organisation Hôte (Host).
3. Entrez le nom d'utilisateur que vous avez précédemment spécifié comme valeur pour le paramètre Nom d'utilisateur de l' administrateur UiPath .
4. Entrez le mot de passe que vous avez précédemment spécifié comme valeur pour le paramètre UiPath Admin Password . Récupérez le mot de passe en allant dans Keyvault, puis Clés secrètes (Secrets) ; il se trouve sous hostAdminPassword.

Accéder à ArgoCD

Vous pouvez utiliser la console ArgoCD pour gérer les produits installés.

Pour accéder à ArgoCD, procédez comme suit :

1. Go to the following URL: https://alm.${Loadbalancer_dns}, where <loadbalancer_dns> is the DNS label for the load balancer and is found under Outputs. Note that you must configure external access to this URL as described in Step 4: Configuring the DNS.
2. Le nom d'utilisateur est admin.
3. Pour accéder au mot de passe, accédez à l'onglet Sorties (Outputs) ou à l'identifiant Keyvault.

Accéder à Rancher

Automation Suite utilise Rancher pour fournir des outils de gestion de cluster prêts à l'emploi. Cela vous aide à gérer le cluster et à accéder à la surveillance et au dépannage.

See Rancher documentation for more details.

See Using the monitoring stack for more on how to use Rancher monitoring in Automation Suite.

Pour accéder à la console Rancher, procédez comme suit :

1. Accédez à l'URL suivante : https://monitoring.${Loadbalancer_dns}, où <loadbalancerdns> est le libellé DNS de l'équilibreur de charge et se trouve parmi les sorties (Outputs) de votre déploiement.

2. Le nom d'utilisateur est admin.

3. Pour accéder au mot de passe, exécutez ce qui suit ci-dessous.

   kubectl get secrets/rancher-admin-password -n cattle-system \
   -o "jsonpath={.data['password']}" | echo $(base64 -d)
   

Mise à l'échelle de votre cluster

Les ressources de calcul enregistrées à partir du déploiement sont constituées de groupes identiques Azure, qui permettent une mise à l'échelle facile.

Vous pouvez ajouter manuellement des ressources supplémentaires à un groupe identique spécifique, y compris l'ajout de nœuds de serveur, de nœuds d'agent ou de nœuds d'agent spécialisés (tels que des nœuds GPU).

Vous pouvez effectuer une mise à l'échelle manuelle en identifiant le groupe identique spécifique et ajouter directement des ressources.

Pour ce faire, procédez comme suit :

1. Accédez au portail Azure et filtrez selon le groupe identique (Scale Set) spécifique :

   

2. Sélectionnez le groupe identique approprié et sélectionnez Mise à l'échelle.

   

3. Modifiez le champ Nombre d'instances en utilisant le curseur ou le champ de saisie situé à côté, puis sélectionnez Enregistrer.

   Remarque :

   Pour les groupes identiques de serveurs (Server Scale Sets), le nombre d'instances doit être un nombre impair.

4. L'opération de mise à l'échelle doit démarrer en arrière-plan et de nouvelles ressources seront disponibles une fois l'opération terminée.

Finalisation d'une mise à niveau

After performing an Automation Suite cluster upgrade, Azure template deployments require some changes to ensure a new node joins the cluster correctly. To automate the changes, we recommend using the dedicated script. For instructions, see the Azure deployment template docs.

Opérations du cycle de vie des machines virtuelles Azure

Astuce :

Azure autorise une fenêtre d’arrêt de 15 minutes maximum pour se préparer, tandis que l’arrêt en douceur d’un nœud Automation Suite varie de 20 minutes (pour les nœuds d’agent et d’agent GPU) à plusieurs heures (dans le cas des nœuds de serveur).

Pour éviter la perte de données, la politique de mise à niveau VMSS du serveur est définie sur manuelle, et les machines virtuelles du serveur ont la protection pour les actions de groupe identique activée. Par conséquent, nous vous recommandons de gérer le cycle de vie des serveurs via les runbooks fournis.

The InstanceRefresh, RemoveNodes, RemoveServers, and CheckServerZoneResilience runbooks are supported only for multi-node HA-ready production deployments.

Le nombre de serveurs après l'exécution d'un runbook doit être impair et supérieur à trois (par exemple, vous ne pouvez pas exécuter une actualisation d'instance si vous avez 4 serveurs ; vous ne pouvez pas supprimer un serveur si vous en avez un total de cinq).

Toutes les machines virtuelles des VMSS doivent être à l'état Running .

Un seul runbook doit être exécuté à la fois.

Important :

The InstanceRefresh, RemoveNodes, and RemoveServers runbooks are affected by an issue causing node removal operations to fail if Process Mining (AirFlow) and/or Automation Suite Robots service pods are scheduled on the node.

InstanceRefresh

Description

The InstanceRefresh runbook has the following use cases:

• Mettez à jour la référence SKU du système d'exploitation VMSS sur les ensembles identiques de serveur, d'agent et de GPU.
• Effectuez une opération de rotation des nœuds pour un ou plusieurs VMSS.
• Autres modifications de configuration VMSS qui ont été appliquées au préalable au VMSS.

Utilisation

1. Go to the Azure Portal and search for the resource called InstanceRefresh.

2. Sélectionnez le bouton Démarrer pour ouvrir la liste des paramètres. Renseignez les paramètres en tenant compte des éléments suivants :

   • Une opération de rotation de nœud est effectuée sur un VMSS uniquement si le paramètre REFRESH<node_type> est défini sur True . Si plusieurs paramètres REFRESH<node_type> sont définis sur True , l'ordre de rotation des nœuds VMSS sera Serveurs -> Agents -> Agents GPU.

   • Vous devez fournir le paramètre NEWOSVERSION pour mettre à jour la SKU du système d'exploitation VMSS. Vous pouvez trouver la SKU disponible de l’image des machines virtuelles Azure Marketplace à l’aide de az vm image list-skus --location <deployment_location> --offer RHEL --publisher RedHat --output table . Les machines virtuelles actuelles ne sont pas automatiquement mises à jour vers le dernier modèle (une opération de rotation des nœuds est nécessaire pour cela).

     Sélectionnez le bouton OK pour démarrer le runbook.

     

Détails de l'implémentation

The InstanceRefresh runbook is a wrapper for the RemoveNodes runbook. As a result, the status is tracked while running RemoveNodes. It updates all the VMSS OS versions (if needed) and extracts, based on the received parameters, the hostname for the node rotation operation and forwards them to the RemoveNodes. If the cluster has exactly three servers, the InstanceRefresh runbook creates three new servers; otherwise, RemoveNodes handles the scale-up to maintain at least one server in each Availability Zone at all times.

RemoveNodes

Description

Le runbook RemoveNodes présente les cas d’utilisation suivants :

• Supprime les nœuds spécifiés du cluster Automation Suite.
• Effectuez une opération de rotation des nœuds pour une/deux machines virtuelles.

Utilisation

1. Recherchez les noms d'ordinateurs des nœuds que vous souhaitez supprimer. Pour ce faire, accédez à un VMSS et sélectionnez Instances dans la section Settings .

   

2. Go to the Azure Portal and search for the resource called RemoveNodes.

3. Sélectionnez le bouton Démarrer pour ouvrir la liste des paramètres. Terminez les paramètres en tenant compte des éléments suivants :

• NODESTOBEREMOVEDCOMPUTERNAME est une liste de noms d'ordinateurs séparés par des virgules des machines virtuelles que vous souhaitez supprimer (par exemple, pxlqw-agent-000009,pxlqw-agent-00000A ), et c'est le seul paramètre obligatoire. Nous vous recommandons de supprimer les nœuds d’un seul VMSS à la fois.

• ISINSTANCEREFRESH and THREESERVERSSCENARIO are flags populated by the InstanceRefresh wrapper.

  Sélectionnez le bouton OK pour démarrer le runbook.

  

Détails de l'implémentation

Le runbook RemoveNodes a une approche récursive pour surmonter le délai d’expiration équitable de 3 heures. Il supprime ou rétablit le premier ou les deux premiers nœuds de la liste reçue et réexécute une autre instance du runbook avec la liste restante.

L'opération de repavage du nœud d'un nœud nécessite de suivre les étapes suivantes :

1. Faites évoluer le VMSS avec une ou deux machines virtuelles en fonction du nombre de nœuds qui seront supprimés.
2. Effectuez la suppression des nœuds des anciennes instances.

L'opération de suppression de nœud pour un nœud nécessite de suivre les étapes suivantes :

1. Cordonnez et drainez les instances. L'opération expire après 20 minutes pour un agent et number_of_instances * 60 minutes pour les serveurs.
2. Arrêtez le service rke sur les instances. L’opération expire après 5 minutes.
3. Supprimez les nœuds du cluster Automation Suite et supprimez les machines virtuelles. L'opération expire après 20 minutes pour les agents et number_of_instances * 60 minutes pour les serveurs.

RemoveServers

Description

The RemoveServers runbook has the following use case:

• supprimer des serveurs du cluster Automation Suite.

Utilisation

1. Go to the Azure Portal and search for the resource called RemoveServers.
2. Sélectionnez le bouton Démarrer pour ouvrir la liste des paramètres. Terminez les paramètres en tenant compte des éléments suivants :

• REMOVEDSERVERSCOUNT est le nombre de serveurs qui seront supprimés. Nous vous recommandons de ne pas supprimer plus de 2 serveurs à la fois afin de ne pas atteindre le délai d’expiration équitable .

  

Détails de l'implémentation

The RemoveServers runbook removes the number of servers received as a parameter from the Availability Zones with the most VMs.

CheckServerZoneResilience

Description

The CheckServerZoneResilience runbook scales out the server VMSS and uses the RemoveServers runbook to balance the servers across Availability Zones. This is part of the InstanceRefresh flow and should not be run manually.

AddGpuNode

Description

Dans le scénario où le déploiement initial a été créé sans nœud GPU, nous créons le VM Scale Set, mais avons un SKU différent pour éviter les problèmes de disponibilité de zone/SKU. Ce runbook remplace la SKU par une SKU GPU et ajoute un nœud.

Important :

Ne mettez pas à l’échelle le VMSS GPU initial créé avant d’exécuter ce runbook si le déploiement initial a été créé sans nœuds GPU.

Utilisation

Pour utiliser ce runbook, procédez comme suit :

1. Accédez au groupe de ressources dans lequel vous avez déployé Automation Suite, puis identifiez et sélectionnez Compte d’automatisation.
2. Sélectionnez Runbooks , puis le runbook AddGPUNode .
3. Fournissez un nom à l'UGS souhaitée et sélectionnez Démarrer.

Paramètres :

skuName – la SKU des nœuds GPU VMSS.

Valeurs autorisées :

• Standard_NC8as_T4_v3
• Standard_NC12s_v3
• Standard_NC24s_v3

RegisterAiCenterExternalOrchestrator

Description

Le runbook enregistre AI Center auprès de l'instance externe d'Orchestrator fournie au moment du déploiement.

Utilisation

Le document expose un seul paramètre obligatoire, IdentityToken, qui est un jeton d'accès à l'installation généré par le service Identity externe. Étant donné que le jeton a une courte disponibilité du jeton (environ 1 à 2 heures), nous vous recommandons de le générer juste avant d’exécuter le runbook. Pour obtenir des instructions, consultez la section Clé d'installation.

BackupCluster

Description

The BackupCluster runbook helps you back up you cluster.

Utilisation

1. Accédez au groupe de ressources dans lequel vous avez déployé Automation Suite, puis identifiez et sélectionnez Compte d'automatisation.

   

2. Sélectionnez Runbooks , puis le runbook BackupCluster .

   

3. Attribuez un nom à la sauvegarde que vous souhaitez créer.

   

4. Pour démarrer une opération de sauvegarde pour le cluster Automation Suite, sélectionnez le bouton Démarrer en haut de la page.

   

5. Une fois que le statut de la tâche de runbook est Completed , l'opération de sauvegarde est terminée. Si le statut de la tâche de runbook est Failed , vous pouvez consulter les journaux du compte de stockage pour plus d'informations.

   

GetAllBackups

Description

The GetAllBackups runbook helps you view a list of all available backups, both scheduled and manual.

RestoreClusterInitialize, RestoreSnapshot

Description

Ces runbooks vous aident à effectuer une restauration du cluster.

Utilisation

Remarque :

Lors du démarrage du processus de restauration, nous plaçons le cluster en mode maintenance. Une fois le processus de restauration réussi, nous sortons le cluster du mode de maintenance.

Pour effectuer une opération de restauration, procédez comme suit :

1. Identify the restore files you want to use. To do this, navigate to your Automation Suite deployment Automation Account, and run the GetAllBackups runbook.

   

   

2. Lorsque la tâche de runbook est terminée, consultez le bas de l'onglet Sortie (Output) pour obtenir une liste des sauvegardes disponibles. Sélectionnez celui que vous souhaitez utiliser dans l'opération de restauration et copiez-le.

3. Navigate back to the Automation Account and run the RestoreClusterInitialize runbook. For the parameter, paste the name of the previously copied backup file. At this point, the restore process is started.

   

4. The RestoreSnapshot job is started automatically. When the job is done, the restore process is complete.

   Remarque :

   Les journaux sont présents dans le compte de stockage (se terminant par st ), dans le conteneur des sauvegardes, sous le dossier restores/<backup-name>/ , où backup-name est le nom de la sauvegarde utilisée pour effectuer la restauration.

5. After a restore, you should confirm that the cluster is in a good state (see Validating the installation or any ArgoCD troubleshooting link). After this, you have the option to enable the backup on the cluster by running the RestoreClusterFinalize runbook with the same parameter as in the previous step. This enables backups for the cluster.

Résolution des problèmes

• Si une machine virtuelle ne parvient pas à rejoindre le cluster Automation Suite, une annulation sera tentée. Les machines virtuelles nouvellement créées suivront les mêmes étapes qu'une suppression de nœud habituelle (cordon, drain, arrêt du service rke, suppression du nœud du cluster et suppression des machines virtuelles). Vous pouvez trouver les journaux de la procédure de jointure du nœud dans le compte de stockage, à l'intérieur du conteneur de journaux , dans des objets blob comme infra-<hostname>.log .
• In case of a failure while deleting nodes, any runbook will stop and display the logs for the step that failed. Fix the issue, complete the process manually or using the RemoveNodes runbook. You can find all the logs in the storage account, inside the logs container, as follows:
  • Cordon et vidange – <timestamp>-<runbook_abreviation>-drain_nodes.log
  • Arrêter le service rke – <timestamp>-<runbook_abreviation>-stop_rke.log
  • Supprimer le nœud du cluster – <timestamp>-<runbook_abreviation>-remove_nodes.log
• En cas d’expiration du délai, vous devez attendre que l'exécution de l'étape soit terminée, vérifier les journaux et terminer le processus manuellement ou à l’aide du runbook RemoveNodes . Tous les runbooks utilisent la fonctionnalité Azure Run Command pour exécuter du code dans le contexte des machines virtuelles. L'une des limitations de cette méthode est qu'elle ne renvoie pas le statut de l'exécution. Par conséquent, les étapes de bouclage, de drainage et d'arrêt du service rke s'exécutent de manière asynchrone et le statut est conservé avec des objets blob au format suivant : <timestamp>-<runbook_abreviation>-<step_name>.<success/fail>.