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.

Rôles requis

Pour obtenir les autorisations nécessaires pour configurer des jobs Cloud Run, demandez à votre administrateur de vous accorder les rôles IAM suivants :

Développeur Cloud Run (roles/run.developer) sur le job 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 job Cloud Run communique avec des API Google 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 sections Autorisations de déploiement et Gérer les accès.

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.

gcloud

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

Si vous créez un job, ignorez cette étape. Si vous mettez à jour un job existant, téléchargez sa configuration YAML :
```
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é.