Gérer la réplication d'instance

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

Avant de commencer

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

Remarque : La réplication d'instances est disponible pour les niveaux de service régionaux, zonaux et Enterprise.

Créer une instance répliquée

Console Google Cloud

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

Accéder à la page "Instances"
Cliquez sur l'ID de l'instance que vous souhaitez répliquer.
Cliquez sur l'onglet Réplications.
Cliquez sur Créer une instance répliquée.
Cliquez sur le lien vers la documentation pour consulter l'objectif de point de récupération (RPO) compatible, puis cliquez sur Suivant.
Renseignez tous les champs obligatoires et facultatifs selon vos besoins.
- La capacité spécifiée doit être supérieure ou égale à celle de la source.
- Les spécifications suivantes doivent correspondre à l'instance source :
  - Niveau de service, y compris la plage de capacité
  - Protocole Filestore
- Pour réduire le risque de perte de données, nous vous recommandons de choisir une région et une zone uniques à la source.
Cliquez sur Suivant.
Vérifiez les détails, puis cliquez sur Suivant.
Cliquez sur Créer.
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.
Cliquez sur l'ID d'instance du réplica pour afficher ses détails.

gcloud

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=projects/PROJECT_ID/locations/LOCATION/instances/SOURCE_INSTANCE \
    --project=PROJECT_ID \
    --location=LOCATION \
    --network=name="NETWORK" \
    --tier=TIER \
    --file-share=name="FILE_SHARE_NAME",capacity=FILE_SHARE_SIZE \

Où :

INSTANCE_ID par le nom de l'instance que vous souhaitez créer, par exemple my-replica.
SOURCE_INSTANCE avec 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 correspond à la taille souhaitée pour le partage de fichiers, par exemple 1.25TiB.

API REST

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

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 est le 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 de 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 des réplicas

Console Google Cloud

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

Accéder à la page "Instances"
Cliquez sur l'ID de l'instance de réplica que vous souhaitez afficher.
Dans la section Description, cliquez sur l'onglet Réplications.
Vous pouvez y consulter l'état de la réplique et le dernier point de synchronisation, qui correspond au code temporel de la dernière copie complète de vos données dans la réplique.

gcloud

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 \

Où :

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

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

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

Répertorier toutes les répliques d'un projet

Console Google Cloud

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

Accéder à la page "Instances"

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

gcloud

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

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

Où :

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

La réponse renvoie une liste d'instances et de répliques, semblable à la suivante :

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

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

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

Mettre en pause la réplication

Console Google Cloud

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

Accéder à la page "Instances"
Cliquez sur l'ID de l'instance répliquée que vous souhaitez utiliser.
Dans la section Description, cliquez sur l'onglet Réplications.
Dans la section Détails de l'instance active, cliquez sur Mettre en veille la réplication.
Lisez l'alerte avant de continuer, puis confirmez en cliquant sur Mettre en veille la réplication.

L'état de la réplication passe à Mise en veille. Une fois l'opération terminée, l'état de la réplication passe à Suspendu et la date à laquelle la réplique a été suspendue s'affiche.

gcloud

Vous pouvez suspendre une instance répliquée en exécutant la commande gcloud filestore instances pause-replica.

  gcloud filestore instances pause-replica INSTANCE_ID \
      --project=PROJECT_ID \
      --location=LOCATION \

Où :

INSTANCE_ID par l'ID de l'instance Filestore que vous souhaitez suspendre, 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.

Si l'opération réussit, la réponse suivante ou une réponse similaire s'affiche :

createTime: '2025-12-22T14:03:33.727531128Z'
customPerformanceSupported: true
description: Replica of active, us-east1-b
fileShares:
- capacityGb: '1024'
  name: share
name: projects/genomics-project/locations/us-west2-a/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.229.150.130
  modes:
  - MODE_IPV4
  network: default
  reservedIpRange: 10.229.150.128/26
performanceLimits:
  maxIops: '12000'
  maxReadIops: '12000'
  maxReadThroughputBps: '125829120'
  maxWriteIops: '4000'
  maxWriteThroughputBps: '104857600'
protocol: NFS_V3
replication:
  replicas:
  - peerInstance: projects/genomics-project/locations/us-east1-b/instances/my-source
    state: PAUSED
    stateUpdateTime: '2025-12-22T14:24:27.558413891Z'
  role: STANDBY
state: READY
tier: REGIONAL

