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 :

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

  1. 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.
  2. Pour définir un libellé sur une tâche existante, procédez comme suit :

    gcloud run jobs update JOB_NAME --labels KEY=VALUE
  3. 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

  1. 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
  2. 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.

  3. 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é.