Criar grupos de nó de locatário individual

Neste documento, descrevemos como criar e excluir grupos de nó de locatário individual. Se você ainda não criou um modelo de nó de locatário individual, faça isso antes de criar um grupo de nós.

Os grupos de nós são recursos zonais que herdam propriedades do modelo de nó em que se baseiam. Ao criar um grupo de nós, é necessário especificar uma configuração, como o número de nós e as configurações de manutenção.

Crie um grupo de nós de locatário individual.

Para criar um grupo de nó de locatário individual, use um dos seguintes métodos:

Console

  1. No console do Google Cloud , acesse a página Nós de locatário individual.

    Acesse Nós de locatário individual

  2. Clique em Criar grupo de nós para começar a criar um grupo de nós.

  3. Especifique um Nome para o grupo de nós.

  4. Especifique a Região do grupo de nós para exibir os modelos de nó disponíveis nessa região.

  5. Especifique a Zona na região em que o grupo de nós será criado.

  6. Especifique o Modelo de nó para criar o grupo de nós ou clique em Criar modelo de nó para criar um novo modelo de nó de locatário individual. O modelo de nó selecionado é aplicado ao grupo de nós.

  7. Escolha uma das seguintes opções para o Modo de escalonamento automático do escalonador automático do grupo de nós:

    • Desativado: gerencie manualmente o tamanho do grupo de nós.

    • On: adicione ou remova nós automaticamente do grupo de nós.

    • Somente escalonamento horizontal: adicione nós ao grupo de nós quando a capacidade extra for necessária.

  8. Especifique o Número de nós do grupo. Se você ativar o escalonador automático do grupo de nós, especifique um intervalo para o tamanho do grupo. É possível alterar os valores manualmente mais tarde.

  9. Defina a Política de manutenção do grupo de nós de locatário individual na seção Definir configurações de manutenção como um dos valores a seguir. A política de manutenção permite configurar o comportamento das VMs no grupo de nós durante eventos de manutenção do host. Para mais informações, consulte Políticas de manutenção:

    • Padrão
    • Começar a reinicialização
    • Migrar no grupo de nós

  10. É possível escolher entre janelas de manutenção regulares e o controle de manutenção avançado para lidar com a manutenção do grupo de nós de locatário individual da seguinte maneira:

    • Janela de manutenção: selecione o período em que você quer que os eventos de manutenção planejados ocorram nos nós nos grupos de locatário individual.

    • Ativar o controle de manutenção avançado para locatário individual: O controle de manutenção avançado para locatário individual permite controlar os eventos de manutenção planejados de grupos de nós de locatário individual e minimizar as interrupções relacionadas à manutenção. Para ativar o controle de manutenção avançado, clique para ativar a opção Ativar o controle de manutenção avançado para locatário individual. Se você optar por usar essa opção para a manutenção de nós, o campo Janela de manutenção será desativado e a manutenção ocorrerá conforme configurado no controle de manutenção avançado.

    O controle de manutenção avançado só é compatível com a política de manutenção Padrão.

  11. Defina as configurações de compartilhamento especificando uma das seguintes opções em Definir configurações de compartilhamento:

    • Para compartilhar o grupo de nós com todos os projetos na sua organização, escolha a opção Compartilhar este grupo de nós com todos os projetos na organização.
    • Para compartilhar o grupo de nós com projetos específicos na sua organização, escolha Compartilhar esse grupo de nós com projetos selecionados na organização.

    Se você não quiser compartilhar o grupo de nós, escolha Não compartilhar este grupo de nós com outros projetos. Para mais informações sobre o compartilhamento de grupos de nós, consulte Compartilhar grupos de nós de locatário individual.

  12. Clique em Criar para concluir a criação do grupo de nós.

gcloud

Execute o comando gcloud compute sole-tenancy node-groups create para criar um grupo de nós com base em um modelo de nó criado anteriormente:

