Configure a replicação de instâncias

Este guia mostra como usar a replicação de instâncias do Filestore.

Antes de começar

1. Conclua os passos de configuração necessários para usar o Filestore. A quota para instâncias varia consoante o projeto, a região e o nível. Certifique-se de que tem o suficiente para concluir estas tarefas. Para mais informações, consulte Quotas ou Peça um aumento da quota.

2. Se ainda não o fez, crie uma instância do Filestore. No contexto deste guia, esta é a instância de origem.

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

Crie uma réplica para uma instância

Google Cloud consola

1. Na Google Cloud consola, aceda à página de instâncias do Filestore.

   Aceda às instâncias do Filestore

2. Clique no ID da instância da instância que quer replicar.

3. Na secção Descrição, clique no separador Replicações.

4. Clique em Criar réplica.

5. Clique no link da documentação para rever o objetivo do ponto de recuperação (RPO) suportado e clique em Seguinte.

6. Introduza todos os campos obrigatórios e os campos opcionais, conforme necessário.

   • A capacidade especificada tem de ser superior ou igual à origem.
   • As seguintes especificações têm de corresponder à instância de origem:
     • Nível de serviço, incluindo o intervalo de capacidade
     • Protocolo Filestore
   • Para reduzir o risco de perda de dados, os utilizadores são fortemente aconselhados a escolher uma região e uma zona únicas para a origem.

7. Clicar em Seguinte.

8. Reveja os detalhes e clique em Seguinte.

9. Clique em Criar.

10. Aguarde pela conclusão da operação. Quando terminar, a réplica é apresentada na instância de origem na página Instâncias.

11. Clique no ID da instância da réplica para ver os respetivos detalhes.

gcloud

1. Pode criar uma instância de réplica executando o comando 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 \
   

Substitua o seguinte:

• INSTANCE-ID com o nome da instância que quer criar, como my-replica.
• SOURCE-INSTANCE com o nome e a localização da instância de origem para a qual 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 onde a instância de origem está localizada.
• LOCATION com a localização onde quer que a instância da réplica resida, como us-central1-a. Se a origem estiver num nível de serviço zonal, tem de especificar uma região e uma zona para a réplica.
• NETWORK com o nome da rede que quer usar, como default.
• TIER com o nível de serviço de que precisa, como ZONAL. O nível e o intervalo de capacidade têm de corresponder à origem.
• FILE-SHARE-NAME com o nome que especificar para a partilha de ficheiros NFS que é servida a partir da instância, como vol1.
• FILE-SHARE-SIZE com o tamanho que quer para a partilha de ficheiros, como 1.25TB. A capacidade tem de ser igual ou superior à da origem e, se aplicável, ao mesmo intervalo de capacidade.

API REST

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

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

   Onde:

   • TIER é o nome do nível de serviço que quer usar para a réplica. Por exemplo, REGIONAL.
   • NETWORK é o nome da rede que quer usar para a réplica. Por exemplo, default. Tem de usar a mesma rede que a origem.
   • SHARE_NAME é o nome da partilha de ficheiros. Por exemplo, vol1.
   • CAPACITY é o tamanho, em GiB, que quer atribuir à réplica. Por exemplo, 1024. A capacidade tem de ser superior ou igual à da instância de origem.
   • PROJECT é o nome do projeto onde a sua réplica vai residir. Por exemplo, my-genomics-project. A origem e a réplica têm de estar localizadas no mesmo projeto.
   • ACTIVE_LOCATION é a localização onde a origem reside. Por exemplo, us-east1.
   • ACTIVE_NAME é o nome da instância que quer replicar. Por exemplo, my-genomics-instance.
   • DESCRIPTION é uma descrição da instância de réplica que quer criar. Por exemplo, My genomics replica.
   • REPLICA_LOCATION é a localização onde quer que a réplica resida. Por exemplo, us-central1.
   • REPLICA_INSTANCE_NAME é o nome da instância de réplica que quer criar. Por exemplo, my-genomics-replica.

Veja o estado da instância

Google Cloud consola

1. Na Google Cloud consola, aceda à página de instâncias do Filestore.

   Aceda às instâncias do Filestore

2. Clique no ID da instância da réplica que quer ver.

3. Na secção Descrição, clique no separador Replicações.

4. Aqui, pode ver o Estado da réplica e o Ponto de sincronização mais recente, uma data/hora da última vez que foi feita uma cópia completa dos seus dados para a réplica.

gcloud

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

Substitua o seguinte:

• INSTANCE-ID com o ID da instância do Filestore que quer ver, como genomics-instance.
• PROJECT-ID com o ID do projeto do Google Cloud projeto que contém a instância do Filestore.

• LOCATION com a localização onde a instância reside, como us-east1-b.

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

  Este exemplo de resposta mostra uma instância de origem com a replicação de instâncias ativada. Repare 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 normal. Repare que a replicação não está especificada, uma vez que 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 sincronizada com uma instância ativa. Repare 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

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

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

   Onde:

   • PROJECT é o nome do projeto onde a sua instância está localizada. Por exemplo, my-genomics-project.
   • LOCATION é a localização onde a sua instância reside. Por exemplo, us-west1-a.
   • INSTANCE_NAME é o nome da instância que quer ver. Por exemplo, my-genomics-instance.

