Ce guide vous 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.
Créer une instance dupliquée pour une instance
Console Google Cloud
Dans la console Google Cloud , accédez à la page "Instances Filestore".
Cliquez sur l'ID de l'instance que vous souhaitez répliquer.
Dans la section Description, 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 à 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 encourageons vivement les utilisateurs à 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=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
Vous devez installer et initialiser gcloud CLIafin 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
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
Dans la console Google Cloud , accédez à la page "Instances Filestore".
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, c'est-à-dire le 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 \
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
Vous devez installer et initialiser gcloud CLIafin 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
Lister toutes les instances d'un projet
Console Google Cloud
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
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
Vous devez installer et initialiser gcloud CLIafin 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-
.
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
Dans la console Google Cloud , accédez à la page "Instances Filestore".
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 \
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
Vous devez installer et initialiser gcloud CLIafin 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 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
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.Cliquez sur l'ID de l'instance à supprimer.
Cliquez sur Supprimer.
gcloud
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.
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 \
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
Vous devez installer et initialiser gcloud CLIafin 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
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 :
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 leaderboard 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.