Organisation von Amazon-EKS-Ressourcen mit Tags - Amazon EKS

Unterstützung für die Verbesserung dieser Seite beitragen

Um zu diesem Benutzerhandbuch beizutragen, klicken Sie auf den Link Diese Seite auf GitHub bearbeiten, der sich im rechten Bereich jeder Seite befindet.

Organisation von Amazon-EKS-Ressourcen mit Tags

Sie können Tags verwenden, die Sie bei der Verwaltung Ihrer Amazon-EKS-Ressourcen unterstützen. Dieses Thema bietet einen Überblick über die Tags -Funktion und zeigt, wie Sie Tags erstellen können.

Anmerkung

Tags sind eine Art von Metadaten, die von Kubernetes-Labels und Annotationen getrennt sind. Weitere Informationen zu diesen anderen Metadatentypen finden Sie in folgenden Abschnitten der Kubernetes-Dokumentation:

Grundlagen zu Tags (Markierungen)

Ein Tag ist eine Markierung, die Sie einer AWS-Ressource zuordnen. Jedes Tag (Markierung) besteht aus einem Schlüssel und einem optionalen Wert.

Sie können mit Tags auch Ihre AWS-Ressourcen kategorisieren. Sie können Ressourcen beispielsweise nach Zweck, Inhaber oder Umgebung kategorisieren. Wenn Sie viele Ressourcen desselben Typs haben, können Sie die Tags, die Sie einer bestimmten Ressource zugewiesen haben, verwenden, um diese Ressource schnell zu identifizieren. Sie können beispielsweise eine Reihe von Tags für Ihre Amazon-EKS-Cluster definieren, um Ihnen dabei zu helfen, den Eigentümer und die Stack-Ebene jedes einzelnen Clusters nachzuverfolgen. Sie sollten für jeden Ressourcentyp einen konsistenten Satz von Tag-Schlüsseln entwickeln. Anschließend können Sie die Ressourcen basierend auf den hinzugefügten Tags suchen und filtern.

Nachdem Sie ein Tag hinzugefügt haben, können Sie jederzeit Tag-Schlüssel und -Werte bearbeiten oder Tags aus einer Ressource entfernen. Wenn Sie eine Ressource löschen, werden alle Tags (Markierungen) der Ressource ebenfalls gelöscht.

Tags haben keine semantische Bedeutung für Amazon EKS und werden ausschließlich als Zeichenfolgen interpretiert. Sie können den Wert eines Tags auf eine leere Zeichenfolge setzen. Sie können jedoch den Wert eines Tags nicht auf null setzen. Wenn Sie ein Tag (Markierung) mit demselben Schlüssel wie ein vorhandener Tag (Markierung) für die Ressource hinzufügen, wird der alte Wert mit dem neuen überschrieben.

Wenn Sie AWS Identity and Access Management (IAM) verwenden, können Sie steuern, welche Benutzer in Ihrem AWS-Konto Tags verwalten dürfen.

Markieren Ihrer -Ressourcen

Die folgenden Amazon-EKS-Ressourcen unterstützen Tags:

  • Cluster

  • Verwaltete Knotengruppen

  • Fargate-Profile

So wenden Sie Tags auf Ressourcen an:

  • Wenn Sie die Amazon-EKS-Konsole verwenden, können Sie Tags jederzeit auf neue oder vorhandene Ressourcen anwenden. Dies können Sie über dasTagsauf der entsprechenden Ressourcenseite. Weitere Informationen finden Sie unter Arbeiten mit Tags über die Konsole.

  • Wenn Sie eksctl verwenden, können Sie Tags auf Ressourcen anwenden, wenn sie mit der --tags-Option erstellt wurden.

  • Wenn Sie die AWS-CLI, die Amazon-EKS-API oder ein AWS-SDK verwenden, können Sie Tags mithilfe des tags-Parameters auf der entsprechenden API-Aktion auf neue Ressourcen anwenden. Sie können auch über die TagResource-API Tags auf Ressourcen anwenden. Weitere Informationen finden Sie unter TagResource.

Wenn Sie einige Aktionen zur Erstellung von Ressourcen verwenden, können Sie gleichzeitig mit der Erstellung auch Tags für die Ressource angeben. Wenn Tags nicht angewendet werden können, während die Ressource erstellt wird, kann die Ressource nicht erstellt werden. Dieser Mechanismus stellt sicher, dass Ressourcen, die Sie mit Tags versehen möchten, entweder mit den von Ihnen angegebenen Tags oder gar nicht erstellt werden. Wenn Sie Ressourcen bei ihrer Erstellung mit Tags versehen, müssen Sie nach der Erstellung der Ressource keine benutzerdefinierten Tagging-Skripte ausführen.

Tags werden nicht auf andere Ressourcen bertragen, die der von Ihnen erstellten Ressource zugeordnet sind. Fargate-Profil-Tags werden beispielsweise nicht zu weiteren dem Fargate-Profil zugeordneten Ressourcen propagiert, z. B. zu den Pods, die mit ihm geplant sind.

Tag-Einschränkungen