Apresenta todas as instâncias num projeto

Google Cloud consola

1. Na Google Cloud consola, aceda à página de instâncias do Filestore.

   Aceda às instâncias do Filestore

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

gcloud

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

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

   Substitua o seguinte:

   • PROJECT-ID com o ID do projeto que quer ver.

   A resposta devolve algo semelhante ao seguinte:

   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. Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho Authorization.

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

   Onde:

   • PROJECT é o nome do projeto onde a sua instância está localizada. Por exemplo, my-genomics-project.
   • LOCATION é a localização que quer pesquisar. Para pesquisar todas as instâncias em qualquer localização num projeto, use -.

Interrompa a replicação e promova a réplica

Nesta secção, vai interromper a replicação entre as instâncias ativas e de reserva. Esta ação promove a réplica para uma instância normal.

• Esta operação é irreversível e deve ser usada com cuidado.

• Depois de promovido a uma instância normal, o recurso pode ser sincronizado com uma nova réplica.

• A alternativa não é automática. Quando a operação para interromper a replicação estiver concluída, os administradores têm de voltar a ligar as respetivas aplicações à nova instância de origem. Para mais informações, consulte o artigo Promova réplicas.

Google Cloud consola

1. Na Google Cloud consola, aceda à página de instâncias do Filestore.

   Aceda às instâncias do Filestore

2. Clique no ID da instância da réplica que quer usar.

3. Clique em Interromper replicação.

4. Leia o alerta antes de continuar.

   A interrupção da replicação para a sincronização de dados permanentemente e converte as instâncias ativas e de espera em instâncias normais. As alterações feitas após o último ponto de sincronização registado não são replicadas. Esta ação é irreversível.

5. Introduza o ID da instância da réplica e, de seguida, clique em Interromper replicação.

6. Aguarde pela conclusão bem-sucedida da operação.

gcloud

1. Pode promover uma instância de réplica executando o comando gcloud filestore instances promote-replica.

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

Substitua o seguinte:

• INSTANCE-ID com o ID da instância do Filestore que quer promover, como my-replica.
• PROJECT-ID com o ID do projeto do Google Cloud projeto que contém a instância do Filestore.
• LOCATION com a localização onde a réplica reside, como us-central1.

Quando a operação é concluída com êxito, é devolvida a seguinte resposta ou semelhante:

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. Ter a CLI gcloud instalada e inicializada, o que lhe permite gerar um token de acesso para o cabeçalho Authorization.

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

   Onde:

   • PROJECT é o nome do projeto onde se encontra a sua réplica. Por exemplo, my-genomics-project.
   • LOCATION é a localização onde a réplica reside. Por exemplo, us-west1-a.
   • REPLICA_NAME é o nome da instância que quer promover. Por exemplo, my-genomics-replica.

Elimine uma instância

Google Cloud consola

1. Na Google Cloud consola, aceda à página de instâncias do Filestore.

   Aceda às instâncias do Filestore

   As réplicas são apresentadas nas respetivas instâncias de origem associadas. Se não vir uma réplica, consulte os comandos gcloud para esta tarefa.

2. Clique no ID da instância da instância que quer eliminar.

3. Clique em Eliminar.

gcloud

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

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

   Substitua o seguinte:

   • PROJECT-ID com o ID do projeto que quer ver.

2. Copie os detalhes da instância que quer eliminar.

3. Pode eliminar uma instância executando o comando filestore instances delete.

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

Substitua o seguinte:

• INSTANCE-ID com o ID da instância do Filestore que quer eliminar, como my-replica.
• LOCATION com a localização onde a réplica reside, como us-central1-a.

API REST

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

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

   Onde:

   • PROJECT é o nome do projeto onde a sua instância está localizada. Por exemplo, my-genomics-project.
   • LOCATION é a localização onde a sua instância reside. Por exemplo, us-west1-a.
   • INSTANCE_NAME é o nome da instância que quer eliminar. Por exemplo, my-genomics-instance.

Monitorize a replicação de instâncias

Google Cloud consola

Para ver as métricas de replicação da instância do Filestore num painel de controlo do Cloud Monitoring, siga estes passos:

1. Antes de começar, certifique-se de que tem acesso às seguintes funções:

   • Visualizador de monitorização
   • Editor de monitorização

   Para saber como conceder acesso a estas funções, consulte o artigo Conceda acesso ao Cloud Monitoring.

2. Na Google Cloud consola, aceda à página  Explorador de métricas:

   Aceda ao Metrics Explorer

   Se usar a barra de pesquisa para encontrar esta página, selecione o resultado cujo subtítulo é Monitorização.

3. Clique na secção expansível Selecionar uma métrica.

4. No campo Filtrar por nome do recurso ou da métrica, escreva filestore e selecione a secção expansível Instância do Filestore.

5. Selecione a secção expansível Instância e, de seguida, clique em RPO.

6. É apresentada a métrica RPO times_since_last_replication. Esta métrica fica disponível vários minutos após a conclusão da sincronização inicial dos dados replicados.

O que se segue?

• Acerca da replicação de instâncias.
• Documentação de referência da replicação de instâncias.