Configurer la réplication des instances

Ce guide vous explique comment utiliser la réplication d'instances Filestore.

Avant de commencer

  1. Suivez les étapes de configuration requises pour utiliser Filestore. Le quota d'instances varie en fonction du projet, de la région et du niveau. Assurez-vous d'en avoir suffisamment pour effectuer ces tâches. Pour en savoir plus, consultez Quotas ou Demander une augmentation de quota.

  2. Si vous ne l'avez pas déjà fait, créez une instance Filestore. Dans le contexte de ce guide, il s'agit de l'instance source.

Créer une instance dupliquée pour une instance

Console Google Cloud

  1. Dans la console Google Cloud , accédez à la page "Instances Filestore".

    Accéder aux instances Filestore

  2. Cliquez sur l'ID de l'instance que vous souhaitez répliquer.

  3. Dans la section Description, cliquez sur l'onglet Réplications.

  4. Cliquez sur Créer une instance répliquée.

  5. Cliquez sur le lien vers la documentation pour consulter l'objectif de point de récupération (RPO) compatible, puis cliquez sur Suivant.

  6. Renseignez tous les champs obligatoires et facultatifs selon vos besoins.

    • La capacité spécifiée doit être supérieure ou égale à la source.
    • Les spécifications suivantes doivent correspondre à l'instance source :
    • Pour réduire le risque de perte de données, nous encourageons vivement les utilisateurs à choisir une région et une zone uniques à la source.
  7. Cliquez sur Suivant.

  8. Vérifiez les détails, puis cliquez sur Suivant.

  9. Cliquez sur Créer.

  10. Patientez jusqu'à la fin de l'opération. Une fois l'opération terminée, la réplique est listée sous l'instance source sur la page Instances.

  11. Cliquez sur l'ID d'instance du réplica pour afficher ses détails.

gcloud

  1. Vous pouvez créer une instance répliquée en exécutant la commande filestore instances create.

    gcloud filestore instances create INSTANCE-ID \
        --source-instance=SOURCE-INSTANCE \
        --project=PROJECT-ID \
        --location=LOCATION \
        --network=name="NETWORK" \
        --tier=TIER \
        --file-share=name="FILE-SHARE-NAME",capacity=FILE-SHARE-SIZE \
    

Remplacez les éléments suivants :

  • INSTANCE-ID par le nom de l'instance que vous souhaitez créer, par exemple my-replica.
  • SOURCE-INSTANCE par le nom et l'emplacement de l'instance source pour laquelle vous souhaitez créer un réplica. Exemple : projects/my-genomics-project/locations/us-east1-b/instances/my-genomics-instance.
  • PROJECT-ID par l'ID du projet Google Cloud dans lequel se trouve l'instance source.
  • LOCATION par l'emplacement où vous souhaitez que l'instance de réplica réside, par exemple us-central1-a. Si la source se trouve dans un niveau de service zonal, vous devez spécifier une région et une zone pour le réplica.
  • NETWORK par le nom du réseau que vous souhaitez utiliser, tel que default.
  • TIER par le niveau de service dont vous avez besoin, par exemple ZONAL. Le niveau et la plage de capacité doivent correspondre à la source.
  • FILE-SHARE-NAME est le nom que vous spécifiez pour le partage de fichiers NFS qui est diffusé à partir de l'instance, tel que vol1.
  • FILE-SHARE-SIZE par la taille souhaitée pour le partage de fichiers, par exemple 1.25TB. La capacité doit être supérieure ou égale à celle de la source et, le cas échéant, à la même plage de capacité.

