Configurer des étiquettes pour les pools de nœuds de calcul

Les étiquettes Cloud Run sont des paires clé/valeur appliquées aux pools de nœuds de calcul Cloud Run. Cette page explique comment définir, modifier et supprimer des étiquettes dans vos pools de nœuds de calcul Cloud Run. Notez que lorsque vous définissez un libellé sur un pool de nœuds de calcul Cloud Run, une nouvelle révision portant ce libellé est créée pour ce pool de nœuds de calcul. Le libellé n'est pas appliqué aux anciennes révisions.

Voici des exemples possibles d'utilisation :

  • Effectuer l'allocation des coûts et la répartition de la facturation
  • Identifier les ressources utilisées par les équipes individuelles ou les centres de coûts
  • Différencier les environnements de déploiement (production, préproduction, contrôle qualité ou test)
  • Identifier les propriétaires et les libellés d'état
  • Filtrer les journaux dans Logging

Règles d'utilisation des libellés

La règle suivante s'applique à l'utilisation des libellés définis sur un pool de nœuds de calcul Cloud Run :

Seuls les libellés valides Google Cloud peuvent être utilisés sur Cloud Run.

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 des 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.

Définir ou modifier des libellés

Tout changement de configuration entraîne la création d'une révision. Les révisions ultérieures obtiennent aussi automatiquement le même paramètre de configuration, à moins que vous ne le mettiez explicitement à jour.

Vous pouvez définir ou modifier des libellés à l'aide de la Google Cloud CLI lorsque vous créez un pool de nœuds de calcul ou déployez une nouvelle révision :

gcloud

Vous pouvez mettre à jour les libellés d'un pool de nœuds de calcul à l'aide de la commande suivante :

gcloud beta run worker-pools update WORKER_POOL --update-labels KEY=VALUE

Pour mettre à jour plusieurs libellés, spécifiez une liste de paires clé/valeur séparées par une virgule. Notez que la commande update-labels définit une nouvelle valeur pour la clé du libellé si celui-ci existe déjà. Dans le cas contraire, elle crée un libellé.

Remplacez :

  • WORKER_POOL par le nom de votre pool de nœuds de calcul Cloud Run
  • KEY par le nom de votre clé de libellé ;
  • VALUE par la valeur de la clé.

Vous pouvez également définir des libellés lors du déploiement :

gcloud beta run worker-pools deploy WORKER_POOL --image IMAGE --labels KEY=VALUE

Pour créer plusieurs libellés au cours du déploiement, spécifiez une liste de paires clé/valeur séparées par une virgule.

Répertorier les services par libellé

Vous pouvez répertorier les services par étiquette à l'aide d'un filtre de la Google Cloud CLI :

  gcloud beta run worker-pools list --filter metadata.labels.LABEL=VALUE

Remplacez :

  • LABEL par le nom du libellé ;
  • VALUE par la valeur à inclure dans votre liste filtrée.

Supprimer un libellé d'un pool de nœuds de calcul

Vous pouvez utiliser Google Cloud CLI pour supprimer des libellés d'un pool de nœuds de calcul.

gcloud

Pour effacer tous les libellés d'un pool de nœuds de calcul :

gcloud beta run worker-pools update WORKER_POOL --clear-labels

Pour supprimer des libellés spécifiques d'un pool de nœuds de calcul, spécifiez une liste de clés séparées par une virgule :

gcloud beta run worker-pools update WORKER_POOL --remove-labels LABEL

Remplacez :

  • WORKER_POOL par le nom de votre pool de nœuds de calcul Cloud Run
  • LABEL par le nom de votre libellé.