Définir les descriptions des pools de nœuds de calcul

Cette page explique comment définir une description personnalisée sur vos pools de nœuds de calcul Cloud Run. Une description est un texte facultatif associé au pool de nœuds de calcul, rédigé dans un format lisible.

Une description ne peut pas comporter plus de 512 caractères. Si elle a été spécifiée, la description s'affiche lorsque vous consultez les détails d'un pool de nœuds de calcul à l'aide de la commande gcloud beta run worker-pools describe.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer et déployer des pools de nœuds de calcul Cloud Run, demandez à votre administrateur de vous accorder les rôles IAM suivants :

Pour obtenir la liste des rôles et des autorisations IAM associés à Cloud Run, consultez les sections Rôles IAM Cloud Run et Autorisations IAM Cloud Run. Si votre pool de nœuds de calcul Cloud Run communique avec des APIGoogle Cloud , telles que les bibliothèques clientes Cloud, consultez le guide de configuration de l'identité du service. Pour en savoir plus sur l'attribution de rôles, consultez les pages Autorisations de déploiement et Gérer les accès.

Spécifier ou modifier une description

Définissez une description sur les pools de nœuds de calcul Cloud Run à l'aide de la Google Cloud CLI lorsque vous créez un pool de nœuds de calcul :

gcloud

Vous pouvez spécifier ou mettre à jour la description lors du déploiement :

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

Remplacez les éléments suivants :

  • WORKER_POOL : nom de votre pool de nœuds de calcul Cloud Run
  • DESCRIPTION : description du pool de nœuds de calcul

YAML

  1. Si vous créez un pool de nœuds de calcul, ignorez cette étape. Si vous mettez à jour un pool de nœuds de calcul existant, téléchargez sa configuration YAML :

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

  2. L'exemple suivant contient la configuration YAML :

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

    Remplacez les éléments suivants :

    • WORKER_POOL : nom de votre pool de nœuds de calcul Cloud Run
    • DESCRIPTION : description du pool de nœuds de calcul

  3. Créez ou mettez à jour le pool de nœuds de calcul à l'aide de la commande suivante :

    gcloud beta run worker-pools replace workerpool.yaml

Terraform

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez la page Commandes Terraform de base.

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

  template {
    containers {
      image = "IMAGE_URL"
    }
  }
  description = "DESCRIPTION"
}

Remplacez les éléments suivants :

  • WORKER_POOL : nom du pool de nœuds de calcul
  • REGION : région Google Cloud , par exemple, europe-west1
  • IMAGE_URL : référence à l'image de conteneur contenant le pool de nœuds de calcul, par exemple us-docker.pkg.dev/cloudrun/container/worker-pool:latest
  • DESCRIPTION : description du pool de nœuds de calcul