Configuration du magasin de sauvegarde

Référence pour la configuration de l'emplacement du magasin de sauvegarde via cluster_config.json pour les sauvegardes planifiées et à la demande dans Automation Suite.

Fournir la configuration du magasin de sauvegarde

Pour sauvegarder et restaurer votre cluster, vous devez fournir l'emplacement des instantanés de cluster au cluster Automation Suite via cluster_config.json.

Apportez les modifications suivantes à votre cluster_config.json avant d'activer une sauvegarde planifiée ou de prendre une sauvegarde à la demande.

Vous pouvez fournir ces informations lors de l'installation du cluster Automation Suite ou ultérieurement, en tant qu'opération post-installation, lors de l'activation ou de la sauvegarde du cluster.

exemple cluster_config.json

• Pour la sauvegarde du serveur NFS, utilisez l'exemple cluster_config.json suivant :

{
 //... cluster_config.json
  "snapshot": {
    "enabled": true,
    "nfs": {
      "server": "nfs_server_endpoint",
      "location": "nfs_server_mountpoint"
    }
  }
}

Paramètres cluster_config.json

Clé (Key)	Valeur (Value)
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	Chemin du serveur NFS, qui est le chemin de montage créé selon les instructions de l ' Étape 2 : Configuration du chemin de montage . Assurez-vous qu'il dispose des autorisations suffisantes et que la structure du répertoire existe déjà. Assurez-vous que le serveur SQL est accessible depuis tous les nœuds. Lors de l'étape suivante, uipathctl monte automatiquement ce chemin. Vous n’avez pas besoin de monter ce chemin manuellement. Lorsque vous utilisez Amazon EFS comme stockage compatible NFS, vous devez définir la valeur location sur le répertoire racine ( / ) du montage EFS. L'utilisation de sous-répertoires ( tels que /asbackup ) n'est pas prise en charge et entraînera l'échec de l'opération de montage.

• Pour la sauvegarde d'un magasin d'objets externe, utilisez les échantillons cluster_config.json suivants :

{
//... cluster_config.json
"snapshot": {
    "enabled": true,
    "external_object_storage": {
      "bucket_name": "<s3_bucket_used_for_backup>",
      "storage_type": "s3",
      "region": "<s3_bucket_region>"
    }
  }
}

Le tableau suivant décrit les paramètres cluster_config.json pour configurer un magasin de sauvegarde AWS S3.

Clé (Key)	Valeur (Value)
bucket_name	Nom du compartiment S3 pour stocker l'instantané.
arn	ARN pour la connexion avec le S3. Si le nœud dispose des autorisations nécessaires pour se connecter au magasin d'objets de sauvegarde, l'ARN n'est pas nécessaire. Sinon, créez un rôle IAM avec les autorisations nécessaires et ajoutez l’ARN.
region	Région où le S3 est présent.

{
//... cluster_config.json
"snapshot" : {
  "external_object_storage": {
    "client_secret": "<azure_service_principal_client_secret>", 
    "resource_group": "<azure_resource_group_with_storage_account>", 
    "auth_mode": "ServicePrincipal", 
    "account_name": "<azure_storage_account_name>", 
    "account_key": "<azure_storage_account_key>"
    "bucket_name": "<azure_container_name>",
    "client_id": "<azure_service_principal_id>",
    "subscription_id": "<azure_subscription_id>",
    "cloud_name": "AzurePublicCloud",
  },
  "aks_infra_resource_group":"<azure_infra_resource_group>"
 }
}

Le tableau suivant décrit les paramètres cluster_config.json pour configurer un magasin de sauvegarde Azure.

Clé (Key)	Valeur (Value)
bucket_name	Nom du conteneur dans le compte de stockage Azure pour stocker l'instantané.
resource_group	Groupe de ressources dans lequel le compte de stockage Azure cible pour le stockage de l'instantané est présent.
auth_mode	Doit être défini sur ServicePrincipal.
client_id	ID de client pour l'authentification principale du service.
client_secret	Clé secrète du client pour l'authentification basée sur le principal du service.
account_name	Nom du compte de stockage Azure sur lequel l'instantané est sauvegardé.
account_key	Clé d'accès pour le compte de stockage Azure où l'instantané doit être sauvegardé. Ce paramètre est facultatif.
cloud_name	Valeur par défaut : AzurePublicCloud Remplacez par l'une des éléments suivants, le cas échéant : AzureUSGovernmentCloud, AzureChinaCloud, AzureGermanCloud.
subscription_id	ID d'abonnement où le compte de stockage Azure pour le stockage de la sauvegarde est stocké.
aks_infra_resource_group	Groupe de ressources dans lequel les machines et autres ressources du cluster AKS sont créées. Ceci est généralement conçu et géré par Azure et commence par MC_ Alors que d'autres valeurs peuvent rester les mêmes pendant la sauvegarde et la restauration, cette valeur sera modifiée pendant la restauration. Il doit s'agir du nouveau groupe de ressources dans lequel les ressources Kubernetes du nouveau cluster AKS sont enregistrées.

Remarque :

Pour créer un principal de service pour l’authentification dans Azure, reportez-vous à la documentation Microsoft.

• Pour la sauvegarde sur disque local, utilisez l'exemple cluster_config.json suivant :

{
 //... cluster_config.json
  "snapshot": {
    "enabled": true,
    "local_disk": {
      "path": "/backup"
    }
  }
}

Le tableau suivant décrit les paramètres cluster_config.json pour configurer un magasin de sauvegarde sur disque local.

Clé (Key)	Valeur (Value)
path	Répertoire local pour le stockage des instantanés.

Application de la configuration du magasin de sauvegarde

Après avoir apporté les modifications au cluster_config.json, comme décrit dans la section précédente, exécutez la commande suivante pour appliquer la configuration :

• Pour les configurations de serveur NFS et de disque local :

  ./bin/uipathctl manifest apply cluster_config.json --only velero,rke2-backup-hook --versions versions/helm-charts.json
  

• Pour la configuration d'un magasin d'objets externe :

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