API REST

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

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:pauseReplica"
```
Où :
- PROJECT est le nom du projet dans lequel se trouve votre réplica. Exemple :my-genomics-project
- LOCATION correspond à l'emplacement où réside la réplique. Exemple :us-west1-a
- REPLICA_NAME est le nom de l'instance que vous souhaitez suspendre. Exemple :my-genomics-replica

Reprendre la réplication

Console Google Cloud

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

Accéder à la page "Instances"
Cliquez sur l'ID de l'instance répliquée que vous souhaitez utiliser.
Dans la section Description, cliquez sur l'onglet Réplications.
Dans la section Détails de l'instance active, cliquez sur Reprendre la réplication.
Lisez l'alerte avant de continuer, puis confirmez en saisissant resume dans le champ prévu à cet effet.

L'état de la réplication passe à Reprise. Une fois l'opération terminée, l'état de la réplication passe à Prêt.

gcloud

Vous pouvez réactiver une instance répliquée en exécutant la commande gcloud filestore instances resume-replica.

  gcloud filestore instances resume-replica INSTANCE_ID \
      --project=PROJECT_ID \
      --location=LOCATION \

Où :

INSTANCE_ID par l'ID de l'instance répliquée Filestore que vous souhaitez réactiver, par exemple my-replica.
PROJECT_ID par l'ID du projet Google Cloud contenant l'instance répliquée Filestore.
LOCATION par l'emplacement de la réplique, par exemple us-central1.

Si l'opération réussit, la réponse suivante ou une réponse similaire s'affiche :

createTime: '2025-12-22T14:03:33.727531128Z'
customPerformanceSupported: true
description: Replica of active, us-central1
fileShares:
- capacityGb: '1024'
  name: share
name: projects/genomics-project/locations/us-central1/instances/my-replica
networks:
- connectMode: DIRECT_PEERING
  ipAddresses:
  - 10.229.150.130
  modes:
  - MODE_IPV4
  network: default
  reservedIpRange: 10.229.150.128/26
performanceLimits:
  maxIops: '12000'
  maxReadIops: '12000'
  maxReadThroughputBps: '125829120'
  maxWriteIops: '4000'
  maxWriteThroughputBps: '104857600'
protocol: NFS_V3
replication:
  replicas:
  - peerInstance: projects/genomics-project/locations/us-central1/instances/my-source
    state: READY
    stateUpdateTime: '2025-12-22T14:24:27.558413891Z'
  role: STANDBY
state: READY
tier: REGIONAL

API REST

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

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:resumeReplica"
```
Où :
- PROJECT est le nom du projet dans lequel se trouve votre réplica. Exemple :my-genomics-project
- LOCATION correspond à l'emplacement où réside la réplique. Exemple :us-west1-a
- REPLICA_NAME est le nom de l'instance que vous souhaitez réactiver. Exemple :my-genomics-replica

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 promue en instance standard, la ressource peut être associée à une nouvelle réplique.
Le failback n'est pas automatique. Une fois l'opération d'arrêt 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

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

Accéder à la page "Instances"
Cliquez sur l'ID de l'instance répliquée que vous souhaitez utiliser.
Cliquez sur Arrêter la réplication.
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.
Saisissez l'ID d'instance du réplica, puis cliquez sur Interrompre la réplication.
Attendez que l'opération se termine.

gcloud

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 \

Où :

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.

Si l'opération réussit, 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

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

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 où réside 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 répliquée

Console Google Cloud

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

Accéder à la page "Instances"

Les répliques sont listées sous leurs instances sources associées. Si vous ne voyez pas de réplica, consultez les commandes gcloud pour cette tâche.
Cliquez sur l'ID de l'instance à supprimer.
Cliquez sur Supprimer.

gcloud

Pour afficher la liste de toutes les instances, y compris les répliques, du projet, exécutez la commande instances list :
```
gcloud filestore instances list
    --project=PROJECT_ID \
```
Où :
- PROJECT_ID par l'ID du projet que vous souhaitez afficher.
Copiez les détails de l'instance que vous souhaitez supprimer.
Vous pouvez supprimer une instance en exécutant la commande filestore instances delete.
```
gcloud filestore instances delete INSTANCE_ID \
    --location=LOCATION \
```

Où :

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

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

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 correspond au 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 :

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.
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.
Cliquez sur la section extensible Sélectionner une métrique.
Dans le champ Filtrer par nom de ressource ou de métrique, saisissez filestore et sélectionnez la section extensible Instance Filestore.
Sélectionnez la section extensible Instance, puis cliquez sur RPO.
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

En savoir plus sur la réplication d'instance
Consultez la documentation de référence sur la réplication d'instances.

Gérer la réplication d'instance Restez organisé à l'aide des collections Enregistrez et classez les contenus selon vos préférences.

Avant de commencer

Créer une instance répliquée

Console Google Cloud

gcloud

API REST

Afficher l'état des réplicas

Console Google Cloud

gcloud

API REST

Répertorier toutes les répliques d'un projet

Console Google Cloud

gcloud

API REST

Mettre en pause la réplication

Console Google Cloud

gcloud

API REST

Reprendre la réplication

Console Google Cloud

gcloud

API REST

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

Console Google Cloud

gcloud

API REST

Supprimer une instance répliquée

Console Google Cloud

gcloud

API REST

Surveiller la réplication d'instances

Console Google Cloud

Étapes suivantes

Gérer la réplication d'instance