Organisez les ressources Amazon EKS à l'aide de balises - Amazon EKS

Aidez à améliorer cette page

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Vous souhaitez contribuer à ce guide de l'utilisateur ? Choisissez le GitHub lien Modifier cette page sur qui se trouve dans le volet droit de chaque page. Vos contributions aideront à améliorer notre guide de l'utilisateur pour tout le monde.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Organisez les ressources Amazon EKS à l'aide de balises

Vous pouvez utiliser les balises pour vous aider à gérer vos ressources Amazon EKS. Cette rubrique fournit une vue d'ensemble de la fonction des identifications et indique comment créer des identifications.

Note

Les balises sont un type de métadonnées distinct de Kubernetes étiquettes et annotations. Pour plus d'informations sur ces autres types de métadonnées, consultez les sections suivantes dans le Kubernetes documentation :

Principes de base des étiquettes

Une étiquette est une étiquette que vous attribuez à une AWS ressource. Chaque balise est constituée d'une clé et d'une valeur facultative.

Les tags vous permettent de classer vos AWS ressources par catégories. Par exemple, vous pouvez classer les ressources par objectif, propriétaire ou environnement. Lorsque vous avez de nombreuses ressources de même type, vous pouvez utiliser les balises que vous avez attribuées à une ressource spécifique pour identifier cette dernière rapidement. Par exemple, vous pouvez définir un ensemble de balises pour vos clusters Amazon EKS afin de vous aider à suivre le propriétaire et le niveau de pile de chaque cluster. Nous vous recommandons de concevoir un ensemble cohérent de clés de balise pour chaque type de ressource. Vous pouvez rechercher et filtrer les ressources en fonction des balises que vous ajoutez.

Une fois que vous avez ajouté une balise, vous pouvez modifier les clés et valeurs de balise ou supprimer les balises d'une ressource à tout moment. Si vous supprimez une ressource, ses balises sont également supprimées.

Les balises n'ont aucune signification sémantique pour Amazon EKS et sont interprétées strictement comme des chaînes de caractères. Vous pouvez définir la valeur d'une balise à une chaîne vide. Cependant, vous ne pouvez pas définir la valeur d'une balise sur null. Si vous ajoutez une balise ayant la même clé qu'une balise existante sur cette ressource, la nouvelle valeur remplace l'ancienne valeur.

Si vous utilisez AWS Identity and Access Management (IAM), vous pouvez contrôler quels utilisateurs de votre AWS compte sont autorisés à gérer les tags.

Balisage de vos ressources 

Les ressources Amazon EKS suivantes prennent en charge les balises :

  • clusters

  • groupes de nœuds gérés

  • profils Fargate

Vous pouvez baliser ces ressources à l'aide des éléments suivants :

  • Si vous utilisez la console Amazon EKS, vous pouvez appliquer des balises à des ressources nouvelles ou existantes à tout moment. Pour ce faire, utilisez la commande Identifications sur la page de ressources correspondante. Pour de plus amples informations, veuillez consulter Gestion des étiquettes à l'aide de la console.

  • Si vous utilisezeksctl, vous pouvez appliquer des balises aux ressources lors de leur création à l'aide de --tags cette option.

  • Si vous utilisez la AWS CLI, l'API Amazon EKS ou un AWS SDK, vous pouvez appliquer des balises aux nouvelles ressources en utilisant le tags paramètre de l'action d'API correspondante. Vous pouvez également appliquer des identifications aux ressources à l'aide de l'action d'API TagResource. Pour de plus amples informations, veuillez consulter TagResource.

Lorsque vous exécutez certaines actions de création des ressources, vous pouvez également spécifier des balises pour la ressource en même temps que vous la créez. Si les balises ne peuvent pas être appliquées lors de la création de la ressource, celle-ci ne peut pas être créée. Ce mécanisme garantit que les ressources que vous prévoyez de baliser sont créées avec les balises que vous spécifiez ou ne sont pas créées du tout. Si vous balisez des ressources lorsque vous les créez, il n'est pas nécessaire d'exécuter des scripts de balisage personnalisés après avoir créé la ressource.

Les balises ne se propagent pas aux autres ressources associées à la ressource que vous créez. Par exemple, les balises de profil Fargate ne se propagent pas aux autres ressources associées au profil Fargate, telles que Pods qui sont programmés avec elle.

Restrictions liées aux étiquettes

