Gerenciar grupos de consistência

Este documento descreve como gerenciar grupos de consistência. Grupos de consistência são políticas de recursos que alinham a replicação em vários discos na mesma região ou zona.

Para saber mais sobre grupos de consistência, consulte Sobre replicação assíncrona de disco permanente.

Limitações

  • Grupos de consistência não são compatíveis com discos em nós de locatário individual.
  • Os grupos de consistência podem ter no máximo 128 discos.
  • Todos os discos em um grupo de consistência precisam estar no mesmo projeto que a política de recursos do grupo de consistência.
  • Todos os discos em um grupo de consistência precisam estar na mesma zona, para discos zonais, ou no mesmo par de zonas, para discos regionais.
  • Um grupo de consistência pode conter discos principais ou secundários, mas não ambos.
  • Não é possível adicionar ou remover um disco primário de/para um grupo de consistência enquanto o disco está sendo replicado. Se você quiser adicionar ou remover um disco primário de ou para um grupo de consistência, primeiro interrompa a replicação. É possível adicionar ou remover discos secundários de ou para grupos de consistência a qualquer momento.
  • É possível anexar no máximo 16 discos que estão em grupos de consistência diferentes ou em discos que não estão em um grupo de consistência a uma VM. Os discos que estão no mesmo grupo de consistência contam como um disco até o limite de 16 discos.

Antes de começar

  • Configure a autenticação, caso ainda não tenha feito isso. A autenticação é o processo de verificação da sua identidade para acesso a serviços e APIs do Google Cloud. Para executar códigos ou amostras de um ambiente de desenvolvimento local, autentique-se no Compute Engine da seguinte maneira.

    Select the tab for how you plan to use the samples on this page:

    Console

    When you use the Google Cloud console to access Google Cloud services and APIs, you don't need to set up authentication.

    gcloud

    1. Install the Google Cloud CLI, then initialize it by running the following command: 

      gcloud init
    2. Set a default region and zone.

      3. REST

      Para usar as amostras da API REST nesta página em um ambiente de desenvolvimento local, use as credenciais fornecidas para gcloud CLI.

        Install the Google Cloud CLI, then initialize it by running the following command: 

        gcloud init

      Para mais informações, consulte Autenticar para usar REST na documentação de autenticação do Google Cloud.

Criar um grupo de consistência

Se você precisar alinhar a replicação em vários discos, crie um grupo de consistência na mesma região dos discos principais. Se você precisar alinhar clones de disco, crie um grupo de consistência na mesma região dos discos secundários.

Crie um grupo de consistência usando o console do Google Cloud, a Google Cloud CLI ou a REST.

Console

Para criar um grupo de consistência, faça o seguinte:

  1. No console do Google Cloud, acesse a página Replicação assíncrona.

    Acessar "Replicação assíncrona"

  2. Clique na guia Grupos de consistência.

  3. Clique em Criar grupo de consistência.

  4. No campo Nome, digite um nome para o grupo de consistência.

  5. No campo Região, selecione a região em que seus discos estão localizados. Se você quiser adicionar discos principais ao grupo de consistência, selecione a região primária. Se você quiser adicionar discos secundários ao grupo de consistência, selecione a região secundária.

  6. Clique em Criar.

gcloud

Crie um grupo de consistência usando o comando gcloud compute resource-policies create disk-consistency-group:

gcloud compute resource-policies create disk-consistency-group CONSISTENCY_GROUP_NAME \
    --region=REGION

Substitua:

  • CONSISTENCY_GROUP_NAME: o nome do grupo de consistência.
  • REGION: a região do grupo de consistência. Se você quiser adicionar discos principais ao grupo de consistência, use a região principal. Se você quiser adicionar discos secundários ao grupo de consistência, use a região secundária.

REST

Crie um grupo de consistência usando o método resourcePolicies.insert:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies
{
 "name": "CONSISTENCY_GROUP_NAME",
 "diskConsistencyGroupPolicy": {
  }
}

