Escalonamento manual para pools de workers

Nesta página, mostramos como escalonar manualmente seu pool de workers.

Visão geral

Com o escalonamento manual, é possível definir uma contagem específica de instâncias sem precisar fazer uma nova implantação. Isso oferece a opção de escrever sua própria lógica de escalonamento usando um sistema externo. Consulte o escalonador automático do Kafka para ver um exemplo.

Considerações de faturamento ao usar o escalonamento manual

Quando você usa o escalonamento manual, todas as instâncias solicitadas são faturadas como instâncias ativas, mesmo que estejam ociosas. Para detalhes completos sobre faturamento, consulte a página de preços.

Funções exigidas

Para receber as permissões necessárias para implantar pools de trabalhadores do Cloud Run, peça ao administrador para conceder a você os seguintes papéis do IAM:

Para uma lista de papéis e permissões do IAM associados ao Cloud Run, consulte Papéis do IAM do Cloud Run e Permissões do IAM do Cloud Run. Se o pool de trabalhadores do Cloud Run interagir com APIs doGoogle Cloud , como as bibliotecas de cliente do Cloud, consulte o guia de configuração de identidade de serviço. Para mais informações sobre como conceder papéis, consulte permissões de implantação e gerenciar acesso.

Configurar o escalonamento

Mudar o modo de escalonamento ou a contagem manual de instâncias não cria uma nova revisão.

Para configurar o modo de escalonamento, use o console Google Cloud ou a Google Cloud CLI:

Console

  1. No Google Cloud console, acesse o Cloud Run:

    Acessar o Cloud Run

  2. Se você estiver configurando um novo pool de workers, selecione Pools de workers no menu e clique em Implantar contêiner. Se você estiver configurando um pool de workers atual, clique nele para exibir o painel de detalhes e, em seguida, clique no ícone de caneta ao lado de Escalonamento no canto superior direito do painel de detalhes.

  3. Localize o formulário Escalonamento (para um novo pool de workers) ou o formulário Editar escalonamento para um pool de workers atual.

    imagem

  4. No campo Número de instâncias, especifique o número de instâncias de contêiner para o serviço.

  5. Conclua a especificação.

  6. Clique em Criar para um novo pool de workers ou em Salvar para um pool de workers atual.

gcloud

Para especificar o escalonamento de um novo pool de workers, use o comando deploy:

gcloud beta run worker-pools deploy WORKER_POOL \
    --scaling=INSTANCE_COUNT \
    --image IMAGE_URL

Substitua:

  • WORKER_POOL: o nome do pool de workers.
  • INSTANCE_COUNT: o número de instâncias do pool de worker. Isso define o escalonamento manual para o pool de workers. Especifique um valor de 0 para desativar o pool de workers.
  • IMAGE_URL: uma referência à imagem de contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.

Especifique o escalonamento de um pool de workers usando o seguinte comando update:

gcloud beta run worker-pools update WORKER_POOL \
   --scaling=INSTANCE_COUNT

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte Comandos básicos do Terraform.

resource "google_cloud_run_v2_worker_pool" "default" {
  name     = "WORKER_POOL"
  location = "REGION"
  launch_stage = "BETA"

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  scaling {
    scaling_mode = "MANUAL"
    manual_instance_count = "INSTANCE_COUNT"
  }
}

Substitua:

  • WORKER_POOL: o nome do pool de workers.
  • REGION: a região Google Cloud , por exemplo, europe-west1.
  • IMAGE_URL: uma referência à imagem de contêiner que contém o pool de workers, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest.
  • INSTANCE_COUNT: o número de instâncias do pool de worker. Isso define o escalonamento manual para o pool de workers. Especifique um valor de 0 para desativar o pool de workers.

Ver a configuração de escalonamento de um pool de workers

  1. No Google Cloud console, acesse o Cloud Run:

    Acessar o Cloud Run

  2. Clique em Pools de workers para mostrar a lista de pools de workers implantados.

  3. Clique no pool de workers que você quer examinar para mostrar o painel de detalhes.

  4. A configuração de escalonamento atual é mostrada acima da lista de revisões do pool de workers: Escalonamento: manual (instâncias: ).

Desativar um pool de workers

Para desativar um pool de workers, use o seguinte comando para definir o escalonamento como zero:

gcloud beta run worker-pools update WORKER_POOL --scaling=0

Substitua WORKER_POOL pelo nome do pool de workers.