Dimensionar uma instância

Nesta página, descrevemos como escalonar uma instância do AlloyDB. É possível escalonar verticalmente as instâncias principais e do pool de leitura mudando o tipo de máquina da instância, e é possível escalonar horizontalmente as instâncias do pool de leitura mudando o número de nós na instância.

Antes de começar

  • O projeto do Google Cloud que você está usando precisa ter sido ativado para acessar o AlloyDB.
  • Você precisa ter um destes papéis do IAM no Google Cloud projeto que está sendo usado:
    • roles/alloydb.admin (o papel predefinido do IAM de Admin do AlloyDB)
    • roles/owner (o papel básico do IAM de Proprietário)
    • roles/editor (o papel básico do IAM de Editor)

    Se você não tiver nenhum desses papéis, entre em contato com o Administrador da organização para solicitar o acesso.

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

Console

  1. No Google Cloud console, 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ária ou Editar pool de leitura.

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

  4. Selecione uma das seguintes séries de máquinas:

    • C4A (série de máquinas baseadas no Google Axion)
    • N2 (série de máquinas baseadas em x86). Essa é a série de máquinas padrão.

  5. Selecione um tipo de máquina.

    • O C4A é compatível com 1, 4, 8, 16, 32, 48, 64 e 72 tipos ou formatos de máquina.

    • O N2 oferece suporte a 2, 4, 8, 16, 32, 64, 96 e 128 tipos ou formatos de máquina.

      Para mais informações sobre o uso da série de máquinas C4A baseada em Axion, incluindo o tipo de máquina de 1 vCPU, consulte Considerações ao usar a série de máquinas C4A baseada em Axion.

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

gcloud

Para usar a gcloud CLI, você pode instalar e inicializar a CLI do Google Cloud 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 \
--machine-type=MACHINE_TYPE \
--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. Isso precisa estar alinhado com o número de vCPUs especificado no MACHINE_TYPE. Por exemplo, se MACHINE_TYPE for n2-highmem-4, CPU_COUNT precisará ser definido como 4.

  • MACHINE_TYPE: o tipo de máquina da instância.

    • Para a série de máquinas C4A baseadas no Axion, os seguintes valores são válidos:

      • c4a-highmem-1
      • c4a-highmem-4-lssd
      • c4a-highmem-8-lssd
      • c4a-highmem-16-lssd
      • c4a-highmem-32-lssd
      • c4a-highmem-48-lssd
      • c4a-highmem-64-lssd
      • c4a-highmem-72-lssd

    • Para a série de máquinas N2, os seguintes valores são válidos:

      • n2-highmem-2
      • n2-highmem-4
      • n2-highmem-8
      • n2-highmem-16
      • n2-highmem-32
      • n2-highmem-64
      • n2-highmem-96
      • n2-highmem-128

  • REGION_ID: a região em que a instância está localizada.

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

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

Se o comando retornar uma mensagem de erro que inclua a frase invalid cluster state MAINTENANCE, o cluster está passando por 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 Ver detalhes do cluster.

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

Com o AlloyDB, é possível escalonar o número de nós em uma instância de pool de leitura sem tempo de inatividade no nível da instância. Quando você aumenta a contagem de nós, as conexões de 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 Google Cloud console, 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 Manutenção do cluster. A ação fica disponível novamente quando o Status muda para Pronto.

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

  5. Clique em Atualizar pool de leitura.

gcloud

Para usar a gcloud CLI, você pode instalar e inicializar a CLI do Google Cloud 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 de 1 a 20, inclusive. 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 está localizada.

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

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

Se o comando retornar uma mensagem de erro que inclua a frase invalid cluster state MAINTENANCE, o cluster está passando por 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 Ver detalhes do cluster.