Restauration de la sauvegarde

Restaurer un cluster Automation Suite à partir d'une sauvegarde d'instantané et réactiver la sauvegarde une fois la restauration terminée.

Remarque :

Une fois qu'un cluster est restauré, la sauvegarde d'instantané n'est pas activée. Pour l'activer après la restauration, reportez-vous à la section Activation de l'instantané de sauvegarde.

La restauration du cluster ne restaure pas les sources de données externes telles que SQL Server, le magasin d'objets ou le registre compatible OCI. Assurez-vous de restaurer ces sources de données dans l'instantané pertinent.

Pour restaurer le cluster, procédez comme suit :

1. Installez l'infrastructure de cluster sur tous les nœuds de serveur. Plus de détails ici

   Remarque :

   Le matériel que vous fournissez pour le cluster de restauration doit être similaire au matériel du cluster de sauvegarde. Pour plus de détails, consultez la section Configuration matérielle et logicielle requise.

2. Configurez l'instantané sur le cluster restauré. Plus de détails ici

3. Sélectionnez l'instantané à restaurer. Plus de détails ici

4. Restaurez les données et les paramètres. Plus de détails ici

Étape 1 : Installation de l'infrastructure de cluster

Préparation

1. Téléchargez le programme d'installation. Vous pouvez trouver ce fichier dans le package as-installer.zip . Pour obtenir des instructions, consultez la section Téléchargement des packages d'installation.

2. Dans les environnements hors ligne, vous devez fournir un registre externe compatible OCI ou un registre temporaire. Notez que la configuration du registre doit rester la même que celle du cluster d'origine. Pour configurer le registre, consultez les instructions suivantes:

   • Configuration du registre externe compatible OCI
   • Configuration du registre Docker temporaire. Choisissez cette option uniquement si vous n'avez pas utilisé de registre externe compatible OCI avant que le sinistre ne se produise.

3. Préparez le fichier de configuration et rendez-le disponible sur tous les nœuds du cluster. Pour préparer le fichier de configuration, suivez l'une des étapes suivantes :

   • Option A : réutilisez le fichier cluster_config.json que vous avez appliqué au cluster avant que le sinistre ne se produise ;
   • Option B : Créez un fichier cluster_config.json minimum avec les paramètres requis, comme indiqué dans l'exemple suivant :

     {
       "fixed_rke_address": "fqdn",
       "fqdn": "fqdn",
       "rke_token": "guid",
       "profile": "cluster_profile",
       "external_object_storage": { 
         "enabled": false 
       },
       "install_type": "offline or online",
       "snapshot": {
         "enabled": true,
         "nfs": {
           "server": "nfs_server_endpoint",
           "location": "nfs_server_mountpoint"
         }
       },
       "proxy": { "enabled": false }
     }
     

     Remarque :

     Cet exemple utilise des paramètres pour une configuration de sauvegarde basée sur NFS. Si vous utilisez une configuration de sauvegarde différente, vous devez remplacer la section liée à NFS par les paramètres spécifiques à votre configuration de sauvegarde.

La table suivante décrit tous les paramètres à inclure dans le fichier minimum cluster_config.json. Assurez-vous de fournir les mêmes valeurs de paramètre que celles utilisées dans le cluster d'origine. Vous pouvez modifier les valeurs des paramètres après la restauration.

Important :

Dans les environnements hors ligne, en plus de configurer les paramètres cluster_config.json répertoriés dans la table suivante, vous devez également fournir la configuration du registre externe compatible OCI. Pour plus de détails, consultez la section Configuration du registre externe compatible OCI.