Für Tags gelten die folgenden Einschränkungen:

  • Maximal 50 Tags können einer Ressource zugeordnet werden.

  • Tag-Schlüssel können nicht für eine Ressource wiederholt werden. Jeder Tag-Schlüssel muss eindeutig sein, und jeder Schlüssel darf nur einen Wert besitzen.

  • Schlüssel können aus bis zu 128 Zeichen im UTF-8-Format bestehen.

  • Werte können aus bis zu 256 Zeichen im UTF-8-Format bestehen.

  • Wenn mehrere AWS-Services und Ressourcen Ihr Tagging-Schema verwenden, beschränken Sie die Arten von Zeichen, die Sie verwenden. Einige Services haben möglicherweise Einschränkungen für zulässige Zeichen. Allgemein erlaubte Zeichen sind: Buchstaben, Zahlen, Leerzeichen und die folgenden Sonderzeichen: + - = . _ : / @.

  • Bei Tag-Schlüsseln und -Werten muss die Groß- und Kleinschreibung beachtet werden.

  • Verwenden Sie weder aws:, AWS: noch oder andere Schreibweisen hiervon mit Kombinationen aus Groß- und Kleinbuchstaben als Präfix für Schlüssel oder Werte. Diese sind nur für die AWS-Verwendung reserviert. Sie können keine Tag-Schlüssel oder Werte mit diesem Präfix bearbeiten oder löschen. Tags mit diesem Präfix werden nicht zum Limit für Tags pro Ressource gezählt.

Markieren von Ressourcen für die Fakturierung

Wenn Sie Tags auf Amazon-EKS-Cluster anwenden, können Sie sie für die Kostenzuweisung in Ihren Kosten- und Nutzungsberichten verwenden. Die Messdaten in Ihren Kosten- und Nutzungsberichten zeigen die Nutzung für alle Ihre Amazon-EKS-Cluster an. Weitere Informationen finden Sie im AWS-Kosten- und Nutzungsbericht im Benutzerhandbuch zur AWS-Fakturierung.

Mit dem AWS generierten Kostenzuordnungs-Tag, insbesondere aws:eks:cluster-name, können Sie die Amazon-EC2-Instance-Kosten nach einzelnen Amazon-EKS-Clustern im Cost Explorer (Kosten-Explorer) aufschlüsseln. Dieses Tag erfasst jedoch nicht die Kosten der Steuerebene. Das Tag wird automatisch zu Amazon-EC2-Instances hinzugefügt, die Teil eines Amazon-EKS-Clusters sind. Dieses Verhalten tritt unabhängig davon auf, ob die Instances mit von Amazon EKS verwalteten Knotengruppen, Karpenter oder direkt mit Amazon EC2 bereitgestellt werden. Dieses spezielle Tag wird nicht auf das Limit von 50 Tags angerechnet. Um das Tag zu verwenden, muss der Kontoinhaber es in der AWS-Fakturierungskonsole oder mithilfe der API aktivieren. Wenn ein Besitzer des AWS-Organizations-Verwaltungskontos das Tag aktiviert, wird es für alle Mitgliedskonten der Organisation ebenfalls aktiviert.

Sie können Ihre Rechnungsinformationen auch auf der Grundlage von Ressourcen organisieren, die dieselben Tag-Schlüsselwerte haben. Beispielsweise können Sie mehrere Ressourcen mit einem bestimmten Anwendungsnamen taggen und dann Ihre Fakturierungsinformationen organisieren. Auf diese Weise können Sie die Gesamtkosten dieser Anwendung über mehrere Services hinweg sehen. Weitere Informationen zum Einrichten eines Kostenzuordnungsberichts mit Markierungen finden Sie unter Monatlicher Kostenzuordnungsbericht im Benutzerhandbuch zur AWS-Fakturierung.

Anmerkung

Wenn Sie die Berichterstellung gerade erst aktiviert haben, werden die Daten für den aktuellen Monat nach 24 Stunden bereitgestellt.

Cost Explorer ist ein Reporting-Tool, das als Teil des kostenlosen Kontingents von AWS verfügbar ist. Sie können Cost Explorer verwenden, um Diagramme Ihrer Amazon-EKS-Ressourcen der letzten 13 Monate anzuzeigen. Sie können auch prognostizieren, wie viel Sie wahrscheinlich für die nächsten drei Monate ausgeben werden. Sie können Muster sehen, wie viel Sie für AWS-Ressourcen im Zeitablauf ausgeben. Sie können es zum Beispiel verwenden, um Bereiche zu identifizieren, die eine genauere Untersuchung erfordern, sowie um Trends auszumachen, die Ihnen helfen, Ihre Kosten zu verstehen. Sie können auch Zeitbereiche für die Daten angeben und die Daten nach Tagen oder Monate anzeigen lassen.

Arbeiten mit Tags über die Konsole

Mithilfe der Amazon-EKS-Konsole können Sie die Tags im Zusammenhang mit neuen oder vorhandenen Clustern und verwalteten Knotengruppen verwalten.

