Gerenciar a replicação de instâncias

Neste guia, mostramos como usar a replicação de instâncias do Filestore.

Antes de começar

Conclua as etapas de configuração necessárias para usar o Filestore. A cota para instâncias varia de acordo com o projeto, a região e o nível. Verifique se você tem o suficiente para concluir essas tarefas. Para mais informações, consulte Cotas ou Solicitar um aumento de cota.
Se você ainda não tiver feito isso, crie uma instância do Filestore. No contexto deste guia, essa é a instância de origem.

Observação: a replicação de instâncias está disponível para níveis de serviço regionais, zonais e empresariais.

Criar uma réplica de instância

Console do Google Cloud

No console do Google Cloud , acesse a página Instâncias do Filestore.

Acesse "Instâncias"
Clique no ID da instância que você quer replicar.
Clique na guia Replicações.
Clique em Criar réplica.
Clique no link da documentação para analisar o objetivo do ponto de recuperação (RPO) compatível e clique em Próxima.
Preencha todos os campos obrigatórios e opcionais conforme necessário.
- A capacidade especificada precisa ser maior ou igual à da origem.
- As especificações a seguir precisam corresponder à instância de origem:
  - Nível de serviço, incluindo o intervalo de capacidade
  - Protocolo do Filestore
- Para reduzir o risco de perda de dados, escolha uma região e uma zona exclusivas da origem.
Clique em Próxima.
Revise os detalhes e clique em Próxima.
Clique em Criar.
Aguarde a conclusão da operação. Quando terminar, a réplica será listada na instância de origem na página Instâncias.
Clique no ID da instância da réplica para ver os detalhes.

gcloud

Para criar uma instância de réplica, execute o comando 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 \

Em que:

INSTANCE_ID pelo nome da instância que você quer criar, como my-replica.
SOURCE_INSTANCE com o nome e o local da instância de origem para a qual você quer criar uma réplica. Por exemplo, projects/my-genomics-project/locations/us-east1-b/instances/my-genomics-instance.
PROJECT_ID com o ID do projeto do Google Cloud projeto em que a instância de origem está localizada.
LOCATION pelo local onde você quer que a instância de réplica resida, como us-central1-a. Se a origem estiver em um nível de serviço zonal, especifique uma região e uma zona para a réplica.
NETWORK com o nome da rede que você quer usar, como default.
TIER com o nível de serviço de que você precisa, como ZONAL. O nível e o intervalo de capacidade precisam corresponder à origem.
FILE_SHARE_NAME é o nome que você especifica para o compartilhamento de arquivos NFS que é exibido pela instância, como vol1.
FILE_SHARE_SIZE com o tamanho que você quer para o compartilhamento de arquivos, como 1.25TiB.

API REST

Ter CLI gcloud instalada e inicializada , o que permite gerar um token de acesso para o cabeçalho Authorization.

Use cURL para chamar a 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"
```
Em que:
- TIER é o nome do nível de serviço que você quer usar para a réplica. Por exemplo, REGIONAL.
- NETWORK é o nome da rede que você quer usar para a réplica. Por exemplo, default. Use a mesma rede da origem.
- SHARE_NAME é o nome do compartilhamento de arquivos; Por exemplo, vol1.
- CAPACITY é o tamanho, em GiB, que você quer alocar para a réplica. Por exemplo, 1024. A capacidade precisa ser maior ou igual à da instância de origem.
- PROJECT é o nome do projeto em que sua réplica vai residir. Por exemplo, my-genomics-project. A origem e a réplica precisam estar no mesmo projeto.
- ACTIVE_LOCATION é o local onde a origem reside. Por exemplo, us-east1.
- ACTIVE_NAME é o nome da instância que você quer replicar. Por exemplo, my-genomics-instance.
- DESCRIPTION é uma descrição da instância de réplica que você quer criar. Por exemplo, My genomics replica.
- REPLICA_LOCATION é o local onde você quer que a réplica fique. Por exemplo, us-central1.
- REPLICA_INSTANCE_NAME é o nome da instância de réplica que você quer criar. Por exemplo, my-genomics-replica.

Ver o status da réplica

Console do Google Cloud

No console do Google Cloud , acesse a página Instâncias do Filestore.

Acesse "Instâncias"
Clique no ID da réplica que você quer visualizar.
Na seção Descrição, clique na guia Replicações.
Aqui você pode conferir o Status da réplica e o Último ponto de sincronização, um carimbo de data/hora da última vez que uma cópia completa dos seus dados foi copiada para a réplica.

gcloud

Para ver informações sobre uma instância específica, execute o comando instances describe:

gcloud filestore instances describe INSTANCE_ID \
    --project=PROJECT_ID \
    --location=LOCATION \

Em que:

INSTANCE_ID com o ID da instância do Filestore que você quer visualizar, como genomics-instance.
PROJECT_ID é o ID do projeto do Google Cloud que contém a instância do Filestore.

LOCATION pelo local em que a instância reside, como us-east1-b.

A resposta ao comando instances describe é semelhante a qualquer um dos exemplos a seguir.

Este exemplo de resposta mostra uma instância de origem com a replicação de instância ativada. Observe que a função especificada é 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

Este exemplo de resposta mostra uma instância de réplica que foi promovida a uma instância regular. Observe que a replicação não está especificada porque ainda não foi ativada:

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

Este exemplo de resposta mostra uma réplica que foi pareada com uma instância ativa. Observe que a função está listada como 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

Ter CLI gcloud instalada e inicializada , o que permite gerar um token de acesso para o cabeçalho Authorization.

Use cURL para chamar a 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"
```
Em que:
- PROJECT é o nome do projeto em que a instância está localizada. Por exemplo, my-genomics-project.
- LOCATION é o local em que a instância está. Por exemplo, us-west1-a.
- INSTANCE_NAME é o nome da instância que você quer visualizar. Por exemplo, my-genomics-instance.

