Documentation Oracle Cloud Infrastructure

Balisage des ressources

Utilisez le balisage avec le fournisseur Terraform pour Oracle Cloud Infrastructure.

Lorsque vous disposez de nombreuses ressources (par exemple, des instances, des réseaux cloud virtuels, des équilibreurs de charge et des volumes de blocs) dans plusieurs compartiments de votre location, il peut être difficile de suivre les ressources utilisées à des fins spécifiques ainsi que de les agréger, de générer des rapports associés ou de réaliser des actions globales sur celles-ci. Le balisage permet de définir des clés et des valeurs, et de les associer à des ressources. Vous pouvez ensuite utiliser les balises pour organiser et répertorier les ressources en fonction des besoins de votre entreprise.

Il existe deux types de balise :

Les balises définies sont configurées dans votre location par un administrateur. Seuls les utilisateurs autorisés à utiliser les balises définies peuvent les appliquer aux ressources. Les balises définies fournissent une correspondance clé/valeur et sont organisées en combinant les espaces de noms de balise avec les clés de balise à l'aide de la syntaxe par points. Par exemple, un espace de noms de balise nommé HumanResources peut comporter une clé nommée CostCenter. Vous associez ensuite l'espace de noms et la clé HumanResource.CostCenter, puis affectez la balise.

Les balises à format libre peuvent être appliquées par n'importe quel utilisateur disposant des droits d'accès sur la ressource. Les balises à format libre sont de simples correspondances clé/valeur.

  • Reportez-vous à la référence oci_identity_tag_namespace pour obtenir des instructions sur la gestion du cycle de vie des espaces de noms de balise.
  • Reportez-vous à la référence oci_identity_tag pour obtenir des instructions sur la gestion des balises.

Le fichier de configuration tags.tf de nos exemples contient plusieurs ressources liées au balisage.

La référence complète des ressources et sources de données prises en charge par le fournisseur OCI Terraform contient les détails relatifs à la syntaxe, aux arguments et aux attributs. La référence complète est disponible à l'adresse docs.oracle.com et dans le registre Terraform.

Pour obtenir des informations détaillées sur les balises et leurs fonctionnalités, reportez-vous à Présentation de Tagging.

Propagation du balisage sur les ressources

Les services OCI propagent toutes les balises à format libre et les balises définies d'une ressource principale aux ressources secondaires lorsque les différentes ressources prennent en charge ce type de balise. Par exemple, si votre configuration Terraform comporte une instance de calcul en tant que ressource principale et une carte d'interface réseau virtuelle en tant que ressource secondaire imbriquée, les balises de l'instance de calcul sont propagées vers la carte d'interface réseau virtuelle.

Cette propagation peut engendrer une dérive de l'état Terraform entraînant une différence après application. Pour éviter toute dérive potentielle, ajoutez explicitement toutes les balises à format libre et les balises définies de la ressource principale sur les ressources secondaires dans le cadre de la configuration.

Le même comportement peut être observé lors de l'utilisation de la fonctionnalité Valeurs de balise par défaut ou Balises requises. Evitez la dérive en appliquant les valeurs de balise par défaut ou les balises requises sur toutes les ressources (principale et secondaires, le cas échéant) dans la location où les valeurs de balise par défaut ou les balises requises existent.