Configurar a replicação de instâncias

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

Antes de começar

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

  2. Se você ainda não tiver feito isso, crie uma instância do Filestore. No contexto deste guia, essa é a instância de origem.

Criar uma réplica para uma instância

Google Cloud console

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

    Acessar instâncias do Filestore

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

  3. Na seção Descrição, clique na guia Replicações.

  4. Clique em Criar réplica.

  5. Clique no link da documentação para analisar o objetivo do ponto de recuperação (RPO) compatível e clique em Próxima.

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

    • A capacidade especificada precisa ser maior ou igual à origem.
    • As especificações a seguir precisam corresponder à instância de origem:
    • Para reduzir o risco de perda de dados, recomendamos que os usuários escolham uma região e uma zona exclusivas para a origem.
  7. Clique em Próxima.

  8. Revise os detalhes e clique em Próxima.

  9. Clique em Criar.

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

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

gcloud

  1. Para criar uma instância de réplica, execute 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:

  • 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 que você precisa, como ZONAL. O nível e o intervalo de capacidade precisam corresponder à origem.
  • FILE-SHARE-NAME com o nome que você especifica para o compartilhamento de arquivos NFS que é veiculado da instância, como vol1.
  • FILE-SHARE-SIZE é o tamanho que você quer que o compartilhamento de arquivos tenha, como 1.25TB. A capacidade precisa ser maior ou igual à origem e, se aplicável, ao mesmo intervalo de capacidade.

API REST

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

  2. Use cURL para chamar a API do 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 em que 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 instância

Google Cloud console

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

    Acessar instâncias do Filestore

  2. Clique no ID da réplica que você quer visualizar.

  3. Na seção Descrição, clique na guia Replicações.

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

  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:

  • INSTANCE-ID com o ID da instância do Filestore que você quer visualizar, como genomics-instance.
  • PROJECT-ID com o ID do projeto do Google Cloud projeto 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 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

  1. Ter CLI gcloud instalada e inicializada, o que 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"

    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 instâncias em um projeto

Google Cloud console

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

    Acessar instâncias do Filestore

    As réplicas são listadas nas 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:

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

    A resposta retorna algo semelhante a isto:

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

  2. Use cURL para chamar a API do 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 -.

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.

Google Cloud console

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

    Acessar instâncias do Filestore

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

  3. Clique em Interromper replicação.

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

  5. Insira o ID da instância da réplica e clique em Interromper replicação.

  6. Aguarde a conclusão da operação.

gcloud

  1. Para promover uma instância de réplica, execute o comando gcloud filestore instances promote-replica.

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

Substitua:

  • 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

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

  2. Use cURL para chamar a API do 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

Google Cloud console

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

    Acessar instâncias do Filestore

    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.

  2. Clique no código da instância que você quer excluir.

  3. Clique em Excluir.

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:

    • PROJECT-ID com o ID do projeto que você quer visualizar.
  2. Copie os detalhes da instância que você quer excluir.

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

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

Substitua:

  • 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

  1. Ter CLI gcloud instalada e inicializada, o que 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"

    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

Google Cloud console

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

  1. Antes de começar, verifique se você tem acesso às seguintes funções:

    • Visualizador de monitoramento
    • Editor do Monitoring

    Para saber como conceder acesso a esses papéis, consulte Conceder acesso ao Cloud Monitoring.

  2. No console Google Cloud , acesse a página  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.

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

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

  5. Selecione a seção expansível Instância e clique em RPO.

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

A seguir