Wenn Sie eine ressourcenspezifische Seite in der Amazon-EKS-Konsole auswählen, wird auf der Seite eine Liste der Ressourcen angezeigt. Wenn Sie beispielsweise Clusters (Cluster) im Navigationsbereich auswählen, zeigt die Konsole eine Liste der Amazon EKS-Cluster an. Wenn Sie eine Ressource aus einer dieser Listen auswählen (z. B. einen bestimmten Cluster) und die Ressource Tags unterstützt, können Sie deren Tags auf der Registerkarte Tags anzeigen und verwalten.

Sie können auch den Tag-Editor in der AWS-Managementkonsole verwenden, der Ihnen eine einheitliche Möglichkeit gibt, Ihre Tags zu verwalten. Weitere Informationen zum Markieren Ihrer AWS-Ressourcen mit Tag-Editor finden Sie im AWS-Tag-Editor-Benutzerhandbuch.

Hinzufügen von Tags zu einer Ressource bei der Erstellung

Sie können Tags zu Amazon EKS-Clustern und verwalteten Knotengruppen hinzufügen, wenn Sie sie erstellen. Weitere Informationen finden Sie unter Amazon-EKS-Cluster erstellen.

Hinzufügen und Löschen von Tags für eine Ressource

Sie können die Tags, die mit Ihren Clustern verbunden sind, direkt auf der Seite der Ressource hinzufügen oder löschen.

  1. Öffnen Sie die Amazon-EKS-Konsole.

  2. Wählen Sie in der Navigationsleiste die gewünschte AWS-Region aus.

  3. Wählen Sie im linken Navigationsbereich die Option Cluster aus.

  4. Wählen Sie einen bestimmten Cluster aus.

  5. Wählen Sie die Registerkarte Tags und dann Manage tags (Tags verwalten).

  6. Fügen Sie auf der Seite Manage tags (Tags verwalten) Ihre Tags bei Bedarf hinzu oder löschen Sie sie.

    • Um einen Tag hinzuzufügen, wählen Sie Add tag (Tag hinzufügen). Geben Sie dann den Schlüssel und den Wert für jedes Tag an.

    • Um ein Tag zu entfernen, wählen Sie Remove tag (Tag entfernen) aus.

  7. Wiederholen Sie diesen Vorgang für jedes Tag, das Sie hinzufügen oder löschen möchten.

  8. Wählen Sie zum Abschluss Update (Aktualisieren) aus.

Arbeiten mit Tags mittels CLI, API oder eksctl

Verwenden Sie die folgenden AWS-CLI-Befehle oder Amazon-EKS-API-Operationen, um die Tags für Ihre Ressourcen hinzuzufügen, zu aktualisieren, aufzulisten und zu löschen. Sie können eksctl nur dann zum Hinzufügen von Tags verwenden, wenn Sie gleichzeitig neue Ressourcen mit einem Befehl erstellen.

Aufgabe AWS-CLI AWS-Tools für Windows PowerShell API-Aktion

Fügen Sie einen oder mehrere Tags hinzu oder überschreiben Sie sie.

tag-resource

Add-EKSResourceTag

TagResource

Löschen Sie ein oder mehrere Tags.

untag-resource

Remove-EKSResourceTag

UntagResource

Die folgenden Beispiele zeigen, wie man Tags an Ressourcen mithilfe der AWS-CLI hinzufügt oder entfernt.

Beispiel 1: Markieren eines bestehenden Clusters

Der folgende Befehl markiert einen vorhandenen Cluster.

aws eks tag-resource --resource-arn resource_ARN --tags team=devs
Beispiel 2: Entfernen von Tags von einem bestehenden Cluster

Der folgende Befehl löscht ein Tag von einem bestehenden Cluster.

aws eks untag-resource --resource-arn resource_ARN --tag-keys tag_key
Beispiel 3: Tags für eine Ressource auflisten

Der folgende Befehl listet die Tags auf, die einer vorhandenen Ressource zugeordnet sind.

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

Wenn Sie einige Aktionen zur Erstellung von Ressourcen verwenden, können Sie gleichzeitig mit der Erstellung der Ressource auch Tags angeben. Die folgenden Aktionen unterstützen das Taggen beim Erstellen einer Ressource.

Aufgabe AWS-CLI AWS-Tools für Windows PowerShell API-Aktion eksctl

Erstellen eines Clusters

create-cluster

New-EKSCluster

CreateCluster

create cluster

Erstellen einer verwalteten Knotengruppe

create-nodegroup

New-EKSNodegroup

CreateNodegroup

create nodegroup

Erstellen eines Fargate-Profils

create-fargate-profile

New-EKSFargateProfile

CreateFargateProfile.html

create fargateprofile

  • Wenn Sie beim Erstellen einer verwalteten Knotengruppe auch die Amazon-EC2-Instances mit Tags versehen möchten, erstellen Sie die verwaltete Knotengruppe mithilfe einer Startvorlage. Weitere Informationen finden Sie unter Markieren von Amazon-EC2-Instances. Wenn Ihre Instances bereits vorhanden sind, können Sie die Instanzen manuell mit Tags versehen. Weitere Informationen finden Sie unter Tagging Ihrer Ressourcen im Amazon-EC2-Benutzerhandbuch.