API REST

  1. Vous devez installer et initialiser gcloud CLIafin de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API Filestore :

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      -d '{"tier": "TIER",
          "networks": { "network": "NETWORK" },
          "file_shares": {"name": "SHARE_NAME","capacity_gb": "CAPACITY"},
          "replication": {"replicas":[{"peer_instance": "projects/PROJECT/locations/ACTIVE_LOCATION/instances/ACTIVE_NAME"}], "role":"standby"},
          "description": "DESCRIPTION" }' \
      "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/REPLICA_LOCATION/instances?instanceId=REPLICA_INSTANCE_NAME"
    

    Où :

    • TIER correspond au nom du niveau de service que vous souhaitez utiliser pour le réplica. Exemple :REGIONAL
    • NETWORK est le nom du réseau que vous souhaitez utiliser pour la réplique. Exemple :default Vous devez utiliser le même réseau que la source.
    • SHARE_NAME est le nom du partage de fichiers. Exemple : vol1.
    • CAPACITY correspond à la taille, en Gio, que vous souhaitez allouer au réplica. Exemple :1024 La capacité doit être supérieure ou égale à celle de l'instance source.
    • PROJECT est le nom du projet dans lequel résidera votre réplica. Exemple :my-genomics-project La source et la réplique doivent se trouver dans le même projet.
    • ACTIVE_LOCATION est l'emplacement où se trouve la source. Exemple :us-east1
    • ACTIVE_NAME est le nom de l'instance que vous souhaitez répliquer. Exemple :my-genomics-instance
    • DESCRIPTION est une description de l'instance répliquée que vous souhaitez créer. Exemple : My genomics replica.
    • REPLICA_LOCATION correspond à l'emplacement où vous souhaitez que l'instance dupliquée réside. Exemple :us-central1
    • REPLICA_INSTANCE_NAME est le nom de l'instance répliquée que vous souhaitez créer. Exemple :my-genomics-replica

Afficher l'état d'une instance

Console Google Cloud

  1. Dans la console Google Cloud , accédez à la page "Instances Filestore".

    Accéder aux instances Filestore

  2. Cliquez sur l'ID de l'instance de réplica que vous souhaitez afficher.

  3. Dans la section Description, cliquez sur l'onglet Réplications.

  4. Vous pouvez y consulter l'état de la réplique et le dernier point de synchronisation, c'est-à-dire le code temporel de la dernière copie complète de vos données dans la réplique.

gcloud

  1. Pour afficher des informations sur une instance spécifique, exécutez la commande instances describe :

    gcloud filestore instances describe INSTANCE-ID \
        --project=PROJECT-ID \
        --location=LOCATION \
    

Remplacez les éléments suivants :

  • INSTANCE-ID par l'ID de l'instance Filestore que vous souhaitez afficher, par exemple genomics-instance.
  • PROJECT-ID par l'ID du projet Google Cloud contenant l'instance Filestore.
  • LOCATION par l'emplacement où réside l'instance, par exemple us-east1-b.

    La réponse à la commande instances describe ressemble à l'un des exemples suivants.

    Cet exemple de réponse montre une instance source avec la réplication d'instance activée. Notez que le rôle spécifié est ACTIVE :

    createTime: '2024-06-17T22:17:26.475900265Z'
    fileShares:
    - capacityGb: '1024'
      name: vol1
    name: projects/genomics-project/locations/us-east1-b/instances/genomics-instance-source
    networks:
    - connectMode: DIRECT_PEERING
      ipAddresses:
      - 172.27.220.2
      modes:
      - MODE_IPV4
      network: default
      reservedIpRange: 172.27.220.0/26
    replication:
      replicas:
      - peerInstance: projects/genomics-project/locations/us-central1-a/instances/genomics-instance-replica
        state: READY
      role: ACTIVE
    state: READY
    tier: ZONAL
    

    Cet exemple de réponse montre une instance répliquée qui a été promue en instance régulière. Notez que la réplication n'est pas spécifiée, car elle n'a pas encore été activée :

    createTime: '2024-06-20T17:11:56.048062134Z'
    fileShares:
    - capacityGb: '1024'
      name: vol1
    name: projects/genomics-project/locations/us-west2-a/instances/genomics-instance-replica
    networks:
    - connectMode: DIRECT_PEERING
      ipAddresses:
      - 10.155.90.194
      network: default
      reservedIpRange: 10.155.90.192/26
    satisfiesPzi: true
    state: READY
    tier: ZONAL
    

    Cet exemple de réponse montre une instance répliquée associée à une instance active. Notez que le rôle est indiqué comme STANDBY :

    createTime: '2024-06-21T04:15:21.721579074Z'
    fileShares:
    - capacityGb: '1280'
      name: vol1
    name: projects/genomics-project/locations/us-west1-a/instances/genomics-replica
    networks:
    - connectMode: DIRECT_PEERING
      ipAddresses:
      - 10.153.44.194
      network: default
      reservedIpRange: 10.153.44.192/26
    replication:
      replicas:
      - peerInstance: projects/genomics-project/locations/us-west2-a/instances/genomics-instance
        state: READY
      role: STANDBY
    satisfiesPzi: true
    state: READY
    tier: ZONAL
    

