Configurer des libellés pour les instances

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

Voici des exemples possibles d'utilisation :

  • Répartition des coûts et 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 une instance Cloud Run :

Seuls les libellés Google Cloud valides 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 instances 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 instance Cloud Run communique avec Google Cloud des API, 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.

Définir ou modifier des libellés

Vous pouvez définir ou modifier des libellés à l'aide de Google Cloud CLI :

gcloud

Vous pouvez mettre à jour les libellés d'une instance à l'aide de la commande suivante :

gcloud beta run instances update INSTANCE --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 :

  • INSTANCE : nom de votre instance Cloud Run.
  • KEY : nom de votre clé d'étiquette.
  • VALUE : valeur de la clé.

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

gcloud beta run instances deploy INSTANCE --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 une instance, ignorez cette étape. Si vous mettez à jour une instance existante, téléchargez sa configuration YAML :

    gcloud beta run instances describe INSTANCE --format export > instance.yaml

  2. L'exemple suivant contient la configuration YAML :

    apiVersion: run.googleapis.com/v1
kind: Instance
metadata:
  name: INSTANCE
  annotations:
    run.googleapis.com/launch-stage: BETA
  labels:
    KEY: VALUE
    KEY2: VALUE2
    KEY3: VALUE3

    Remplacez les éléments suivants :

    • INSTANCE : nom de votre instance Cloud Run.
    • KEY et VALUE : paires clé/valeur pour les libellés.

    metadata.labels définit des libellés sur l'objet d'instance, 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 à Cloud Billing et Cloud Logging.

  3. Créez ou mettez à jour l'instance à l'aide de la commande suivante :

    gcloud beta run instances replace instance.yaml

Répertorier les instances par libellé

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

  gcloud beta run instances 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é d'une instance

Vous pouvez utiliser Google Cloud CLI pour supprimer des libellés d'une instance.

gcloud

Pour effacer tous les libellés d'une instance :

gcloud beta run instances update INSTANCE --clear-labels

Pour supprimer des libellés spécifiques d'une instance, spécifiez une liste de clés séparées par une virgule :

gcloud beta run instances update INSTANCE --remove-labels LABEL

Remplacez les éléments suivants :

  • INSTANCE : nom de votre instance Cloud Run.
  • LABEL : nom de votre libellé.