Paramètre	Valeur (Value)
fqdn	Nom de domaine complet du cluster Automation Suite. La valeur doit être la même que l'ancien nom de domaine complet. L'indication d'une valeur FQDN différente peut entraîner l'échec de la restauration.
fixed_rke_address	L’adresse fixe utilisée pour l’enregistrement des nœuds de l’équilibrage de charges et des requêtes de l’API kube. Si l'équilibreur de charge est configuré comme recommandé, la valeur doit être la même que celle de l'élément fqdn . Sinon, utilisez la valeur fqdn du premier nœud de serveur. Pour plus d'informations, consultez la section Configuration de l'équilibreur de charge .
rke_token	Utilisez un GUID nouvellement généré ici. Il s'agit d'une clé secrète pré-partagée, spécifique au cluster. Elle est nécessaire pour tous les nœuds rejoignant le cluster.
profile	Définit le profil de l'installation. Les profils disponibles sont : default : profil d'évaluation à nœud unique. ha : profil de production compatible haute disponibilité multi-nœuds.
install_type	Indique le type d'installation que vous prévoyez d'effectuer. Vos options sont les suivantes : online : une installation avec accès à Internet offline : une installation sans accès à Internet
server	Nom de domaine complet ou adresse IP de l'emplacement de stockage d'instantané (par exemple mynfs.mycompany.com ou 192.23.222.81 ).
location	L'emplacement ou le chemin d'accès à l'emplacement de stockage des instantanés.
infra.pod_log_path	Le chemin d'accès au répertoire personnalisé utilisé pour les journaux de pod. Ceci est requis si le cluster a été configuré avec un chemin de journal de pod personnalisé.
proxy	Ce paramètre n'est obligatoire que si le proxy est activé. Pour plus de détails, consultez la section Facultatif : configuration du serveur proxy.

Pour plus de détails sur la configuration de cluster_config.json, reportez-vous à Manual: Advanced installation experience.

Exécution

Installation de l'infrastructure de cluster sur le nœud du serveur principal

Pour installer l'infrastructure sur le nœud de cluster de restauration principal, exécutez les commandes suivantes :

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json --accept-license-agreement --restore

Important :

Copiez cluster_config.json depuis le nœud de serveur principal vers les nœuds de serveur/d'agents restants. L'étape d'installation de l'infrastructure sur le nœud du serveur principal ajoute des valeurs supplémentaires dont les nœuds restants ont besoin.

Installation de l'infrastructure de cluster sur les serveurs secondaires

Pour installer l'infrastructure sur les serveurs secondaires :

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j server --accept-license-agreement --restore

Installer l'infrastructure sur toutes les machines agent

Pour installer l'infrastructure sur les nœuds de l'agent :

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j agent --accept-license-agreement --restore

Hydratation du registre intégré au cluster pour les installations hors ligne

Cette étape est requise uniquement si vous utilisez un registre intégré au cluster pour les installations hors ligne. Vous devez hydrater le registre avant de déclencher la restauration, en utilisant la commande suivante :

./bin/uipathctl rke2 registry hydrate-registry /opt/UiPathAutomationSuite/cluster_config.json

Installation de l'infrastructure de cluster sur des nœuds de service

Installation de l'infrastructure de cluster sur les nœuds Robots Automation Suite

Pour installer l'infrastructure de cluster sur des nœuds Robots Automation Suite :

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j asrobots --accept-license-agreement --restore

Installation de l'infrastructure de cluster sur les nœuds GPU

Pour installer l'infrastructure de cluster sur les nœuds GPU :

cd <installer directory>
./bin/uipathctl rke2 install -i ../../cluster_config.json -o output.json -j gpu --accept-license-agreement --restore

Étape 2 : Préparation du cluster pour la restauration

Une fois l'infrastructure installée, vous devez préparer l'instantané du cluster pour la restauration. En fonction de votre scénario, vous devez exécuter les commandes suivantes :

• Si vous utilisez un magasin d'objets externe :

  ./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --only velero --versions versions/helm-charts.json
  

• Si vous utilisez un ceph-objectstore intégré au cluster :

  ./bin/uipathctl manifest apply /opt/UiPathAutomationSuite/cluster_config.json --only base,rook-ceph-operator,rook-ceph-object-store,velero --versions versions/helm-charts.json
  

Pour configurer la sauvegarde du cluster restauré, suivez les étapes de la section Configurer l'instantané du cluster .

Étape 3 : Sélection de l'instantané à restaurer

Après avoir configuré l'instantané, répertoriez les instantanés existants et décidez de celui que vous souhaitez utiliser comme point de restauration.