API REST

  1. Vous devez installer et initialiser gcloud CLIafin de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API Filestore :

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      GET "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"

    Où :

    • PROJECT est le nom du projet dans lequel se trouve votre instance. Exemple :my-genomics-project
    • LOCATION est l'emplacement de votre instance. Exemple :us-west1-a
    • INSTANCE_NAME est le nom de l'instance que vous souhaitez afficher. Exemple :my-genomics-instance

Lister toutes les instances d'un projet

Console Google Cloud

  1. Dans la console Google Cloud , accédez à la page "Instances Filestore".

    Accéder aux instances Filestore

    Les réplicas sont listés sous leurs instances sources associées.

gcloud

  1. Pour afficher la liste de toutes les instances du projet, exécutez la commande instances list :

    gcloud filestore instances list
        --project=PROJECT-ID \
    

    Remplacez les éléments suivants :

    • PROJECT-ID par l'ID du projet que vous souhaitez afficher.

    La réponse renvoie un résultat semblable à celui-ci :

    INSTANCE_NAME                       LOCATION     TIER      CAPACITY_GB  FILE_SHARE_NAME  IP_ADDRESS     STATE  CREATE_TIME
    genomics-source-1                   us-east1-b   ZONAL     1024         vol1             172.27.220.2   READY  2024-06-17T22:17:26
    genomics-source-1-replica           us-west1-a   ZONAL     1024         vol1             10.142.57.194  READY  2024-06-17T23:47:19
    

API REST

  1. Vous devez installer et initialiser gcloud CLIafin de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API Filestore :

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      GET "https://file.googleapis.com/v1/projects/PROJECT/locations/LOCATION/instances"

    Où :

    • PROJECT est le nom du projet dans lequel se trouve votre instance. Exemple :my-genomics-project
    • LOCATION est l'emplacement que vous souhaitez rechercher. Pour rechercher toutes les instances dans n'importe quel emplacement d'un projet, utilisez -.

Interrompre la réplication et promouvoir une instance répliquée

Dans cette section, vous allez interrompre la réplication entre les instances active et de secours. Cette action promeut le réplica en instance standard.

  • Cette opération est irréversible et doit être utilisée avec précaution.

  • Une fois la ressource promue en instance régulière, elle peut être associée à une nouvelle réplique.

  • Le failback n'est pas automatique. Une fois l'opération de suppression de la réplication terminée, les administrateurs doivent reconnecter leurs applications à la nouvelle instance source. Pour en savoir plus, consultez Promouvoir une instance répliquée.

Console Google Cloud

  1. Dans la console Google Cloud , accédez à la page "Instances Filestore".

    Accéder aux instances Filestore

  2. Cliquez sur l'ID de l'instance répliquée que vous souhaitez utiliser.

  3. Cliquez sur Arrêter la réplication.

  4. Lisez l'alerte avant de continuer.

    Interrompre la réplication arrêtera définitivement la synchronisation des données et convertira les instances actives et de secours en instances régulières. Toutes les modifications apportées après le dernier point de synchronisation enregistré ne seront pas répliquées. Cette action est irréversible.

  5. Saisissez l'ID d'instance du réplica, puis cliquez sur Interrompre la réplication.

  6. Attendez que l'opération se termine.

gcloud

  1. Vous pouvez promouvoir une instance répliquée en exécutant la commande gcloud filestore instances promote-replica.

    gcloud filestore instances promote-replica INSTANCE-ID \
        --project=PROJECT-ID \
        --location=LOCATION \
    

Remplacez les éléments suivants :

  • INSTANCE-ID par l'ID de l'instance Filestore que vous souhaitez promouvoir, par exemple my-replica.
  • PROJECT-ID par l'ID du projet Google Cloud contenant l'instance Filestore.
  • LOCATION par l'emplacement de la réplique, par exemple us-central1.

Une fois l'opération terminée, la réponse suivante ou une réponse similaire s'affiche :