gcloud compute sole-tenancy node-groups create GROUP_NAME \
  --node-template=TEMPLATE_NAME \
  --target-size=TARGET_SIZE \
  [--zone=ZONE \]
  [--maintenance-policy=MAINTENANCE_POLICY \]
  [--maintenance-window-start-time=START_TIME \]
  [--autoscaler-mode=AUTOSCALER_MODE \
  --min-nodes=MIN_NODES \
  --max-nodes=MAX_NODES]

Substitua:

  • GROUP_NAME: o nome do novo grupo de nós;
  • TEMPLATE_NAME: o nome do modelo de nó a ser usado para criar esse grupo;
  • TARGET_SIZE: o número de nós a serem criados no grupo;
  • ZONE: a zona em que o grupo de nós será criado. Precisa ser a mesma região do modelo de nó em que você está baseando o grupo de nós.

  • MAINTENANCE_POLICY: a política de manutenção para o grupo de nós. Para mais informações, consulte Políticas de manutenção. Precisa ser um destes valores:

    • default
    • restart-in-place
    • migrate-within-node-group

    Como alternativa, é possível ativar o controle de manutenção avançado para o grupo de nós de locatário individual usando a flag --maintenance-interval. Para mais informações, consulte Ativar o controle de manutenção avançado em um nó de locatário individual.

  • START_TIME: o horário de início em GMT para a janela de manutenção das VMs neste grupo de nós. Defina como uma destas opções: 00:00, 04:00, 08:00, 12:00, 16:00 ou 20:00. Se não for definido, o grupo de nós não terá uma janela de manutenção definida.

  • AUTOSCALER_MODE: a política do escalonador automático para o grupo de nós. Precisa ser uma destas opções:

    • off: gerencie manualmente o tamanho do grupo de nós.
    • on: nós serão adicionados ou removidos automaticamente do grupo de nós.
    • only-scale-out: adicione nós ao grupo de nós quando a capacidade extra for necessária.

  • MIN_NODES: o tamanho mínimo do grupo de nós. O valor padrão é 0 e precisa ser um valor inteiro menor ou igual a MAX_NODES.

  • MAX_NODES: o tamanho máximo do grupo de nós. Precisa ser menor ou igual a 100, e maior ou igual a MIN_NODES. Obrigatório, se AUTOSCALER_MODE não estiver definido como off.

REST

Use o métodonodeGroups.insert para criar um grupo de nós com base em um modelo de nó criado anteriormente:

POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups?initialNodeCount=TARGET_SIZE
{
  "nodeTemplate": "regions/REGION/nodeTemplates/TEMPLATE_NAME",
  "name": "GROUP_NAME",
  "maintenancePolicy": MAINTENANCE_POLICY,
  "maintenanceWindow": {
      "startTime": "START_TIME"
  },
  "autoscalingPolicy": {
      "mode": AUTOSCALER_MODE,
      "minNodes": MIN_NODES,
      "maxNodes": MAX_NODES
  },
}

