Créer une restauration ultraprécise

Ce document explique comment créer une restauration précise pour une sauvegarde dans Google Distributed Cloud (GDC) avec air gap.

La fonctionnalité de restauration ultraprécise vous permet de restaurer un sous-ensemble de ressources à partir d'une sauvegarde. Cette fonctionnalité vous permet d'affiner le champ d'application de la restauration défini dans le plan de restauration.

Avant de commencer

Assurez-vous de disposer d'une sauvegarde existante. Pour en savoir plus, consultez Planifier un ensemble de sauvegardes.

Demander des rôles IAM

Pour créer une restauration précise pour une sauvegarde, demandez à votre administrateur d'organisation IAM ou à votre administrateur de projet IAM de vous accorder l'un des rôles suivants :

  • Administrateur de sauvegarde de cluster d'utilisateur (user-cluster-backup-admin) : crée, obtient, liste, surveille, met à jour, corrige et supprime des ressources de sauvegarde telles que des plans de sauvegarde et de restauration dans les clusters d'utilisateur. Contactez l'administrateur de l'organisation IAM pour demander ce rôle.

  • Créateur de sauvegardes (backup-creator) : crée, obtient, liste, surveille, met à jour, corrige et supprime les requêtes de sauvegarde manuelle et les requêtes de restauration manuelle. Contactez l'administrateur de projet IAM pour demander ce rôle.

Créer une restauration ultraprécise

Pour créer une restauration avec un filtre précis, procédez comme suit :

  1. Créez les filtres de restauration ultraprécise. Vous pouvez utiliser l'exemple YAML suivant.

    inclusionFilters:
      - groupKind:
          group: foo.io
          kind: Bar
        name: name1
        namespace: ns1
    exclusionFilters:
      - labels:
          key1: value1
          key2: value2
    
  2. Créez une ressource personnalisée ManualRestoreRequest pour planifier des restaurations à partir d'un Backups existant. Voici un exemple de ManualRestoreRequest :

    apiVersion: backup.gdc.goog/v1
    kind: ManualRestoreRequest
    metadata:
      name: RESTORE_NAME
      namespace: PROJECT_NAMESPACE
    spec:
      restoreName: RESTORE_NAME
      restorePlanName: RESTORE_PLAN
      backupName: BACKUP_NAME
      filter:
        FINE_GRAINED_RESTORE_FILTERS
    

Remplacez les éléments suivants :

  • RESTORE_NAME : nom de la restauration que vous souhaitez créer.
  • PROJECT_NAMESPACE : nom de votre projet GDC.
  • RESTORE_PLAN : nom du plan de restauration à partir duquel cette restauration est dérivée.
  • BACKUP_NAME : sauvegarde à restaurer. Cette sauvegarde doit être associée au plan de sauvegarde auquel fait référence le plan de restauration. Pour en savoir plus, consultez Planifier un ensemble de restaurations.
  • FINE_GRAINED_RESTORE_FILTER : filtres de restauration ultraprécis. Pour obtenir des exemples, consultez Exemples de filtres de restauration ultraprécis.

Exemples de filtres de restauration ultraprécise

Les exemples suivants sont fournis au format YAML utilisé par Google Cloud CLI.

Restaurer une seule ressource d'espace de noms

Cet exemple restaure une ressource ConfigMap nommée nginx-vars dans l'espace de noms webserver, en utilisant la restauration précise inclusionFilters pour sélectionner la ressource. Si vous souhaitez choisir des ressources sous le groupe principal, utilisez une chaîne vide pour le champ group.

filter:
  inclusionFilters:
  - groupKind:
      kind: ConfigMap
    name: nginx-vars
    namespace: webserver

Exclure une seule ressource à l'échelle du cluster

Cet exemple restaure toutes les ressources disponibles, à l'exception d'une ressource groupKind nommée sc1, à l'aide de la fonction exclusionFilters de restauration ultraprécise pour exclure la ressource.

filter:
  exclusionFilters:
  - groupKind:
      group: storage.k8s.io
      kind: StorageClass
    name: sc1

Restaurer des ressources avec deux étiquettes

Cet exemple restaure les ressources qui comportent les deux étiquettes key1:value1 et key2:value2, à l'aide de la fonction inclusionFilters de restauration ultraprécise pour sélectionner les ressources.

filter:
  inclusionFilters:
  - labels:
      key1: value1
      key2: value2

Exclure toutes les ressources de certains GroupKind

Cet exemple restaure toutes les ressources disponibles, à l'exception des ressources groupKind de ConfigMap et storage.k8s.io/StorageClass, à l'aide de la fonction exclusionFilters de restauration ultraprécise pour exclure ces deux GroupKind.

filter:
  exclusionFilters:
  - groupKind:
      kind: ConfigMap
  - groupKind:
      group: storage.k8s.io
      kind: StorageClass

Étapes suivantes