capacityGb: '1024'
capacityStepSizeGb: '256'
createTime: '2024-06-20T17:11:56.048062134Z'
fileShares:
- capacityGb: '1024'
  name: vol1
maxCapacityGb: '9984'
maxShareCount: '1'
name: projects/genomics-project/locations/us-west2-a/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.155.90.194
  network: default
  reservedIpRange: 10.155.90.192/26
protocol: NFS_V3
replication:
  replicas:
  - lastActiveSyncTime: '2024-06-21T00:13:23Z'
    peerInstance: projects/genomics-project/locations/us-east1-b/instances/my-source
  role: STANDBY
satisfiesPzi: true
state: PROMOTING
tier: ZONAL

API REST

  1. Vous devez installer et initialiser gcloud CLIafin de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API Filestore :

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      -d '{}' "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/REPLICA_NAME:promoteReplica"

    Où :

    • PROJECT est le nom du projet dans lequel se trouve votre réplica. Exemple :my-genomics-project
    • LOCATION correspond à l'emplacement de la réplique. Exemple :us-west1-a
    • REPLICA_NAME est le nom de l'instance que vous souhaitez promouvoir. Exemple :my-genomics-replica

Supprimer une instance

Console Google Cloud

  1. Dans la console Google Cloud , accédez à la page "Instances Filestore".

    Accéder aux instances Filestore

    Les réplicas sont listés sous leurs instances sources associées. Si vous ne voyez pas de réplica, consultez les commandes gcloud pour cette tâche.

  2. Cliquez sur l'ID de l'instance à supprimer.

  3. Cliquez sur Supprimer.

gcloud

  1. Pour afficher la liste de toutes les instances du projet, exécutez la commande instances list :

    gcloud filestore instances list
        --project=PROJECT-ID \
    

    Remplacez les éléments suivants :

    • PROJECT-ID par l'ID du projet que vous souhaitez afficher.
  2. Copiez les détails de l'instance que vous souhaitez supprimer.

  3. Vous pouvez supprimer une instance en exécutant la commande filestore instances delete.

    gcloud filestore instances delete INSTANCE-ID \
        --location=LOCATION \
    

Remplacez les éléments suivants :

  • INSTANCE-ID par l'ID de l'instance Filestore que vous souhaitez supprimer, par exemple my-replica.
  • LOCATION par l'emplacement de la réplique, par exemple us-central1-a.

API REST

  1. Vous devez installer et initialiser gcloud CLIafin de générer un jeton d'accès pour l'en-tête Authorization.

  2. Utilisez cURL pour appeler l'API Filestore :

    curl -s \
      --header "Authorization: Bearer $(gcloud auth print-access-token)" \
      --header "Content-Type: application/json" \
      --request DELETE "https://file.googleapis.com/v1beta1/projects/PROJECT/locations/LOCATION/instances/INSTANCE_NAME"

    Où :

    • PROJECT est le nom du projet dans lequel se trouve votre instance. Exemple :my-genomics-project
    • LOCATION est l'emplacement de votre instance. Exemple :us-west1-a
    • INSTANCE_NAME est le nom de l'instance que vous souhaitez supprimer. Exemple :my-genomics-instance

Surveiller la réplication d'instances

Console Google Cloud

Pour afficher les métriques de réplication des instances Filestore dans un tableau de bord Cloud Monitoring, procédez comme suit :

  1. Avant de commencer, assurez-vous d'avoir accès aux rôles suivants :

    • Lecteur Monitoring
    • Éditeur Monitoring

    Pour savoir comment accorder l'accès à ces rôles, consultez Accorder l'accès à Cloud Monitoring.

  2. Dans la console Google Cloud , accédez à la page  Explorateur de métriques :

    Accéder à l'explorateur de métriques

    Si vous utilisez la barre de recherche pour trouver cette page, sélectionnez le résultat dont le sous-titre est Monitoring.

  3. Cliquez sur la section extensible Sélectionner une métrique.

  4. Dans le champ Filtrer par nom de ressource ou de métrique, saisissez filestore et sélectionnez la section extensible Instance Filestore.

  5. Sélectionnez la section extensible Instance, puis cliquez sur RPO.

  6. La métrique RPO times_since_last_replication s'affiche. Cette métrique devient disponible plusieurs minutes après la fin de la synchronisation initiale des données répliquées.

Étapes suivantes