automation-suite
2023.4
false
Important :
Veuillez noter que ce contenu a été localisé en partie à l’aide de la traduction automatique.
Guide d'installation d'Automation Suite sur Linux
Last updated 2 oct. 2024

Étape 3 : étapes post-déploiement

Remarque : Si vous utilisez Azure Bastion, sachez que les commandes copier-coller réparties sur plusieurs lignes (en utilisant \) peuvent ne pas fonctionner comme prévu. Pour vous assurer que les nouvelles lignes soient 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

Le processus d'installation génère des certificats auto-signés en votre nom. Ces certificats sont conformes à la norme FIPS 140-2. 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.

Si vous avez installé Automation Suite sur un hôte compatible FIPS 140-2 et que vous souhaitez mettre à jour les certificats, assurez-vous qu'ils sont compatibles avec FIPS 140-2.

Pour obtenir des instructions, consultez la Gestion des certificats.

Activation de FIPS 140-2

Après avoir terminé une installation d'Automation Suite à l'aide du modèle de déploiement Azure, vous pouvez activer FIPS 140-2 sur vos machines. Pour obtenir des instructions, consultez Sécurité et conformité.

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 cliquez sur Conteneurs ( Conteneurs) . Vos options sont les drapeaux et les 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

L'URL pour accéder à ArgoCD. Ceci est disponible dans le réseau virtuel. L'accès externe à cette URL doit être configuré comme décrit dans : Étape 4 : Configuration du 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

LonghornMonitoringURLL' URL vers les outils de surveillance Longhorn.

GrafanaMonitoringURL

L'URL vers les outils de surveillance Grafana.

PrometheusMonitoringURL

L'URL vers les outils de surveillance Prometheus.

AlertmanagerMonitoringURL

L'URL vers les outils de surveillance Alertmanager.

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. Cliquez sur le nom de la VM que vous souhaitez connecter.


  5. Cliquez sur le bouton Connecter (Connect), puis choisissez Bastion dans le menu déroulant.


  6. Saisissez les informations d'identification fournies dans le cadre du déploiement (paramètres Nom de l'administrateur (Admin Username) et Mot de passe de l'administrateur (Admin Password), que vous trouverez dans les informations d’identification Keyvault sous Secrets), puis cliquez sur Connecter (Connect).


Exigences DNS

Comme mentionné dans Étape 1 : Préparation de votre déploiement Azure, le déploiement d'Automation Suite sur Azure crée un équilibreur de charge avec une adresse IP publique et une étiquette DNS associée. Cette étiquette DNS appartient à Microsoft.

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.

Voir Étape 4 : Configuration du DNS pour plus de détails.

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

Accéder au portail d'administration du cluster

Le portail d'administration du cluster est un emplacement centralisé où vous pouvez trouver toutes les ressources nécessaires pour terminer une installation d'Automation Suite et effectuer les opérations post-installation courantes. Pour plus de détails, consultez la section Premiers pas avec le portail d'administration du cluster.

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 : vous n'avez besoin d'aucune information d'identification pour accéder au portail d'administration du cluster.

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. Accédez à l'URL suivante : https://alm.${Loadbalancer_dns}, où <loadbalancer_dns> est le libellé DNS de l'équilibreur de charge et se trouve sous Sorties (Outputs). Notez que vous devez configurer l'accès externe à cette URL tel que décrit à l'Étape 4 : Configuration du 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ès aux outils de surveillance

Pour accéder aux outils de surveillance pour la première fois, connectez-vous en tant qu'administrateur avec les informations d'identification par défaut suivantes :

  • Nom d’utilisateur : admin
  • Mot de passe : pour récupérer le mot de passe, exécutez la commande suivante :
    kubectl get secrets/dex-static-credential -n uipath-auth -o "jsonpath={.data['password']}" | base64 -dkubectl get secrets/dex-static-credential -n uipath-auth -o "jsonpath={.data['password']}" | base64 -d

