Configurer les étiquettes

Les étiquettes Cloud Run sont des paires clé/valeur appliquées aux jobs Cloud Run. Cette page explique comment définir, modifier et supprimer des étiquettes dans vos jobs Cloud Run.

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 étiquettes définies sur un job 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 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 jobs par étiquette

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

  gcloud run jobs 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'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

Remplacer

JOB par le nom de votre job Cloud Run
LABEL par le nom de votre libellé.