Configurer des libellés pour les jobs

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 valides Google Cloud 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 au format YAML ou sous template dans Terraform. Si vous configurez des libellés à l'aide de la consoleGoogle Cloud ou de Google Cloud CLI, Cloud Run ajoute les libellés aux attributs metadata.labels et spec.template.metadata.labels.

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 APIGoogle 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 pages Autorisations de déploiement et Gérer les accès.

Définir ou modifier des libellés

Vous pouvez utiliser la console Google Cloud , Google Cloud CLI, YAML ou Terraform pour définir un libellé sur un job Cloud Run.

Console

  1. Dans la console Google Cloud , accédez à la page Jobs de Cloud Run :

    Accédez à Cloud Run

  2. Cochez la case située à gauche du job sur lequel vous définissez le libellé.

  3. Assurez-vous que le panneau d'informations situé tout à droite est activé (Afficher le panneau d'informations).

  4. Cliquez sur Labels (Libellés) pour afficher le volet des libellés.

    Définir un libellé

  5. Pour modifier une valeur de clé de libellé existante, localisez le libellé et modifiez la valeur.

  6. Pour définir un nouveau libellé sur le service, cliquez sur Add Label (Ajouter un libellé), puis saisissez la clé et la valeur.

  7. Cliquez sur Enregistrer.

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

    Remplacez les éléments suivants :

    • JOB_NAME par le nom de votre job.
    • KEY par le nom de votre clé de libellé.
    • VALUE par la valeur de la clé.
    • IMAGE_URL : 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

    Remplacez les éléments suivants :

    • LABEL par le nom du libellé.
    • VALUE par la valeur choisie.

    Vous pouvez également spécifier d'autres éléments de configuration, tels que des variables d'environnement ou des limites de mémoire.

    Cloud Run ne propage que les libellés définis dans l'attribut spec.template.metadata.labels à Cloud Billing et Cloud Logging.

  3. Mettez à jour la configuration de job existante :

    gcloud run jobs replace job.yaml

Terraform

Pour savoir comment appliquer ou supprimer une configuration Terraform, consultez Commandes Terraform de base.

Ajoutez les éléments suivants à une ressource google_cloud_run_v2_job dans votre configuration Terraform :

resource "google_cloud_run_v2_job" "default" {
  name     = "JOB_NAME"
  location = "REGION"

  template {
    template {
      containers {
        image = "us-docker.pkg.dev/cloudrun/container/job"
      }
    }
    labels = {
    "LABEL":"VALUE"
    }
  }
  labels = {
    "LABEL":"VALUE"
  }
}

Remplacez les éléments suivants :

  • JOB_NAME par le nom de votre job Cloud Run
  • REGION : la région Google Cloud . Exemple : europe-west1.
  • LABEL : nom du libellé.
  • VALUE : valeur choisie.

Cloud Run ne propage que les libellés définis sous template à Cloud Billing et Cloud Logging.

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 les éléments suivants :

  • LABEL : nom du libellé
  • VALUE : 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

Remplacez les éléments suivants :

  • JOB : nom de votre job Cloud Run.
  • LABEL : nom de votre libellé