Pour mettre à jour le mot de passe par défaut utilisé pour accéder aux outils de surveillance, procédez comme suit :

  1. Exécutez la commande suivante en remplaçant newpassword par votre nouveau mot de passe :
    password="newpassword"
    password=$(echo -n $password | base64)
    kubectl patch secret dex-static-credential -n uipath-auth --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]"password="newpassword"
    password=$(echo -n $password | base64)
    kubectl patch secret dex-static-credential -n uipath-auth --type='json' -p="[{'op': 'replace', 'path': '/data/password', 'value': '$password'}]"
  2. Exécutez la commande suivante en remplaçant <cluster_config.json> par le chemin d'accès à votre fichier de configuration :
    /opt/UiPathAutomationSuite/UiPath_Installer/install-uipath.sh -i <cluster_config.json> -f -o output.json --accept-license-agreement/opt/UiPathAutomationSuite/UiPath_Installer/install-uipath.sh -i <cluster_config.json> -f -o output.json --accept-license-agreement

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 (Scale Set) approprié et cliquez sur Mise à l'échelle (Scaling).


  3. Modifiez le champ Nombre d'instances (Instance count) en utilisant le curseur ou le champ de saisie situé à côté, puis cliquez sur Enregistrer (Save).
    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

Après avoir effectué une mise à niveau du cluster Automation Suite, les déploiements de modèles Azure nécessitent quelques modifications pour garantir qu'un nouveau nœud rejoint correctement le cluster. Pour automatiser les modifications, nous vous recommandons d'utiliser le script dédié. Pour obtenir des instructions, consultez la documentation relatives au modèle de déploiement Azure.

Opérations du cycle de vie des machines virtuelles Azure

Astuce :

Azure accorde une fenêtre de 15 minutes au maximum pour préparer l'arrêt, tandis que l'arrêt normal d'un nœud Automation Suite varie de 20 minutes (pour les nœuds d'agent et d'agent GPU) à quelques heures (dans le cas des nœuds de serveur).

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

Les runbooks InstanceRefresh, SupprimerNœuds (RemoveNodes), RemoveServers et CheckServerZoneResilience sont pris en charge uniquement pour les déploiements de production multi-nœuds compatibles haute disponibilité.

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 : les runbooks InstanceRefresh, RemoveNodes et RemoveServers sont affectés par un problème entraînant l'échec des opérations de suppression de nœud si les pods de service Process Mining (AirFlow) et/ou Automation Suite Robots sont planifiés sur le nœud.

Travailleurs hybrides

Tous nos comptes de stockage et serveurs SQL ont des points de terminaison privés. Un groupe de travailleurs hybrides exécute les opérations automatisées existantes afin qu'elles fonctionnent sans problème.

Un travailleur hybride est une machine virtuelle qui se trouve à l'intérieur du VNET et sur laquelle les différentes automatisations seront exécutées.

La machine virtuelle est généralement un Standard_D2s_v3 ou un Standard_F2s_v2, selon ce que vous choisissez pour vos machines virtuelles de serveur et si le quota le permet. La machine virtuelle est arrêtée lorsque le déploiement est terminé pour minimiser les coûts.

Les runbooks sont divisés en deux catégories : les runbooks réguliers et les runbooks hybrides. Vous utilisez les runbooks réguliers pour démarrer une opération et rassembler toutes les données. Le runbook normal démarre ensuite la machine virtuelle Worker hybride et le runbook hybride, ce dernier terminant l'opération.

Une fois l'opération terminée, vous pouvez désactiver la machine virtuelle Hybrid Worker pour limiter les coûts.

Le tableau suivant décrit la répartition du runbook :

Runbooks réguliers

Runbooks hybrides

AddGpuNodeHybridAddGpuNode
BackupClusterHybridBackupCluster
GetAllBackupsHybridGetAllBackups
InstanceRefreshHybridInstanceRefresh (+HybridCheckServerZoneRezilience)
RegisterAiCenterExternalOrchestratorHybridRegisterAiCenterExternalOrchestrator
RemoveNodesHybridRemoveNodes
RemoveServersHybridRemoveServers
RestoreClusterInitializeHybridRestoreClusterInitialize + HybridRestoreClusterSnapshot
ValidateFullInstallExécution à la fin du déploiement pour valider l’installation complète.

InstanceRefresh

Description

Le runbook InstanceRefresh présente les cas d'utilisation suivants :

  • 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. Accédez au portail Azure et recherchez la ressource appelée ActualisationInstance (IInstanceRefresh.
  2. Cliquez sur le bouton Démarrer pour ouvrir la liste des paramètres. Complétez les paramètres en considérant :
    • 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).

      Cliquez sur le bouton OK pour démarrer le runbook.



Détails de l'implémentation

