Workflows de libellés

Les libellés sont des paires clé-valeur que vous pouvez utiliser pour identifier et regrouper des workflows associés, et stocker des métadonnées sur un workflow. Vous pouvez spécifier plusieurs libellés pour un workflow.

Cette page explique comment utiliser des libellés avec vos workflows. Elle décrit également comment ajouter, mettre à jour et supprimer les libellés d'un workflow.

Pour regrouper des workflows et d'autres ressources dans Google Cloud des rapports, des audits et un contrôle des accès dans votre Google Cloud organisation, utilisez des tags. Les tags et les libellés fonctionnent indépendamment les uns des autres. Vous pouvez appliquer les deux au même workflow.

Qu'est-ce qu'un libellé ?

Un libellé est une paire clé-valeur que vous pouvez attribuer aux workflows Google Cloud . Elle vous aide à organiser ces ressources et à gérer vos coûts à grande échelle avec la précision dont vous avez besoin. Vous pouvez associer une étiquette à chaque ressource, puis filtrer les ressources par étiquette. Les informations sur les étiquettes sont transmises au système de facturation. Ainsi, vous pouvez trier vos frais facturés par étiquette. Grâce aux rapports de facturation intégrés, vous pouvez filtrer et regrouper les coûts par étiquette de ressource. Vous pouvez également utiliser des étiquettes pour interroger les exportations de données de facturation.

Exigences relatives aux libellés

Les libellés appliqués à une ressource doivent répondre aux exigences suivantes :

  • Chaque ressource peut comporter jusqu'à 64 étiquettes.
  • Chaque libellé doit correspondre à une paire clé/valeur.
  • Les clés doivent comporter un (1) caractère au minimum et 63 au maximum, et ne peuvent pas être vides. Les valeurs peuvent être vides et comporter 63 caractères au maximum.
  • Les clés et les valeurs ne peuvent contenir que des lettres minuscules, des chiffres, des traits de soulignement et des tirets. Tous les caractères doivent être au format d'encodage UTF-8. Les caractères internationaux sont autorisés. Les clés doivent commencer par une lettre minuscule ou un caractère international.
  • La partie clé d'un libellé doit être unique au sein d'une ressource spécifique. Cependant, vous pouvez utiliser la même clé avec plusieurs ressources.

Ces limites s'appliquent à la clé et à la valeur de chaque libellé, ainsi qu'aux ressources Google Cloud individuelles associées à des libellés. Vous pouvez appliquer autant de libellés que vous le souhaitez à toutes les ressources d'un projet.

Cas d'utilisation courants des libellés

Voici quelques cas d'utilisation courants des libellés :

  • Libellés d'équipe ou de centre de coûts: ajoutez des libellés en fonction de l'équipe ou du centre de coûts pour distinguer les workflows appartenant à différentes équipes (par exemple, team:research et team:analytics). Vous pouvez utiliser ce type de libellé pour la comptabilité analytique ou la budgétisation.

  • Libellés de composant : par exemple, component:redis, component:frontend, component:ingest et component:dashboard.

  • Libellés d'environnement ou d'étape : par exemple, environment:production et environment:test.

  • Libellés d'état : par exemple, state:active, state:readytodelete et state:archive.

  • Libellés de propriété : permettent d'identifier les équipes responsables des opérations (par exemple, team:shopping-cart).

Nous vous déconseillons de créer de grands nombres d'étiquettes uniques (par exemple, pour les horodatages ou les valeurs individuelles pour chaque appel d'API). Le problème avec cette approche est que lorsque les valeurs changent fréquemment ou que des clés encombrent le catalogue, il est difficile de filtrer efficacement les ressources et de créer des rapports associés.

Libellés et tags

Pour les ressources, les libellés peuvent être utilisés comme des annotations qu'il est possible d'interroger. Cependant, ils ne peuvent pas être utilisés pour définir des conditions dans le cadre de vos stratégies. Les tags permettent d'autoriser ou de refuser des règles de manière conditionnelle selon qu'une ressource possède un tag spécifique ou non, grâce à un contrôle ultraprécis sur les règles. Pour en savoir plus, consultez la présentation des tags.

Ajouter ou mettre à jour des libellés

Lorsque vous créez un workflow, vous pouvez ajouter un ou plusieurs libellés. Vous pouvez également ajouter ou modifier des libellés lorsque vous modifiez un workflow.

La mise à jour d'un libellé existant ou l'ajout d'un libellé peut prendre jusqu'à 10 minutes.

Filtrer les workflows par libellé

Vous pouvez rechercher et afficher des workflows spécifiques en les filtrant par libellé.

Console

  1. Dans Google Cloud Console, accédez à la page Workflows :

    Accéder à "Workflows"

  2. Dans le champ Filtre, sélectionnez Libellés comme critère de filtrage, puis dans la liste Valeurs, sélectionnez une paire clé-valeur.

gcloud

Utilisez l'option --filter avec la commande gcloud workflows list:

gcloud workflows list \
    --filter labels.KEY=VALUE

Remplacez KEY et VALUE par une paire clé-valeur de libellé.

Pour en savoir plus sur la syntaxe des filtres dans la Google Cloud CLI, consultez gcloud topic filters.

Les libellés de workflow sont hérités par les exécutions du workflow. Pour afficher les libellés d'exécution, utilisez la méthode workflows.executions.list pour lister et filtrer les exécutions de workflow.

Supprimer les étiquettes

Vous pouvez supprimer un libellé spécifique à l'aide de la console Google Cloud ou utiliser la CLI gcloud pour supprimer tous les libellés d'un workflow.

Console

  1. Dans Google Cloud Console, accédez à la page Workflows :

    Accéder à "Workflows"

  2. Cliquez sur le nom du workflow que vous souhaitez mettre à jour.

    La page Détails du workflow s'affiche.

  3. Cliquez sur Modifier.

    La page Modifier le workflow s'affiche.

  4. À côté du libellé que vous souhaitez supprimer, cliquez sur Supprimer l'élément.

  5. Cliquez sur Suivant.

  6. Pour redéployer le workflow, cliquez sur Déployer.

gcloud

Utilisez l'option --labels avec une valeur vide et la commande gcloud workflows deploy:

gcloud workflows deploy WORKFLOW_NAME \
    --labels="" \
    --source=YAML_OR_JSON_SOURCE_FILE

Remplacez les éléments suivants :

  • WORKFLOW_NAME: Nom de votre workflow.

  • YAML_OR_JSON_SOURCE_FILE: fichier source du workflow au format YAML ou JSON. Exemple : myFirstWorkflow.yaml.