Utiliser des libellés

Cette page explique comment définir, modifier et supprimer des libellés dans votre service et vos révisions Cloud Run. Pour Cloud Run, les libellés sont des paires clé/valeur qui sont appliquées au service et aux révisions. Lorsque vous définissez un libellé sur un service Cloud Run, une révision portant ce libellé est créée pour ce service. Le libellé n'est pas appliqué aux anciennes versions.

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

Règles d'utilisation des libellés

La règle suivante s'applique à l'utilisation des libellés définis sur un service Cloud Run :

Seuls les libellés Google Cloud valides peuvent être utilisés sur Cloud Run.

Définir ou modifier des libellés

Toute modification 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 Cloud Console, de la ligne de commande gcloud ou d'un fichier YAML lorsque vous déployez une nouvelle révision.

Console

  1. Accédez à Cloud Run

  2. Cochez la case située à gauche du service 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 selon vos besoins.

  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.

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 la configuration de service existante à 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 beta run services replace. Veillez à ne modifier que les champs indiqués.

  1. Pour afficher et télécharger la configuration, exécutez la commande suivante :

    gcloud run services describe SERVICE --format export > service.yaml
  2. Mettez à jour l'attribut labels :

    apiVersion: serving.knative.dev/v1
    kind: Service
    metadata:
      name: SERVICE
      labels:
        LABEL: 'VALUE'

    Remplacez

    • SERVICE par le nom de votre service Cloud Run ;
    • LABEL par le nom du libellé ;
    • VALUE par la valeur souhaitée.
  3. Remplacez la configuration du service en utilisant la commande suivante :

    gcloud beta run services replace service.yaml

Répertorier les services par libellé

Vous pouvez répertorier les services par libellé à l'aide d'un filtre du SDK Cloud :

  gcloud run services 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é

Vous pouvez supprimer des libellés à l'aide de la console ou de la ligne de commande.

Console

  1. Accédez à Cloud Run

  2. Cochez la case située à gauche du service duquel vous supprimez 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.

  5. Localisez le libellé que vous souhaitez supprimer.

  6. 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.

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