Defina descrições do grupo de trabalhadores

Esta página mostra como definir uma descrição personalizada nos seus pools de trabalhadores do Cloud Run. Uma descrição é um texto legível opcional anexado ao grupo de trabalhadores.

Uma descrição está limitada a 512 carateres. Se estiver presente, a descrição é apresentada quando vê os detalhes de um grupo de trabalhadores através de gcloud beta run worker-pools describe.

Funções necessárias

Para receber as autorizações de que precisa para configurar e implementar pools de trabalhadores do Cloud Run, peça ao seu administrador para lhe conceder as seguintes funções da IAM:

Para ver uma lista de funções e autorizações de IAM associadas ao Cloud Run, consulte os artigos Funções de IAM do Cloud Run e Autorizações de IAM do Cloud Run. Se o seu conjunto de trabalhadores do Cloud Run interage com Google Cloud APIs, como as bibliotecas de clientes da nuvem, consulte o guia de configuração da identidade do serviço. Para mais informações sobre a atribuição de funções, consulte as autorizações de implementação e faça a gestão do acesso.

Defina ou modifique uma descrição

Defina uma descrição nos grupos de trabalhadores do Cloud Run através da CLI do Google Cloud quando criar um novo grupo de trabalhadores:

gcloud

Pode definir ou atualizar a descrição durante a implementação:

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

Substitua o seguinte:

  • WORKER_POOL: o nome do seu conjunto de trabalhadores do Cloud Run
  • DESCRIPTION: a descrição do conjunto de trabalhadores

YAML

  1. Se estiver a criar um novo conjunto de trabalhadores, ignore este passo. Se estiver a atualizar um worker pool existente, transfira a respetiva configuração YAML:

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

  2. O exemplo seguinte 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 o seguinte:

    • WORKER_POOL: o nome do seu conjunto de trabalhadores do Cloud Run
    • DESCRIPTION: a descrição do conjunto de trabalhadores

  3. Crie ou atualize o conjunto de trabalhadores com o seguinte comando:

    gcloud beta run worker-pools replace workerpool.yaml

Terraform

Para saber como aplicar ou remover uma configuração do Terraform, consulte os 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 o seguinte:

  • WORKER_POOL: o nome do conjunto de trabalhadores
  • REGION: a Google Cloud região, por exemplo, europe-west1
  • IMAGE_URL: uma referência à imagem do contentor que contém o conjunto de trabalhadores, como us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • DESCRIPTION: a descrição do conjunto de trabalhadores