Le runbook InstanceRefresh est un wrapper pour le runbook RemoveNodes. Par conséquent, le statut est suivi lors de l'exécution de RemoveNodes. Il met à jour toutes les versions du système d'exploitation VMSS (si nécessaire) et extrait, en fonction des paramètres reçus, le nom d'hôte de l'opération de rotation des nœuds et les transmet à RemoveNodes. Si le cluster comporte exactement trois serveurs, le runbook InstanceRefresh crée trois nouveaux serveurs ; sinon, RemoveNodes gère la mise à l'échelle pour maintenir au moins un serveur dans chaque zone de disponibilité à tout moment.

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'ordinateur des nœuds que vous souhaitez supprimer. Pour ce faire, accédez à un VMSS et cliquez sur Instances dans la section Settings .


  2. Accédez au portail Azure et recherchez la ressource appelée SupprimerNœuds (RemoveNodes).
  3. Cliquez sur le bouton Démarrer pour ouvrir la liste des paramètres. Complétez 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 et THREESERVERSSCENARIO sont des indicateurs renseignés par le wrapper ActualisationInstance (InstanceRefresh).

    Cliquez sur 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 de 3 heures. Il supprime ou rétablit le premier ou les deux premiers nœuds (le numéro est choisi de façon à satisfaire la contrainte de nombre impair de serveurs) 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

Le runbook RemoveServers présente le cas d’utilisation suivant :

  • supprimer des serveurs du cluster Automation Suite.

Utilisation

  1. Accédez au portail Azure et recherchez la ressource appelée RemoveServers.
  2. Cliquez sur le bouton Démarrer pour ouvrir la liste des paramètres. Complétez 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 dépasser le délai d’expiration du partage équitable .


Détails de l'implémentation

Le runbook RemoveServers supprime le nombre de serveurs reçus en tant que paramètre des zones de disponibilité contenant le plus de machines virtuelles.

CheckServerZoneResilience

Description

Le runbook CheckServerZoneResilience met à l'échelle le VMSS du serveur et utilise le runbook RemoveServers pour équilibrer les serveurs entre les zones de disponibilité. Cela fait partie du flux ActualisationInstance (InstanceRefresh) et ne doit pas être exécuté manuellement.

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 du 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-le et cliquez sur Compte d'automatisation (Automation Account).
  2. Cliquez sur Runbooks, puis sur le runbook AddGPUNode.
  3. Fournissez un nom à l'UGS souhaitée et cliquez sur Démarrer (Start).

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é (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

Le runbook BackupCluster vous aide à sauvegarder votre cluster.

Utilisation

  1. Accédez au groupe de ressources dans lequel vous avez déployé Automation Suite, puis identifiez-le et cliquez sur Compte d'automatisation (Automation Account).


  2. Cliquez sur Runbooks, puis sur 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, cliquez sur le bouton Démarrer (Start) 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

Le runbook GetAllBackups vous permet d'afficher une liste de toutes les sauvegardes disponibles, planifiées et manuelles.



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 de 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. Identifiez les fichiers de restauration que vous souhaitez utiliser. Pour ce faire, accédez à votre compte d'automatisation de déploiement Automation Suite et exécutez le runbook GetAllBackups.




  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 celle que vous souhaitez utiliser dans l'opération de restauration et copiez-la.
  3. Revenez au compte d'automatisation et exécutez le runbook RestoreClusterInitialize. Pour le paramètre, collez le nom du fichier de sauvegarde précédemment copié. À ce stade, le processus de restauration démarre.


  4. La tâche RestaurerInstantané (RestoreSnapshot) démarre automatiquement. Lorsque la tâche est terminée, le processus de restauration est terminé.
    Remarque : les journaux sont présents dans le compte de stockage (se terminant par st), dans le conteneur de sauvegardes, dans le dossier restores/<backup-name>/, où backup-name est le nom de la sauvegarde utilisée pour effectuer la restauration.
  5. Après une restauration, vous devez confirmer que le cluster est en bon état (voir la section Validation de l'installation (Validating the installation) ou tout lien de résolution des problèmes ArgoCD). Après cela, vous avez la possibilité d'activer la sauvegarde sur le cluster en exécutant le runbook RestoreClusterFinalize avec le même paramètre qu'à l'étape précédente. Cela active les sauvegardes pour le 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.
  • En cas d’échec lors de la suppression de nœuds, tout runbook s’arrêtera et affichera les journaux de l’étape qui a échoué. Résolvez le problème, terminez le processus manuellement ou à l'aide du runbook RemoveNodes. Vous pouvez trouver tous les journaux du compte de stockage, à l'intérieur du conteneur de journaux , comme suit :

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

Cette page vous a-t-elle été utile ?

Obtenez l'aide dont vous avez besoin
Formation RPA - Cours d'automatisation
Forum de la communauté UiPath
Uipath Logo White
Confiance et sécurité
© 2005-2024 UiPath Tous droits réservés.