Definir descrições do pool de workers

Nesta página, mostramos como definir uma descrição personalizada nos pools de workers do Cloud Run. A descrição é um texto legível opcional anexado ao pool de trabalhadores.

A descrição é limitada a 512 caracteres. Se presente, a descrição é exibida durante a visualização de detalhes de um pool de workers usando gcloud beta run worker-pools describe.

Funções exigidas

Para receber as permissões necessárias para configurar e 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 APIsGoogle 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.

Definir ou modificar uma descrição

Defina uma descrição nos pools de workers do Cloud Run usando a Google Cloud CLI ao criar um novo pool de workers:

gcloud

É possível definir ou atualizar a descrição durante a implantação:

gcloud beta run worker-pools deploy WORKER_POOL --description DESCRIPTION

Substitua:

  • WORKER_POOL: o nome do seu pool de worker do Cloud Run
  • DESCRIPTION: a descrição do pool de workers

YAML

  1. Se você estiver criando um novo pool de workers, pule esta etapa. Se você estiver atualizando um pool de trabalhadores, baixe a configuração YAML correspondente:

    gcloud beta run worker-pools describe WORKER_POOL --format export > workerpool.yaml

  2. O exemplo a seguir contém a configuração YAML:

    apiVersion: run.googleapis.com/v1
kind: WorkerPool
metadata:
  name: WORKER_POOL
  annotations:
    run.googleapis.com/launch-stage: BETA
    run.googleapis.com/description: DESCRIPTION

    Substitua:

    • WORKER_POOL: o nome do seu pool de worker do Cloud Run
    • DESCRIPTION: a descrição do pool de workers

  3. Crie ou atualize o pool de workers usando o seguinte comando:

    gcloud beta run worker-pools replace workerpool.yaml

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"
    }
  }
  description = "DESCRIPTION"
}

Substitua:

  • WORKER_POOL: o nome do pool de workers
  • REGION: the Google Cloud region—for example, 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
  • DESCRIPTION: a descrição do pool de workers