Annotations et libellés

Vous pouvez utiliser des annotations et des libellés avec Infrastructure Manager. Elles ne sont pas obligatoires. Ce document liste les ressources auxquelles vous pouvez associer des libellés et des annotations, et explique comment les utiliser et où les afficher. Pour utiliser des annotations ou des libellés avec Infra Manager, utilisez les options --annotation et --label.

Que sont les annotations et les libellés ?

Les annotations sont des paires clé-valeur de texte libre. Vous pouvez les utiliser pour joindre des informations arbitraires associées à la ressource.

Vous pouvez utiliser des libellés pour organiser les ressources. Par exemple, vous pouvez appliquer une logique en fonction de la sélection de libellés.

Les annotations sont utilisées pour stocker des informations non identifiantes généralement utilisées par les outils client pour stocker des données arbitraires associées à une ressource, tandis que les libellés sont généralement utilisés pour organiser les ressources.

Pour en savoir plus sur l'utilisation des annotations avec Google Cloud, consultez la documentation sur les annotations AIP. Pour en savoir plus sur l'utilisation des libellés, consultez la documentation de la présentation des libellés.

Contraintes d'annotation et de libellé

Comme pour les annotations, les libellés sont des paires clé-valeur qui doivent respecter les limites suivantes:

  • Les clés et les valeurs doivent toutes deux comporter 128 octets ou moins.
  • Les clés et les valeurs ne peuvent contenir que des lettres minuscules, des chiffres, des traits de soulignement et des tirets.
  • Les clés doivent commencer par une lettre minuscule ou un caractère international.
  • Tous les caractères doivent être au format d'encodage UTF-8. Les caractères internationaux sont acceptés. Exemple :

    --annotation="appVersion=v.1.2.3,environment=production"
    

Utiliser des annotations et des libellés avec Infra Manager

L'utilisation d'annotations et de libellés peut être appliquée de différentes manières à votre infrastructure Google Cloud .

Lorsque vous créez ou mettez à jour des déploiements avec Infra Manager, vous pouvez utiliser des annotations et des libellés pour surveiller les déploiements ou interroger des ensembles d'informations. Pour en savoir plus, consultez les pages Déploiement d'une infrastructure à l'aide d'Infra Manager, Mettre à jour un déploiement ou Aperçu d'un déploiement.

Étape suivante

Utilisez Infra Manager pour standardiser, réutiliser et faire évoluer votre infrastructure avec Google Cloud: