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

Aperçu : Pools de nœuds de calcul Cloud Run

Cette fonctionnalité est soumise aux "Conditions des offres de pré-DG" de la section "Conditions générales du service" des Conditions spécifiques du service. Les fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une prise en charge limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Les libellés 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 libellés 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 :

• Allocation des coûts et répartition de la facturation
• Identification des ressources utilisées par les équipes individuelles ou les centres de coûts
• Différenciation des environnements de déploiement (production, préproduction, contrôle qualité ou test)
• Identification des propriétaires et des libellés d'état
• Filtrage des 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 valides Google Cloud libellés peuvent être utilisés sur Cloud Run.

Libellés pour les données de facturation et la journalisation

Cloud Billing et Cloud Logging ne reçoivent que les libellés spécifiés dans l'attribut spec.template.metadata.labels en YAML ou sous template dans Terraform. Si vous configurez des libellés à l'aide de la Google Cloud CLI, Cloud Run les ajoute aux attributs metadata.labels et spec.template.metadata.labels.

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 :

• Développeur Cloud Run (roles/run.developer) sur le pool de nœuds de calcul Cloud Run
• Utilisateur du compte de service (roles/iam.serviceAccountUser) sur l'identité du service

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 Google Cloud des API, 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 console, de Google Cloud CLI, ou de Terraform :

Console

1. Dans la Google Cloud console, accédez à Cloud Run.

   Accédez à Cloud Run

2. Localisez le pool de nœuds de calcul et cochez la case à gauche de son nom.

3. Cliquez sur Libellés pour afficher le volet "Libellés".

   

4. Pour modifier une valeur de clé d'étiquette existante, localisez le libellé et modifiez la valeur selon vos besoins.

5. Pour définir un nouveau libellé sur le pool de nœuds de calcul, cliquez sur Ajouter un libellé , puis indiquez la clé et la valeur.

6. Cliquez sur Enregistrer.

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 les éléments suivants :

• WORKER_POOL : nom de votre pool de nœuds de calcul Cloud Run
• KEY : nom de votre clé de libellé
• VALUE : 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.

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
     labels:
       KEY: VALUE
       KEY2: VALUE2
       KEY3: VALUE3
     annotations:
       run.googleapis.com/launch-stage: BETA

   Remplacez les éléments suivants :

   • WORKER_POOL : nom de votre pool de nœuds de calcul Cloud Run
   • KEY et VALUE : paires clé/valeur pour les libellés

   metadata.labels définit des libellés sur l'objet de pool de nœuds de calcul, tandis que spec.template.metadata.labels définit des libellés sur la version créée. Cloud Run ne propage que les libellés définis sur la version vers Cloud Billing et Cloud Logging.

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"
    }
    labels = {
      KEY : "VALUE"
    }
  }
}

Remplacez les éléments suivants :

• WORKER_POOL : nom du pool de nœuds de calcul
• REGION :région, par exemple europe-west1 Google Cloud
• IMAGE_URL : référence à l'image de conteneur qui contient le pool de nœuds de calcul, par exemple us-docker.pkg.dev/cloudrun/container/worker-pool:latest
• KEY : nom de votre clé de libellé
• VALUE : valeur de la clé

L'ajout de libellés sous template définit les libellés de la version. Cloud Run ne propage que les libellés définis sur la version vers Cloud Logging et Cloud Billing. Si vous ajoutez une étiquette à un emplacement autre que template, elle est définie pour le pool de nœuds de calcul et non pour la version.

Répertorier les pools de nœuds de calcul par libellé

Vous pouvez répertorier les pools de nœuds de calcul par libellé à l'aide d'un filtre de la Google Cloud CLI :

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

Remplacez les éléments suivants :

• LABEL : nom du libellé
• VALUE : valeur à inclure dans votre liste filtrée

Supprimer un libellé dans un pool de nœuds de calcul

Vous pouvez utiliser la Google Cloud console ou Google Cloud CLI pour supprimer des libellés dans un pool de nœuds de calcul.

Console

1. Dans la Google Cloud console, accédez à Cloud Run.

   Accédez à Cloud Run

2. Localisez le pool de nœuds de calcul et cochez la case à gauche de son nom.

3. Cliquez sur Libellés pour afficher le volet "Libellés".

   

4. Localisez le libellé que vous souhaitez supprimer.

5. À droite de la zone de texte Value (Valeur) du libellé, placez le curseur pour afficher l'icône de la corbeille, puis cliquez dessus.

6. Cliquez sur Enregistrer.

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 les éléments suivants :

• WORKER_POOL : nom de votre pool de nœuds de calcul Cloud Run
• LABEL : nom de votre libellé