Listar todas as réplicas em um projeto

Console do Google Cloud

No console do Google Cloud , acesse a página Instâncias do Filestore.

Acesse "Instâncias"

As réplicas são listadas nas instâncias de origem associadas.

gcloud

Para ver uma lista de todas as instâncias no projeto, execute o comando instances list:

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

Em que:

PROJECT-ID com o ID do projeto que você quer visualizar.

A resposta retorna uma lista de instâncias e réplicas, semelhante a esta:

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

Ter CLI gcloud instalada e inicializada , o que permite gerar um token de acesso para o cabeçalho Authorization.

Use cURL para chamar a 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"
```
Em que:
- PROJECT é o nome do projeto em que a instância está localizada. Por exemplo, my-genomics-project.
- LOCATION é o local que você quer pesquisar. Para pesquisar todas as instâncias em qualquer local dentro de um projeto, use -.

Pausar replicação

Console do Google Cloud

No console do Google Cloud , acesse a página Instâncias do Filestore.

Acesse "Instâncias"
Clique no ID da instância da réplica que você quer usar.
Na seção Descrição, clique na guia Replicações.
Na seção Detalhes da instância ativa, clique em Pausar replicação.
Leia o alerta antes de continuar e confirme clicando em Pausar replicação.

O status da replicação muda para Pausando. Depois que a operação for concluída, o Status da replicação vai mudar para Pausado e mostrará a data em que a réplica foi pausada.

gcloud

Para pausar uma instância de réplica, execute o comando gcloud filestore instances pause-replica.

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

Em que:

INSTANCE_ID com o ID da instância do Filestore que você quer pausar, como my-replica.
PROJECT_ID é o ID do projeto do Google Cloud que contém a instância do Filestore.
LOCATION com o local em que a réplica reside, como us-central1.

Quando concluída, a seguinte resposta ou semelhante é retornada:

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

Ter CLI gcloud instalada e inicializada , o que permite gerar um token de acesso para o cabeçalho Authorization.

Use cURL para chamar a 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"
```
Em que:
- PROJECT é o nome do projeto em que sua réplica está localizada. Por exemplo, my-genomics-project.
- LOCATION é o local onde a réplica reside. Por exemplo, us-west1-a.
- REPLICA_NAME é o nome da instância que você quer pausar. Por exemplo, my-genomics-replica.

Retomar replicação

Console do Google Cloud

No console do Google Cloud , acesse a página Instâncias do Filestore.

Acesse "Instâncias"
Clique no ID da instância da réplica que você quer usar.
Na seção Descrição, clique na guia Replicações.
Na seção Detalhes da instância ativa, clique em Retomar replicação.
Leia o alerta antes de continuar e confirme inserindo resume no campo indicado.

O status da replicação muda para Retomando. Depois que a operação for concluída, o Status da replicação vai mudar para Pronto.

gcloud

Para retomar uma instância de réplica, execute o comando gcloud filestore instances resume-replica.

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

Em que:

INSTANCE_ID pelo ID da instância de réplica do Filestore que você quer retomar, como my-replica.
PROJECT_ID com o ID do projeto do Google Cloud projeto que contém a instância de réplica do Filestore.
LOCATION com o local em que a réplica reside, como us-central1.

Quando concluída, a seguinte resposta ou semelhante é retornada:

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

Ter CLI gcloud instalada e inicializada , o que permite gerar um token de acesso para o cabeçalho Authorization.