Substitua:

  • PROJECT: o projeto que contém o grupo de consistência.
  • REGION: a região do grupo de consistência. Se você quiser adicionar discos principais ao grupo de consistência, use a mesma região como os discos principais. Se você quiser adicionar discos secundários ao grupo de consistência, use a mesma região dos discos secundários.
  • CONSISTENCY_GROUP_NAME: o nome do grupo de consistência.

Ver discos em um grupo de consistência

Veja os discos em um grupo de consistência usando o console do Google Cloud, a Google Cloud CLI ou a REST.

Console

Para ver os discos incluídos em um grupo de consistência, faça o seguinte:

  1. No console do Google Cloud, acesse a página Replicação assíncrona.

    Acessar "Replicação assíncrona"

  2. Clique na guia Grupos de consistência.

  3. Clique no nome do grupo de consistência dos discos que você quer ver. A página Gerenciar grupo de consistência é aberta.

  4. Consulte a seção Participantes do grupo de consistência para ver todos os discos incluídos no grupo de consistência.

gcloud

Veja os discos incluídos em um grupo de consistência usando o comando gcloud compute disks list:

gcloud compute disks list \
    --LOCATION_FLAG=LOCATION \
    --filter=resourcePolicies=CONSISTENCY_GROUP_NAME

Substitua:

  • LOCATION_FLAG: a sinalização de localização dos discos no grupo de consistência. Se os discos no grupo de consistência forem regionais, use --region. Se os discos no grupo de consistência forem zonais, use --zone.
  • LOCATION: a região ou zona dos discos no grupo de consistência. Para discos regionais, use a região. Para discos zonais, use a zona.
  • CONSISTENCY_GROUP_NAME: o nome do grupo de consistência.

REST

Veja os discos em um grupo de consistência usando um filtro de consulta com um dos seguintes métodos:

  • Veja os discos zonais em um grupo de consistência usando o método disks.get:

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/ZONE/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME

  • Veja os discos regionais em um grupo de consistência usando o método regionDisks.get:

    GET https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/disks?filter=resourcePolicies%3DCONSISTENCY_GROUP_NAME

Substitua:

  • PROJECT: o projeto que contém o grupo de consistência.
  • ZONE: a zona dos discos no grupo de consistência.
  • REGION: a região dos discos no grupo de consistência.
  • CONSISTENCY_GROUP_NAME: o nome do grupo de consistência

Adicionar um disco a um grupo de consistência

Se você quiser adicionar discos principais a um grupo de consistência, é preciso fazer isso antes de iniciar a replicação. É possível adicionar discos secundários a um grupo de consistência a qualquer momento. Todos os discos em um grupo de consistência precisam estar na mesma zona, nos discos zonais ou no mesmo par de zonas, nos discos regionais.

Adicione um disco a um grupo de consistência usando o console do Google Cloud, a Google Cloud CLI ou o REST.

Console

Para adicionar discos a um grupo de consistência, faça o seguinte:

  1. No console do Google Cloud, acesse a página Replicação assíncrona.

    Acessar "Replicação assíncrona"

  2. Clique na guia Grupos de consistência.

  3. Clique no nome do grupo de consistência ao qual você quer adicionar discos. A página Gerenciar grupo de consistência é aberta.

  4. Clique em Atribuir discos. A página Atribuir discos é aberta.

  5. Selecione os discos que você quer adicionar ao grupo de consistência.

  6. Clique em Atribuir discos. Quando solicitado, clique em Adicionar.

gcloud

Adicione um disco a um grupo de consistência usando o comando gcloud compute disks add-resource-policies:

gcloud compute disks add-resource-policies DISK_NAME \
    --LOCATION_FLAG=LOCATION \
    --resource-policies=CONSISTENCY_GROUP

Substitua:

  • DISK_NAME: o nome do disco a ser adicionado ao grupo de consistência.
  • LOCATION_FLAG: a sinalização de localização do disco. Para um disco regional, use --region. Para um disco zonal, use --zone.
  • LOCATION: a região ou zona do disco. Para discos regionais, use a região. Para discos zonais, use a zona.
  • CONSISTENCY_GROUP: o URL do grupo de consistência. Por exemplo, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

REST