Étape 4 : Restauration des données et des paramètres

Pour restaurer vers un cluster précédent, indiquez le nom de l'instantané à partir duquel vous souhaitez effectuer la conversion à l'aide de l'indicateur --from-snapshot <snapshot-name> .

./bin/uipathctl snapshot restore create <restore_name> --from-snapshot <snapshot_name>

La commande déclenche le processus de restauration. Le processus restaure d'abord la sauvegarde, puis exécute des tâches liées à Automation Suite. Lorsque le stockage Ceph dans le cluster est configuré, il restaure également les données Ceph avant de synchroniser les applications.

Si le processus de restauration échoue, vous pouvez réexécuter la commande restore create avec un nouveau nom. Cette nouvelle tentative reprend le processus de restauration à partir de l'étape où il a échoué lors de la tentative précédente.

Pour vérifier l'état du processus de restauration, exécutez la commande suivante :

./bin/uipathctl snapshot restore history

Cette commande affiche uniquement l'état de la restauration de l'état du cluster (ressources Kubernetes).

Pour surveiller la restauration des données du magasin d’objets et les tâches de post-restauration effectuées par Automation Suite, vérifiez la sortie du terminal de la commande de l’instantané restore create .

Si vous ne spécifiez pas le nom de l'instantané, le cluster restaure le dernier instantané réussi. Consultez la liste des instantanés pour les instantanés disponibles.

Restauration de cluster_config.json

Après la récupération du cluster Automation Suite, vous souhaiterez peut-être récupérer le fichier cluster_config.json pour une utilisation future, telle que l'ajout de nouveaux nœuds au cluster, la mise à niveau, etc.

Pour restaurer cluster_config.json, procédez comme suit :

1. Vous devez trouver la dernière configuration appliquée en exécutant la commande suivante :

   ./bin/uipathctl manifest list-revisions
   

   L’exemple suivant est un exemple de sortie de commande :

   VERSION  UPDATED                        STATUS
   1        2024-11-07 00:46:41 +0000 UTC  successful
   2        2024-11-07 01:14:20 +0000 UTC  successful
   3        2024-11-07 01:23:23 +0000 UTC  successful
   

2. Sélectionnez le numéro de VERSION déployé avant la création de la sauvegarde et exécutez la commande suivante pour récupérer le fichier cluster_config.json :

   ./bin/uipathctl manifest get-revision --version <VERSION>
   

   L’exemple suivant est un exemple de sortie de commande :

   ./bin/uipathctl manifest get-revision --version 1 > ./cluster_config.json
   

Ajout de certificats CA au magasin approuvé

Après avoir restauré le cluster, assurez-vous d'ajouter vos certificats CA au magasin approuvé des machines virtuelles restaurées. Pour en savoir plus, consultez :

• Accéder au certificat TLS
• Ajout du certificat CA au magasin d'approbations hôte

Récupérer le nouveau mot de passe de surveillance

Remarque :

Cette section s'applique uniquement si vous utilisez la solution de surveillance intégrée.

Après avoir restauré un cluster Automation Suite, vous devez récupérer le nouveau mot de passe de surveillance. Pour cela, suivez les étapes décrites dans la section Accès aux outils de surveillance.

Activation d'AI Center sur le cluster restauré

Après avoir restauré un cluster Automation Suite avec AI Center™ activé, suivez les étapes de la procédure Activation d'AI Center sur le cluster restauré .

Génération d’un nouveau ticket Kerberos

Si l'authentification Kerberos est configurée, vous devez vous assurer que le ticket Kerberos n'a pas expiré.

Pour générer un nouveau ticket Kerberos, exécutez les commandes suivantes :

kubectl get cronjobs -A | grep kerberos //to identify the job with name kerberos-tgt-update
kubectl create job --from=cronjob/<cron-job-name> <new_job_name> -n <namespace>

Assurez-vous de remplacer <cron-job-name>, <new_job_name> et <namespace> par le nom réel de votre tâche cron, le nom prévu pour la nouvelle tâche et votre espace de noms réel respectivement.