Use cURL para chamar a 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"
```
Em que:
- PROJECT é o nome do projeto em que sua réplica está localizada. Por exemplo, my-genomics-project.
- LOCATION é o local onde a réplica reside. Por exemplo, us-west1-a.
- REPLICA_NAME é o nome da instância que você quer retomar. Por exemplo, my-genomics-replica.

Interromper a replicação e promover a réplica

Nesta seção, você vai interromper a replicação entre as instâncias ativa e em espera. Essa ação promove a réplica a uma instância normal.

Essa operação é irreversível e precisa ser usada com cuidado.
Depois de promovido a uma instância regular, o recurso pode ser pareado com uma nova réplica.
O failback não é automático. Depois que a operação para interromper a replicação for concluída, os administradores precisarão reconectar os aplicativos à nova instância de origem. Para mais informações, consulte Promover réplica.

Console do Google Cloud

No console do Google Cloud , acesse a página Instâncias do Filestore.

Acesse "Instâncias"
Clique no ID da instância da réplica que você quer usar.
Clique em Interromper replicação.
Leia o alerta antes de continuar.

Impedir a replicação vai interromper a sincronização de dados permanentemente e converter as instâncias ativas e em espera em instâncias comuns. As mudanças feitas depois do último ponto de sincronização registrado não serão replicadas. Essa ação é irreversível.
Insira o ID da instância da réplica e clique em Interromper replicação.
Aguarde a conclusão da operação.

gcloud

Para promover uma instância de réplica, execute o comando gcloud filestore instances promote-replica (em inglês).

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

Em que:

INSTANCE_ID com o ID da instância do Filestore que você quer promover, como my-replica.
PROJECT_ID é o ID do projeto do Google Cloud que contém a instância do Filestore.
LOCATION com o local em que a réplica reside, como us-central1.

Quando concluída, a seguinte resposta ou semelhante é retornada:

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

Ter CLI gcloud instalada e inicializada , o que permite gerar um token de acesso para o cabeçalho Authorization.

Use cURL para chamar a 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"
```
Em que:
- PROJECT é o nome do projeto em que sua réplica está localizada. Por exemplo, my-genomics-project.
- LOCATION é o local onde a réplica reside. Por exemplo, us-west1-a.
- REPLICA_NAME é o nome da instância que você quer promover. Por exemplo, my-genomics-replica.

Excluir uma instância de réplica

Console do Google Cloud

No console do Google Cloud , acesse a página de instâncias do Filestore.

Acesse "Instâncias"

As réplicas são listadas nas instâncias de origem associadas. Se você não encontrar uma réplica, consulte os comandos gcloud para essa tarefa.
Clique no código da instância que você quer excluir.
Clique em Excluir.

gcloud

Para conferir uma lista de todas as instâncias, incluindo réplicas, no projeto, execute o comando instances list:
```
gcloud filestore instances list
    --project=PROJECT_ID \
```
Em que:
- PROJECT_ID com o ID do projeto que você quer visualizar.
Copie os detalhes da instância que você quer excluir.

Para excluir uma instância, execute o comando filestore instances delete.

gcloud filestore instances delete INSTANCE_ID \
    --location=LOCATION \

Em que:

INSTANCE_ID com o ID da instância do Filestore que você quer excluir, como my-replica.
LOCATION com o local em que a réplica reside, como us-central1-a.

API REST

Ter CLI gcloud instalada e inicializada , o que permite gerar um token de acesso para o cabeçalho Authorization.

Use cURL para chamar a 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"
```
Em que:
- PROJECT é o nome do projeto em que a instância está localizada. Por exemplo, my-genomics-project.
- LOCATION é o local em que a instância está. Por exemplo, us-west1-a.
- INSTANCE_NAME é o nome da instância que você quer excluir. Por exemplo, my-genomics-instance.

Monitorar a replicação de instâncias

Console do Google Cloud

Para ver as métricas de replicação de instâncias do Filestore em um painel do Cloud Monitoring, siga estas etapas:

Antes de começar, verifique se você tem acesso às seguintes funções:
- Visualizador de monitoramento
- Editor de monitoramento
Para saber como conceder acesso a esses papéis, consulte Conceder acesso ao Cloud Monitoring.
No console Google Cloud , acesse a página do Metrics explorer:
Acesse o Metrics Explorer

Se você usar a barra de pesquisa para encontrar essa página, selecione o resultado com o subtítulo Monitoring.
Clique na seção expansível Selecionar uma métrica.
No campo Filtrar por nome do recurso ou da métrica, digite filestore e selecione a seção expansível Instância do Filestore.
Selecione a seção expansível Instância e clique em RPO.
A métrica de RPO times_since_last_replication é exibida. Essa métrica fica disponível alguns minutos após a conclusão da sincronização inicial dos dados replicados.

A seguir

Saiba mais sobre a replicação de instâncias.
Leia a documentação de referência sobre replicação de instâncias.

Gerenciar a replicação de instâncias Mantenha tudo organizado com as coleções Salve e categorize o conteúdo com base nas suas preferências.

Antes de começar

Criar uma réplica de instância

Console do Google Cloud

gcloud

API REST

Ver o status da réplica

Console do Google Cloud

gcloud

API REST

Listar todas as réplicas em um projeto

Console do Google Cloud

gcloud

API REST

Pausar replicação

Console do Google Cloud

gcloud

API REST

Retomar replicação

Console do Google Cloud

gcloud

API REST

Interromper a replicação e promover a réplica

Console do Google Cloud

gcloud

API REST

Excluir uma instância de réplica

Console do Google Cloud

gcloud

API REST

Monitorar a replicação de instâncias

Console do Google Cloud

A seguir

Gerenciar a replicação de instâncias