Dimensionar uma instância

Esta página mostra como dimensionar uma instância do AlloyDB. É possível escalonar instâncias de pool de leitura e principal verticalmente mudando o tipo de máquina da instância e mudar o número de nós nas instâncias de pool de leitura horizontalmente.

Antes de começar

  • O projeto do Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
  • É necessário ter uma destas funções do IAM no projeto do Google Cloud que você está usando:
    • roles/alloydb.admin (papel predefinido do IAM de administrador do AlloyDB)
    • roles/owner (o papel básico do IAM "Proprietário")
    • roles/editor (papel básico do IAM de editor)

    Se você não tiver nenhuma dessas funções, entre em contato com o administrador da organização para solicitar acesso.

Dimensionar o tipo de máquina de uma instância

Console

  1. No console do Google Cloud, acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do recurso.

  3. Na página Visão geral, acesse a seção Instâncias no cluster e clique em Editar primário ou Editar pool de leitura.

    Essa ação não estará disponível se a página informar um Status de cluster de Manutenção. A ação vai ficar disponível novamente depois que o Status mudar para Pronto.

  4. Selecione um tipo de máquina.

  5. Clique em Atualizar instância ou Atualizar pool de leitura.

gcloud

Para usar a CLI gcloud, você pode instalar e inicializar a Google Cloud CLI ou usar o Cloud Shell.

Use o comando gcloud alloydb instances update para mudar o tipo de máquina da instância principal.

gcloud alloydb instances update INSTANCE_ID \
--cpu-count=CPU_COUNT \
--region=REGION_ID \
--cluster=CLUSTER_ID \
--project=PROJECT_ID

Substitua:

  • INSTANCE_ID: o ID da instância que você está atualizando.

  • CPU_COUNT: o número de vCPUs que você quer para a instância. Valores válidos:

    • 2: 2 vCPUs, 16 GB de RAM
    • 4: 4 vCPUs, 32 GB de RAM
    • 8: 8 vCPUs, 64 GB de RAM
    • 16: 16 vCPUs, 128 GB de RAM
    • 32: 32 vCPUs, 256 GB de RAM
    • 64: 64 vCPUs, 512 GB de RAM
    • 96: 96 vCPUs, 768 GB de RAM
    • 128: 128 vCPUs, 864 GB de RAM

  • REGION_ID: a região em que a instância é colocada.

  • CLUSTER_ID: o ID do cluster em que a instância está colocada.

  • PROJECT_ID: o ID do projeto em que o cluster está colocado.

Se o comando retornar uma mensagem de erro que inclua a frase invalid cluster state MAINTENANCE, o cluster está em manutenção de rotina. Isso impede temporariamente a reconfiguração da instância. Execute o comando novamente depois que o cluster retornar ao estado READY. Para verificar o status do cluster, consulte Conferir os detalhes do cluster.

Dimensionar a contagem de nós de uma instância do pool de leitura

O AlloyDB permite escalonar o número de nós em uma instância de pool de leitura sem nenhum tempo de inatividade. Quando você aumenta a contagem de nós, as conexões do cliente não são afetadas.

Quando você diminui a contagem de nós, todos os clientes conectados a um nó que está sendo desativado podem se reconectar aos outros nós usando o endpoint da instância.

Console

  1. No console do Google Cloud, acesse a página Clusters.

    Acessar Clusters

  2. Clique em um cluster na coluna Nome do recurso.

  3. Na página Visão geral, acesse a seção Instâncias no cluster e clique em Editar pool de leitura.

    Essa ação não está disponível se a página informar um Status de cluster de Manutenção. A ação vai ficar disponível novamente depois que o Status mudar para Pronto.

  4. No campo Contagem de nós, insira uma contagem de nós. Observação:é possível ter no máximo 20 nós em todas as instâncias do pool de leitura em um cluster.

  5. Clique em Atualizar pool de leitura.

gcloud

Para usar a CLI gcloud, você pode instalar e inicializar a Google Cloud CLI ou usar o Cloud Shell.

Use o comando gcloud alloydb instances update para mudar o número de nós em uma instância de pool de leitura.

gcloud alloydb instances update INSTANCE_ID \
    --read-pool-node-count=NODE_COUNT \
    --region=REGION_ID \
    --cluster=CLUSTER_ID \
    --project=PROJECT_ID

  • INSTANCE_ID: o ID da instância do pool de leitura.

  • NODE_COUNT: o número de nós na instância do pool de leitura. Especifique um número entre 1 e 20. Não é possível ter mais de 20 nós em todas as instâncias do pool de leitura em um cluster.

  • REGION_ID: A região em que a instância é colocada.

  • CLUSTER_ID: o ID do cluster em que a instância é colocada.

  • PROJECT_ID: o ID do projeto em que o cluster é colocado.

Se o comando retornar uma mensagem de erro que inclua a frase invalid cluster state MAINTENANCE, o cluster está em manutenção de rotina. Isso impede temporariamente a reconfiguração da instância. Execute o comando novamente depois que o cluster retornar ao estado READY. Para verificar o status do cluster, consulte Conferir os detalhes do cluster.