Cette page explique comment définir, modifier et supprimer des libellés dans votre service Cloud Run, dans vos révisions et dans vos tâches Cloud Run. Pour Cloud Run, les libellés sont des paires clé/valeur qui sont appliquées au service, à la révision ou à la tâche. Notez que lorsque vous définissez un libellé sur un service Cloud Run, une nouvelle révision de service ou ce libellé est créé pour ce service. Le libellé n'est pas appliqué aux révisions plus anciennes.
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 service ou une tâche Cloud Run :
Seuls les libellés Google Cloud valides peuvent être utilisés sur Cloud Run.
Définir ou modifier des libellés
Vous pouvez définir des libellés sur les services et les tâches Cloud Run.
Pour les services Cloud Run
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 Google Cloud Console, de la ligne de commande gcloud ou d'un fichier YAML lorsque vous déployez une nouvelle révision.
Console
Cochez la case située à gauche du service sur lequel vous définissez le libellé.
Assurez-vous que le panneau d'informations situé tout à droite est activé (Afficher le panneau d'informations).
Cliquez sur Labels (Libellés) pour afficher le volet des libellés.
Pour modifier une valeur de clé de libellé existante, localisez le libellé et modifiez la valeur selon vos besoins.
Pour définir un nouveau libellé sur le service, cliquez sur Add Label (Ajouter un libellé), puis saisissez la clé et la valeur.
Cliquez sur Enregistrer.
Ligne de commande
Vous pouvez mettre à jour les libellés d'un service à l'aide de la commande suivante :
gcloud run services update SERVICE --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é.
Remplacer
- SERVICE par le nom de votre service 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 run deploy SERVICE --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
Vous pouvez télécharger et afficher les configurations de service existantes à l'aide de la commande gcloud run services describe --format export
, qui renvoie les résultats nettoyés au format YAML.
Vous pouvez ensuite modifier les champs décrits ci-dessous et importer le fichier YAML modifié à l'aide de la commande gcloud run services replace
.
Veillez à ne modifier que les champs indiqués.
Pour afficher et télécharger la configuration, exécutez la commande suivante :
gcloud run services describe SERVICE --format export > service.yaml
Mettez à jour les attributs
labels
à deux endroits :apiVersion: serving.knative.dev/v1 kind: Service metadata: name: SERVICE labels: LABEL: VALUE spec: template: metadata: labels: LABEL: VALUE name: REVISION
Remplacer
- SERVICE par le nom de votre service Cloud Run ;
- LABEL par le nom du libellé ;
- VALUE par la valeur souhaitée.
- REVISION par un nouveau nom de révision ou supprimez-le (le cas échéant). Si vous indiquez un nouveau nom de révision, il doit répondre aux critères suivants :
- Commencer par
SERVICE-
- Ne contenir que des lettres minuscules, des chiffres et
-
- Ne pas se terminer par
-
- Ne pas dépasser 63 caractères
- Commencer par
metadata.labels
définit des libellés sur l'objet de service, tandis quespec.template.metadata.label
définit des libellés sur la version créée. Seuls les libellés définis sur la version sont transmis aux journaux et à la facturation.Remplacez la configuration du service en utilisant la commande suivante :
gcloud run services replace service.yaml
Terraform
Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez la page Commandes Terraform de base.
Ajoutez les éléments suivants à une ressource google_cloud_run_service
de votre configuration Terraform, sous l'attribut template
. Cette commande applique deux libellés, foo
(dont la valeur est bar
) et baz
(dont la valeur est quux
), à votre instance Cloud Run.
Pour les jobs Cloud Run
Vous pouvez utiliser Google Cloud CLI ou YAML pour définir un libellé sur une tâche Cloud Run.
Ligne de commande
Pour définir un libellé pour une nouvelle tâche, procédez comme suit :
gcloud run jobs create JOB_NAME --image IMAGE_URL --labels KEY=VALUE
Remplacer
- JOB_NAME par le nom de votre tâche.
- KEY par le nom de votre clé de libellé ;
- VALUE par la valeur de la clé.
- Remplacez IMAGE_URL par une référence à l'image de conteneur, par exemple
us-docker.pkg.dev/cloudrun/container/job:latest
.
Pour définir un libellé sur une tâche existante, procédez comme suit :
gcloud run jobs update JOB_NAME --labels KEY=VALUE
Pour créer plusieurs libellés, spécifiez une liste de paires clé/valeur séparées par une virgule.
gcloud run jobs update JOB_NAME --labels KEY1=VALUE1,KEY2=VALUE2
YAML
Téléchargez et affichez la configuration de tâche existante à l'aide de la commande gcloud run jobs describe --format export
, qui renvoie les résultats nettoyés au format YAML. Modifiez ensuite les champs décrits ci-dessous et importez le fichier YAML modifié à l'aide de la commande gcloud run jobs replace
.
Veillez à ne modifier que les champs indiqués.
Pour afficher et télécharger la configuration, exécutez la commande suivante :
gcloud run jobs describe JOB_NAME --format export > job.yaml
Mettez à jour les attributs
labels
à deux endroits :apiVersion: run.googleapis.com/v1 kind: Job metadata: labels: LABEL: VALUE spec: template: metadata: labels: LABEL: VALUE
Remplacer
- LABEL par le nom du libellé ;
- VALUE par la valeur souhaitée.
Vous pouvez également spécifier d'autres éléments de configuration, tels que des variables d'environnement ou des limites de mémoire.
Mettez à jour la configuration de tâche existante :
gcloud run jobs replace job.yaml
Répertorier les services ou les tâches par libellé
Vous pouvez répertorier les services ou les tâches par libellé à l'aide d'un filtre de Google Cloud CLI:
Pour les services :
gcloud run services list --filter metadata.labels.LABEL=VALUE
Pour les tâches :
gcloud run jobs list --filter metadata.labels.LABEL=VALUE
Remplacer
- LABEL par le nom du libellé ;
- VALUE par la valeur à inclure dans votre liste filtrée.
Supprimer un libellé sur un service
Vous pouvez supprimer des libellés d'un service à l'aide de la console ou de la ligne de commande.
Console
Cochez la case située à gauche du service duquel vous supprimez le libellé.
Assurez-vous que le panneau d'informations situé tout à droite est activé (Afficher le panneau d'informations).
Cliquez sur Labels (Libellés) pour afficher le volet des libellés.
Localisez le libellé que vous souhaitez supprimer.
Placez le curseur à droite de la zone de texte Value (Valeur) pour que le libellé affiche l'icône de la corbeille, puis cliquez sur celle-ci.
Cliquez sur Enregistrer.
Ligne de commande
Pour effacer tous les libellés d'un service, exécutez la commande suivante :
gcloud run services update SERVICE --clear-labels
Pour supprimer des libellés spécifiques d'un service, spécifiez une liste de clés séparées par une virgule :
gcloud run services update SERVICE --remove-labels LABEL
Remplacer
- SERVICE par le nom de votre service Cloud Run ;
- LABEL par le nom de votre libellé.
Supprimer un libellé d'une tâche
Pour effacer tous les libellés d'une tâche :
gcloud run jobs update JOB --clear-labels
Pour supprimer des libellés spécifiques d'un service, spécifiez une liste de clés séparées par une virgule :
gcloud run jobs update JOB --remove-labels LABEL
Replace
* <var>JOB</var> with name of your Cloud Run service
* <var>LABEL</var> with the name of your label