Substitua:

  • PROJECT_ID: o ID do projeto;

  • ZONE: a zona em que o grupo de nós será criado. Ele precisa estar na mesma região do modelo do nó em que você está baseando o grupo de nós.

  • TARGET_SIZE: o número de nós a serem criados no grupo;

  • REGION: a região em que o grupo de nós será criado. Você precisa ter um modelo de nó na região selecionada.

  • TEMPLATE_NAME: o nome do modelo de nó a ser usado para criar esse grupo;

  • GROUP_NAME: o nome do novo grupo de nós;

  • MAINTENANCE_POLICY: a política de manutenção para o grupo de nós. Precisa ser um destes valores:

    • DEFAULT
    • RESTART_IN_PLACE
    • MIGRATE_WITHIN_NODE_GROUP

    Como alternativa, é possível ativar o controle de manutenção avançado para o grupo de nós de locatário individual usando o campo maintenanceInterval. Para mais informações, consulte Ativar o controle de manutenção avançado em um nó de locatário individual.

  • START_TIME: o horário de início em GMT para a janela de manutenção das VMs neste grupo de nós. Defina como uma destas opções: 00:00, 04:00, 08:00, 12:00, 16:00 ou 20:00. Se não for definido, o grupo de nós não terá uma janela de manutenção definida.

  • AUTOSCALER_MODE: a política do escalonador automático para o grupo de nós. Precisa ser um destes valores:

    • OFF: gerencie manualmente o tamanho do grupo de nós.
    • ON: nós serão adicionados ou removidos automaticamente do grupo de nós.
    • ONLY_SCALE_OUT: adicione nós ao grupo de nós quando a capacidade extra for necessária.

  • MIN_NODES: o tamanho mínimo do grupo de nós. O valor padrão é 0 e precisa ser um valor inteiro menor ou igual a MAX_NODES.

  • MAX_NODES: o tamanho máximo do grupo de nós. Precisa ser menor ou igual a 100, e maior ou igual a MIN_NODES. Obrigatório, se AUTOSCALER_MODE não estiver definido como OFF.

Excluir um grupo de nós

Se você precisar excluir um grupo de nós de locatário individual, primeiro remova todas as VMs desse grupo.

Console

  1. Acessar a página Nós de locatário individual.

    Acesse "nós de locatário individual"

  2. Clique no Nome do grupo de nós a ser excluído.

  3. Para cada nó no grupo de nós, clique no nome do nó e exclua as instâncias de VM individuais na página de detalhes do nó ou siga o procedimento padrão para excluir uma VM individual. Para excluir VMs em um grupo gerenciado de instâncias, exclua o grupo.

  4. Depois de excluir todas as instâncias de VM em execução em todos os nós do grupo, retorne à página Nós de locatário individual.

    Acessar Nós de locatário individual

  5. Clique em Grupos de nós.

  6. Selecione o nome do grupo de nós que você precisa excluir.

  7. Clique em Excluir.

gcloud

  1. Liste instâncias de VM em execução em nós no grupo de nós usando o comando gcloud compute sole-tenancy node-groups list-nodes:

    gcloud compute sole-tenancy node-groups list-nodes GROUP_NAME \
  --zone=ZONE

    Substitua:

    • GROUP_NAME: o nome do grupo de nós.
    • ZONE: a zona do grupo de nós.

  2. Se houver VMs em execução no grupo de nós, siga o procedimento para excluir uma VM individual ou o procedimento para excluir um grupo de instâncias gerenciadas.

  3. Depois de excluir todas as VMs em execução em todos os nós do grupo de nós, exclua o grupo usando o comando gcloud compute sole-tenancy node-groups delete:

    gcloud compute sole-tenancy node-groups delete GROUP_NAME \
    --zone=ZONE

    Substitua:

    • GROUP_NAME: o nome do grupo de nós;
    • ZONE: a zona do grupo de nós.

REST

  1. Liste instâncias de VM em execução em nós no grupo de nós usando o método nodeGroups.listNodes:

    POST https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups/GROUP_NAME/listNodes

    Substitua:

    • PROJECT_ID: o ID do projeto;
    • ZONE: a zona do grupo de nós;
    • GROUP_NAME: o grupo em que as VMs serão listadas.

  2. Se houver VMs em execução no grupo de nós, siga o procedimento para excluir uma VM individual ou o procedimento para excluir um grupo de instâncias gerenciadas.

  3. Depois de excluir todas as VMs em execução em todos os nós do grupo de nós, exclua o grupo usando o comando nodeGroups.delete:

    DELETE https://compute.googleapis.com/compute/v1/projects/PROJECT_ID/zones/ZONE/nodeGroups/GROUP_NAME

    Substitua:

    • PROJECT_ID: o ID do projeto;
    • ZONE: a zona do grupo de nós;
    • GROUP_NAME: o nome do grupo de nós a ser excluído.

A seguir