Les restrictions suivantes s’appliquent aux balises :

  • Un maximum de 50 balises peut être associé à une ressource.

  • Les clés de balise ne peuvent pas être répétées pour une ressource. Chaque clé de balise doit être unique et ne peut avoir qu'une seule valeur.

  • Les clés peuvent contenir jusqu'à 128 caractères en UTF-8.

  • Les valeurs peuvent contenir jusqu'à 256 caractères en UTF-8.

  • Si plusieurs AWS services et ressources utilisent votre schéma de balisage, limitez les types de caractères que vous utilisez. Certains services peuvent présenter des restrictions sur les caractères autorisés. Les caractères généralement autorisés sont les lettres, les chiffres, les espaces et les caractères suivants : + - = . _ : / @.

  • Les clés et valeurs de balise sont sensibles à la casse.

  • N'utilisez pas aws: AWS:, ni aucune combinaison majuscules ou minuscules, comme un préfixe pour les clés ou les valeurs. Ils sont réservés uniquement à AWS l'usage. Vous ne pouvez pas modifier ou supprimer des clés ou des valeurs de balise avec ce préfixe. Les balises comportant ce préfixe ne sont pas prises en compte dans votre tags-per-resource limite.

Identification de vos ressources pour facturation

Lorsque vous appliquez des balises à des clusters Amazon EKS, vous pouvez les utiliser pour la répartition des coûts dans vos Cost & Usage Reports (Rapports sur les coûts et l'utilisation). Les données de mesure de vos rapports sur les coût et l'utilisation illustrent l'utilisation parmi tous vos clusters Amazon EKS. Pour plus d'informations, consultez le rapport sur les AWS coûts et l'utilisation dans le Guide AWS de l'utilisateur de facturation.

La balise de répartition des coûts AWS générée, en particulieraws:eks:cluster-name, vous permet de ventiler les coûts des EC2 instances Amazon par cluster Amazon EKS individuel dans Cost Explorer. Cependant, cette balise ne prend pas en compte les dépenses du plan de contrôle. La balise est automatiquement ajoutée aux EC2 instances Amazon qui participent à un cluster Amazon EKS. Ce comportement se produit indépendamment du fait que les instances soient provisionnées à l'aide de groupes de nœuds gérés par Amazon EKS ou non, Karpenter, ou directement auprès d'Amazon EC2. Cette identification n'est pas prise en compte dans la limite des 50 identifications. Pour utiliser le tag, le propriétaire du compte doit l'activer dans la console AWS de facturation ou à l'aide de l'API. Lorsqu'un titulaire du compte de gestion d'une AWS organisation active le tag, celui-ci est également activé pour tous les comptes des membres de l'organisation.

Vous pouvez également organiser vos informations de facturation en fonction des ressources possédant les mêmes valeurs de clé d‘étiquette. Par exemple, vous pouvez étiqueter plusieurs ressources avec un nom d'application spécifique, puis organiser vos informations de facturation. De cette façon, vous pouvez afficher le coût total de cette application dans plusieurs services. Pour plus d'informations sur la configuration d'un rapport de répartition des coûts avec des balises, consultez le rapport de répartition des coûts mensuel dans le guide AWS de l'utilisateur de facturation.

Note

Si vous venez d'activer la création de rapports, les données du mois en cours peuvent être consultées après 24 heures.

Cost Explorer est un outil de reporting disponible dans le cadre du niveau AWS gratuit. Vous pouvez utiliser Cost Explorer pour consulter les graphiques de vos ressources Amazon EKS des 13 derniers mois. Vous pouvez également prévoir le montant que vous êtes susceptible de dépenser au cours des trois prochains mois. Vous pouvez observer des tendances dans le montant que vous dépensez en AWS ressources au fil du temps. Par exemple, vous pouvez l'utiliser pour identifier les zones qui méritent d'être approfondies et connaître les tendances que vous pouvez utiliser pour comprendre vos coûts. Vous pouvez également spécifier des plages de temps pour les données et afficher des données temporelles par jour ou par mois.

Gestion des étiquettes à l'aide de la console

À l'aide de la console Amazon EKS, vous pouvez gérer les identifications qui sont associées à des clusters et groupes de nœuds gérés nouveaux ou existants.

Lorsque vous sélectionnez une page spécifique aux ressources dans la console Amazon EKS, cette page affiche une liste de ces ressources. Par exemple, si vous sélectionnez Clusters dans le panneau de navigation de gauche, la console affiche une liste de clusters Amazon EKS. Lorsque vous sélectionnez une ressource de l'une de ces listes (par exemple, un cluster spécifique) qui prend en charge les balises, vous pouvez afficher et gérer ses balises dans l'onglet Tags (Balises).

Vous pouvez également utiliser l'éditeur de balises dans le AWS Management Console, qui fournit un moyen unifié de gérer vos balises. Pour plus d'informations, consultez la section Marquage de vos AWS ressources avec l'éditeur de balises dans le guide de l'utilisateur de l'éditeur de AWS balises.

Ajout de balises lors de la création d'une ressource

Vous pouvez ajouter des identifications aux clusters, groupes de nœuds gérés et profils Fargate Amazon EKS lorsque vous les créez. Pour de plus amples informations, veuillez consulter Création d'un cluster Amazon EKS.

Ajout et suppression de balises sur une ressource

Vous pouvez ajouter ou supprimer les balises associées à vos clusters directement depuis la page de la ressource.

  1. Ouvrez la console Amazon EKS.

  2. Dans la barre de navigation, sélectionnez la AWS région à utiliser.

  3. Dans le volet de navigation de gauche, choisissez Clusters.

  4. Choisissez un cluster spécifique.

  5. Choisissez l'onglet Tags (Identifications), puis Manage tags (Gérer les identifications).

  6. Sur la page Gérer les balises, ajoutez ou supprimez vos balises si nécessaire.

    • Pour ajouter une balise, choisissez Ajouter une balise. Puis spécifiez la clé et la valeur de chaque balise.

    • Pour supprimer une balise, sélectionnez Remove tag (Supprimer une balise).

  7. Répétez cette procédure pour chaque balise que vous voulez ajouter ou supprimer.

  8. Choisissez Update (Mettre à jour) pour terminer.

Gestion des identifications à l'aide de la CLI, de l'API ou de eksctl

Utilisez les commandes AWS CLI ou les opérations d'API Amazon EKS suivantes pour ajouter, mettre à jour, répertorier et supprimer les balises de vos ressources. Vous pouvez uniquement utiliser eksctl pour ajouter des balises tout en créant simultanément les nouvelles ressources avec une seule commande.

Tâche AWS CLI AWS Outils pour Windows PowerShell Action d’API

Ajouter ou remplacer une ou plusieurs étiquettes.

tag-resource

Ajouter une EKSResource étiquette

TagResource

Supprimer une ou plusieurs étiquettes.

untag-resource

Supprimer- EKSResource Tag

UntagResource

Les exemples suivants montrent comment baliser ou débaliser des ressources à l'aide de la AWS CLI.

Exemple 1 : Étiqueter un cluster existant

La commande suivante permet d'étiqueter un cluster existant.

aws eks tag-resource --resource-arn resource_ARN --tags team=devs
Exemple 2 : Supprimer les étiquettes d'un cluster existant

La commande suivante permet de supprimer une étiquette d'un cluster existant.

aws eks untag-resource --resource-arn resource_ARN --tag-keys tag_key
Exemple 3 : Afficher la liste des étiquettes d'une ressource

La commande suivante permet de répertorier l'ensemble des balises qui sont associées à une ressource existante.

aws eks list-tags-for-resource --resource-arn resource_ARN

Lorsque vous utilisez certaines actions de création de ressources, vous pouvez spécifier des balises en même temps que vous créez la ressource. Les actions suivantes prennent en charge la spécification d'une balise lorsque vous créez une ressource.

Tâche AWS CLI AWS Outils pour Windows PowerShell Action d’API eksctl

Créer un cluster

create-cluster

Nouveau- EKSCluster

CreateCluster

create cluster

Créer un groupe de nœuds géré*

create-nodegroup

Nouveau- EKSNodegroup

CreateNodegroup

create nodegroup

Créer un profil Fargate

create-fargate-profile

Nouveau- EKSFargate Profil

CreateFargateProfile.html

create fargateprofile

  • Si vous souhaitez également étiqueter les EC2 instances Amazon lorsque vous créez un groupe de nœuds gérés, créez le groupe de nœuds gérés à l'aide d'un modèle de lancement. Pour de plus amples informations, veuillez consulter Marquage des instances Amazon EC2 . Si vos instances existent déjà, vous pouvez étiqueter manuellement les instances. Pour plus d'informations, consultez la section Marquage de vos ressources dans le guide de l' EC2 utilisateur Amazon.