Adicione discos a um grupo de consistência usando um dos seguintes métodos:

  • Adicione discos zonais a um grupo de consistência usando o método disks.addResourcePolicies:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/addResourcePolicies

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

  • Adicione discos regionais a um grupo de consistência usando o método regionDisks.addResourcePolicies:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/addResourcePolicies

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

Substitua:

  • PROJECT: o projeto que contém o disco.
  • LOCATION: a zona ou região do disco. Para discos zonais, use a zona. Para discos regionais, use a região.
  • DISK_NAME: o nome do disco a ser adicionado ao grupo de consistência.
  • CONSISTENCY_GROUP: o URL do grupo de consistência. Por exemplo, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

Remover um disco de um grupo de consistência

Antes de remover um disco de um grupo de consistência, você precisa interromper a replicação para o disco.

Remova um disco de um grupo de consistência usando o console do Google Cloud, a Google Cloud CLI ou o REST.

Console

Remova os discos principais de um grupo de consistência fazendo o seguinte:

  1. No console do Google Cloud, acesse a página Replicação assíncrona.

    Acessar "Replicação assíncrona"

  2. Clique na guia Grupos de consistência.

  3. Clique no nome do grupo de consistência ao qual você quer adicionar discos. A página Gerenciar grupo de consistência é aberta.

  4. Selecione os discos que você quer remover do grupo de consistência.

  5. Clique em Remover discos. Quando aparecer uma mensagem para confirmar sua escolha, clique em Remover.

gcloud

Remova um disco de um grupo de consistência usando o comando gcloud compute disks remove-resource-policies:

gcloud compute disks remove-resource-policies DISK_NAME \
    --LOCATION_FLAG=LOCATION \
    --resource-policies=CONSISTENCY_GROUP

Substitua:

  • DISK_NAME: o nome do disco a ser removido do grupo de consistência.
  • LOCATION_FLAG: a sinalização de localização do disco. Para um disco regional, use --region. Para um disco zonal, use --zone.
  • LOCATION: a região ou zona do disco. Para discos regionais, use a região. Para discos zonais, use a zona.
  • CONSISTENCY_GROUP: o URL do grupo de consistência. Por exemplo, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

REST

Remova um disco de um grupo de consistência usando o método disks.removeResourcePolicies para discos zonais ou o método regionDisks.removeResourcePolicies para regiões discos.

  • Remova um disco zonal de um grupo de consistência:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT/zones/LOCATION/disks/DISK_NAME/removeResourcePolicies

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

  • Remova um disco regional de um grupo de consistência:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/LOCATION/disks/DISK_NAME/removeResourcePolicies

{
"resourcePolicies": "CONSISTENCY_GROUP"
}

Substitua:

  • PROJECT: o projeto que contém o disco.
  • LOCATION: a zona ou região do disco. Para discos zonais, use a zona. Para discos regionais, use a região.
  • DISK_NAME: o nome do disco a ser removido do grupo de consistência.
  • CONSISTENCY_GROUP: o URL do grupo de consistência. Por exemplo, projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME.

Excluir um grupo de consistência

Exclua um grupo de consistência usando o console do Google Cloud, a Google Cloud CLI ou a REST.

Console

Para excluir uma consistência, faça o seguinte:

  1. No console do Google Cloud, acesse a página Replicação assíncrona.

    Acessar "Replicação assíncrona"

  2. Clique na guia Grupos de consistência.

  3. Selecione o grupo de consistência que você quer excluir.

  4. Clique em Excluir. A janela Excluir grupo de consistência é aberta.

  5. Clique em Excluir.

gcloud

Exclua a política de recursos usando o comando gcloud compute resource-policies delete:

gcloud compute resource-policies delete CONSISTENCY_GROUP \
    --region=REGION

Substitua:

  • CONSISTENCY_GROUP: o nome do grupo de consistência.
  • REGION: a região do grupo de consistência

REST

Exclua uma consistência usando o método resourcePolicies.delete:

DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT/regions/REGION/resourcePolicies/CONSISTENCY_GROUP_NAME

Substitua:

  • PROJECT: o projeto que contém o grupo de consistência.
  • REGION: a região do grupo de consistência
  • CONSISTENCY_GROUP: o nome do grupo de consistência.

A seguir