View a markdown version of this page

Referenz zu den Amazon EKS MCP-Servertools - Amazon EKS

Unterstützung für die Verbesserung dieser Seite beitragen

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Um zu diesem Benutzerhandbuch beizutragen, wählen Sie den GitHub Link Diese Seite bearbeiten unter, der sich im rechten Bereich jeder Seite befindet.

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Referenz zu den Amazon EKS MCP-Servertools

Der Server stellt die folgenden MCP-Tools zur Verfügung.

Anmerkung

Der Amazon EKS MCP Server befindet sich in der Vorschauversion für Amazon EKS und kann sich ändern.

Read-only Werkzeuge

In diesem Abschnitt werden die schreibgeschützten Tools beschrieben, die für den EKS MCP Server verfügbar sind. Beachten Sie, dass alle schreibgeschützten Kubernetes-API-Operationen auf beide zugreifen können:

  • Private Cluster (siehe Privater Cluster-Endpunkt)

  • Öffentliche Cluster

search_eks_documentation

Suchen Sie in der EKS-Dokumentation nach aktuellen Informationen und Anleitungen. Dieses Tool bietet Zugriff auf die neueste EKS-Dokumentation, einschließlich neuer Funktionen und aktueller Verbesserungen, von denen Agenten möglicherweise nichts wissen.

Parameter:

  • Abfrage (erforderlich): Ihre spezifische Frage oder Suchanfrage zur EKS-Dokumentation, zu Funktionen oder bewährten Methoden.

  • Limit (optional): Maximale Anzahl zurückzugebender Dokumentationsergebnisse (1—10). Standard: 5.

search_eks_troubleshooting_guide

Durchsucht den EKS-Leitfaden zur Fehlerbehebung nach Informationen zur Problembehandlung, die auf einer Abfrage basieren. Es hilft bei der Identifizierung häufiger Probleme und bietet schrittweise Lösungen.

Parameter:

  • Abfrage (erforderlich): Ihre spezifische Frage oder Problembeschreibung im Zusammenhang mit der EKS-Fehlerbehebung.

describe_eks_resource

Ruft detaillierte Informationen zu einer bestimmten EKS-Cluster-Ressource ab, einschließlich Konfiguration, Status und Metadaten.

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters (erforderlich für Ressourcen im Clusterbereich).

  • resource_type (erforderlich): Der zu beschreibende EKS-Ressourcentyp. Zulässige Werte:

  • accessentry (erfordert cluster_name und resource_name als PrincipalArn)

  • Addon (benötigt cluster_name und resource_name als Addonname)

  • cluster (benötigt cluster_name), nodegroup (benötigt cluster_name und resource_name als Nodegroup-Name).

  • resource_name (optional): Name der spezifischen Ressource, die beschrieben werden soll (für die meisten Ressourcentypen erforderlich).

list_eks_resources

Listet EKS-Ressourcen eines bestimmten Typs auf und gibt eine Zusammenfassung aller Ressourcen des angegebenen Typs zurück, auf die zugegriffen werden kann.

Parameter:

  • resource_type (erforderlich): Der aufzulistende EKS-Ressourcentyp. Zulässige Werte:

  • accessentry (erfordert cluster_name)

  • Addon (benötigt cluster_name)

  • Cluster (keine zusätzlichen Parameter erforderlich)

  • nodegroup (erfordert cluster_name).

  • cluster_name (optional): Name des EKS-Clusters (erforderlich für Ressourcen im Clusterbereich).

get_eks_insights

Ruft EKS-Cluster-Erkenntnisse und Empfehlungen zur Optimierung ab. Bietet umsetzbare Erkenntnisse für Sicherheit, Leistung und Kostenoptimierung auf der Grundlage von AWS Best Practices und Clusteranalysen.

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters.

  • Kategorie (optional): Optionale Kategorie, nach der Erkenntnisse gefiltert werden können (z. B. „MISCONFIGURATION“ oder „UPGRADE_READINESS“).

  • insight_id (optional): Optionale ID eines bestimmten Einblicks, für den detaillierte Informationen abgerufen werden sollen.

  • next_token (optional): Optionales Token für die Paginierung, um die nächsten Ergebnisse abzurufen.

get_eks_vpc_config

Ruft die VPC-Konfiguration für einen EKS-Cluster ab, einschließlich Subnetzen, Routing-Tabellen und Netzwerkkonnektivität.

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters, für den die VPC-Konfiguration abgerufen werden soll.

  • vpc_id (optional): ID der spezifischen VPC, die abgefragt werden soll (optional, verwendet Cluster-VPC, wenn nicht angegeben).

get_k8s_events

Ruft Kubernetes-Ereignisse ab, die sich auf bestimmte Ressourcen zur Problembehandlung und Überwachung beziehen.

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters, in dem sich die Ressource befindet.

  • kind (erforderlich): Art des beteiligten Objekts (z. B. „Pod“, „Deployment“, „Service“). Muss genau mit der Art der Ressource übereinstimmen.

  • name (erforderlich): Name des beteiligten Objekts, für das Ereignisse abgerufen werden sollen.

  • namespace (optional): Namespace des beteiligten Objekts. Erforderlich für Ressourcen mit Namespace (wie Pods, Deployments). Nicht erforderlich für Ressourcen im Clusterbereich (wie Knoten,). PersistentVolumes

get_pod_logs

Ruft Protokolle von Pods in einem EKS-Cluster mit Filteroptionen ab.

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters, auf dem der Pod ausgeführt wird.

  • Namespace (erforderlich): Kubernetes-Namespace, in dem sich der Pod befindet.

  • pod_name (erforderlich): Name des Pods, von dem Protokolle abgerufen werden sollen.

  • container_name (optional): Name des spezifischen Containers, aus dem Protokolle abgerufen werden sollen. Nur erforderlich, wenn der Pod mehrere Container enthält.

  • limit_bytes (optional): Maximale Anzahl von Bytes, die zurückgegeben werden sollen. Standard: 10 KB (10240 Byte).

  • previous (optional): Gibt frühere terminierte Container-Logs zurück (die Standardeinstellung ist false). Nützlich, um Protokolle für Pods abzurufen, die gerade neu gestartet werden.

  • since_seconds (optional): Gibt nur Logs zurück, die neuer als so viele Sekunden sind. Nützlich, um aktuelle Logs abzurufen, ohne den gesamten Verlauf abzurufen.

  • tail_lines (optional): Anzahl der Zeilen, die am Ende der Protokolle zurückgegeben werden sollen. Standard: 100.

list_api_versions

Listet alle verfügbaren API-Versionen im angegebenen Kubernetes-Cluster auf.

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters.

list_k8s_resources

Listet Kubernetes-Ressourcen einer bestimmten Art in einem EKS-Cluster auf.

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters, in dem sich die Ressourcen befinden.

  • kind (erforderlich): Art der aufzulistenden Kubernetes-Ressourcen (z. B. 'Pod', 'Service', 'Deployment'). Verwenden Sie das list_api_versions Tool, um verfügbare Ressourcentypen zu finden.

  • api_version (erforderlich): API-Version der Kubernetes-Ressourcen (z. B. 'v1', '', 'networking.k8s. apps/v1 io/v1'). Verwenden Sie das list_api_versions Tool, um verfügbare API-Versionen zu finden.

  • field_selector (optional): Feldselektor zum Filtern von Ressourcen (z. B. 'metadata.name=my-pod, status.phase=running'). Verwendet dieselbe Syntax wie das Flag --field-selector von kubectl.

  • label_selector (optional): Label-Selektor zum Filtern von Ressourcen (z. B. 'app=nginx, tier=frontend'). Verwendet dieselbe Syntax wie --selector das Flag von Kubectl.

  • namespace (optional): Namespace der aufzulistenden Kubernetes-Ressourcen. Falls nicht angegeben, werden Ressourcen in allen Namespaces aufgelistet (für Ressourcen mit Namespaces).

read_k8s_resource

Ruft detaillierte Informationen zu einer bestimmten Kubernetes-Ressource in einem EKS-Cluster ab.

Parameter:

  • api_version (erforderlich): API-Version der Kubernetes-Ressource (z. B. „v1"," „, „networking.k8s. apps/v1 io/v1„).

  • cluster_name (erforderlich): Name des EKS-Clusters, in dem sich die Ressource befindet.

  • kind (erforderlich): Art der Kubernetes-Ressource (z. B. „Pod“, „Service“, „Deployment“).

  • name (erforderlich): Name der Kubernetes-Ressource, die gelesen werden soll.

  • namespace (optional): Namespace der Kubernetes-Ressource. Erforderlich für Ressourcen mit Namespace. Nicht erforderlich für Ressourcen im Clusterbereich (wie Knoten,). PersistentVolumes

generate_app_manifest

Generiert standardisierte Kubernetes-Bereitstellungs- und Servicemanifeste für containerisierte Anwendungen.

Parameter:

  • app_name (erforderlich): Name der Anwendung. Wird für Bereitstellungs- und Dienstnamen sowie für Labels verwendet.

  • image_uri (erforderlich): Vollständige ECR-Bild-URI mit Tag (z. B. 123456789012.dkr.ecr.region.amazonaws. com/repoimage_uri (erforderlich): Vollständige ECR-Bild-URI mit Tag (z. B. 123456789012.dkr.ecr.region.amazonaws. ----sep----:tag). Muss den vollständigen Repository-Pfad und das Tag enthalten.

  • load_balancer_scheme (optional): Load Balancer-Schema. AWS Zulässige Werte:

  • „intern“ (nur private VPC)

  • „mit Internetanschluss“ (öffentlicher Zugang).

  • Standard: „intern“.

  • cpu (optional): CPU-Anfrage für jeden Container (z. B. „100m“ für 0,1 CPU-Kerne, „500m“ für einen halben Kern). Standard: „100m“.

  • Speicher (optional): Speicheranforderung für jeden Container (z. B. „128Mi“ für 128 MiB, „1Gi“ für 1 GiB). Standard: „128Mi“

  • Namespace (optional): Kubernetes-Namespace, in dem die Anwendung bereitgestellt werden soll. Standard: „Standard“.

  • port (optional): Container-Port, auf dem die Anwendung lauscht. Standard: 80

  • Replikate (optional): Anzahl der bereitzustellenden Replikate. Standard: 2

get_cloudwatch_logs

Fragt CloudWatch Protokolle mit Filterung auf der Grundlage der Eingabeparameter ab und unterstützt Standardprotokollgruppen, die für die EKS-Cluster-Beobachtbarkeit verwendet werden.

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters, in dem sich die Ressource befindet. Wird verwendet, um den Namen der CloudWatch Protokollgruppe zu erstellen.

  • resource_type (erforderlich): Ressourcentyp, nach dem Logs gesucht werden soll. Gültige Werte: +"pod“, „node“, „container“, „cluster“. Dies bestimmt, wie Protokolle gefiltert werden.

  • log_type (erforderlich): Der abzufragende Protokolltyp. Zulässige Werte:

  • „Anwendung“: Protokolle Container/application

  • „Host“: Node-level Systemprotokolle

  • „performance“: Protokolle zu Leistungsmetriken

  • „Control-Plane“: EKS-Protokolle der Kontrollebene

  • „your-log-group-name“: Geben Sie direkt einen benutzerdefinierten Protokollgruppennamen ein. CloudWatch

  • resource_name (optional): Ressourcenname, nach dem in Protokollnachrichten gesucht werden soll (z. B. Pod-Name, Knotenname, Containername). Wird verwendet, um Protokolle für die spezifische Ressource zu filtern.

  • Minuten (optional): Anzahl der Minuten, in denen nach Protokollen gesucht werden soll. Standard: 15. Wird ignoriert, wenn start_time angegeben wird. Verwenden Sie kleinere Werte für aktuelle Probleme, größere Werte für historische Analysen.

  • start_time (optional): Startzeit im ISO-Format (z. B. „T00:00:00Z2023-01-01 „). Falls angegeben, überschreibt es den Minuten-Parameter.

  • end_time (optional): Endzeit im ISO-Format (z. B. „T01:00:00Z2023-01-01 „). Falls nicht angegeben, wird standardmäßig die aktuelle Uhrzeit verwendet.

  • Felder (optional): Benutzerdefinierte Felder, die in die Abfrageergebnisse aufgenommen werden sollen (standardmäßig "@timestamp, @message „). Verwenden Sie die CloudWatch Logs Insights-Feldsyntax.

  • filter_pattern (optional): Zusätzliches anzuwendendes CloudWatch Logs-Filtermuster. Verwendet die CloudWatch Logs Insights-Syntax (z. B. „ERROR“, „Feld=Wert“).

  • limit (optional): Maximale Anzahl von Protokolleinträgen, die zurückgegeben werden sollen. Verwenden Sie niedrigere Werte (10-50) für schnellere Abfragen, höhere Werte (100-1000) für umfassendere Ergebnisse. Höhere Werte wirken sich negativ auf die Performance aus.

get_cloudwatch_metrics

Ruft CloudWatch Metriken und Datenpunkte für die EKS-Clusterüberwachung und Leistungsanalyse ab. Verarbeitet Container Insights-Metriken, benutzerdefinierte Metriken sowie konfigurierbare Zeiträume und Dimensionen.

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters, für den Metriken abgerufen werden sollen.

  • dimensions (erforderlich): Dimensionen, die für die CloudWatch Metrikabfrage als JSON-Zeichenfolge verwendet werden sollen. Muss die entsprechenden Dimensionen für den Ressourcentyp und die Metrik enthalten (z. B. '{“ ClusterName „: „my-cluster“, "PodName„: „my-pod“, „Namespace“: „default"}').

  • metric_name (erforderlich): Name der abzurufenden Metrik. Allgemeine Beispiele:

  • cpu_usage_total: Gesamte CPU-Auslastung

  • memory_rss: Speicherauslastung von Resident Set Size

  • network_rx_bytes: Empfangene Netzwerk-Bytes

  • network_tx_bytes: Netzwerk-Bytes übertragen

  • Namespace (erforderlich): CloudWatch Namespace, in dem die Metrik gespeichert ist. Typische Werte:

  • "ContainerInsights": Für Container-Metriken

  • "AWS/EC2": Für EC2-Instance-Metriken

  • "AWS/EKS": Für EKS-Steuerungsebenen-Metriken

  • Minuten (optional): Anzahl der Minuten, in denen auf Kennzahlen zurückgegriffen werden soll. Standard: 15. Wird ignoriert, wenn start_time angegeben wird.

  • start_time (optional): Startzeit im ISO-Format (z. B. „2023-01-01 „). T00:00:00Z Falls angegeben, überschreibt es den Minuten-Parameter.

  • end_time (optional): Endzeit im ISO-Format (z. B. „T01:00:00Z2023-01-01 „). Falls nicht angegeben, wird standardmäßig die aktuelle Uhrzeit verwendet.

  • Limit (optional): Maximale Anzahl von Datenpunkten, die zurückgegeben werden sollen. Höhere Werte (100-1000) liefern detailliertere Daten, können sich jedoch auf die Leistung auswirken. Standard: 50.

  • Zeitraum (optional): Zeitraum in Sekunden für die metrischen Datenpunkte. Standard: 60 (1 Minute). Niedrigere Werte (1—60) bieten eine höhere Auflösung, sind jedoch möglicherweise weniger verfügbar.

  • stat (optional): Statistik, die für die Metrikaggregation verwendet werden soll. Standard: „Durchschnitt“. Zulässige Werte:

  • Average: Mittelwert während des Zeitraums

  • Sum: Gesamtwert während des Zeitraums

  • Maximum: Höchster Wert während des Zeitraums

  • Minimum: Niedrigster Wert während des Zeitraums

  • SampleCount: Anzahl der Proben während des Zeitraums.

get_eks_metrics_guidance

Holen Sie sich Anleitungen zu CloudWatch Metriken für bestimmte Ressourcentypen in EKS-Clustern. Nützlich für den Agenten bei der Bestimmung der richtigen Dimensionen, die mit dem Tool get_cloudwatch_metrics verwendet werden sollen.

Parameter:

  • resource_type (erforderlich): Art der Ressource, für die Metriken abgerufen werden sollen (Cluster, Knoten, Pod, Namespace, Service).

get_policies_for_role

Ruft alle Richtlinien ab, die einer angegebenen IAM-Rolle zugeordnet sind, einschließlich Richtlinien zur Übernahme von Rollen, verwalteten Richtlinien und eingebetteten Richtlinien.

Parameter:

  • role_name (erforderlich): Name der IAM-Rolle, für die Richtlinien abgerufen werden sollen. Die Rolle muss in Ihrem Konto vorhanden sein. AWS

Tools mit vollem Zugriff (Schreib-)

In diesem Abschnitt werden die Vollzugriffs- (Schreib-) Tools beschrieben, die für den EKS MCP Server verfügbar sind. Beachten Sie, dass (Stand „heute“) für alle Kubernetes-API-Operationen mit Schreibzugriff nur auf Folgendes zugegriffen werden kann:

  • Öffentliche Cluster (Endpunkt PublicAccess = true)

manage_k8s_resource

Verwaltet eine einzelne Kubernetes-Ressource mit Schreibvorgängen (Erstellen, Aktualisieren, Patchen oder Löschen).

Parameter:

  • Operation (erforderlich): Vorgang, der für die Ressource ausgeführt werden soll. Zulässige Werte:

  • create:Erstellen Sie eine neue Ressource

  • replace: Ersetzt eine bestehende Ressource

  • patch: Aktualisiere bestimmte Felder einer vorhandenen Ressource

  • delete: Löscht eine bestehende Ressource

  • Hinweis: Verwenden Sie read_k8s_resource zum Lesen von Ressourcen und list_k8s_resources zum Auflisten mehrerer Ressourcen.

  • cluster_name (erforderlich): Name des EKS-Clusters, in dem sich die Ressource befindet oder erstellt wird.

  • kind (erforderlich): Art der Kubernetes-Ressource (z. B. „Pod“, „Service“, „Deployment“).

  • api_version (erforderlich): API-Version der Kubernetes-Ressource (z. B. „v1"," „, „networking.k8s. apps/v1 io/v1„).

  • body (optional): Ressourcendefinition als JSON-Zeichenfolge. Erforderlich für Erstellungs-, Ersetzungs- und Patch-Operationen. Für Create and Replace sollte dies eine vollständige Ressourcendefinition sein. Bei einem Patch sollte dies nur die zu aktualisierenden Felder enthalten.

  • name (optional): Name der Kubernetes-Ressource. Erforderlich für alle Operationen außer create (wo es im Hauptteil angegeben werden kann).

  • namespace (optional): Namespace der Kubernetes-Ressource. Erforderlich für Ressourcen mit Namespace. Nicht erforderlich für Ressourcen im Clusterbereich (wie Knoten,). PersistentVolumes

apply_yaml

Wendet Kubernetes-YAML-Manifeste auf einen EKS-Cluster an.

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters, in dem die Ressourcen erstellt oder aktualisiert werden.

  • namespace (erforderlich): Kubernetes-Namespace, auf den Ressourcen angewendet werden sollen. Wird für Namespace-Ressourcen verwendet, die keinen Namespace angeben.

  • yaml_content (erforderlich): YAML-Inhalt, der auf den Cluster angewendet werden soll. Kann mehrere Dokumente enthalten, die durch '-- 'getrennt sind.

  • force (optional): Ob Ressourcen aktualisiert werden sollen, falls sie bereits existieren (ähnlich wie kubectl apply). Auf false setzen, um nur neue Ressourcen zu erstellen.

manage_eks_stacks

Verwaltet CloudFormation EKS-Stacks mit Vorgängen zum Generieren von Vorlagen, zum Bereitstellen, Beschreiben und Löschen von EKS-Clustern und der ihnen zugrunde liegenden Infrastruktur. Die Clustererstellung dauert in der Regel 15 bis 20 Minuten. Für Bereitstellungs- und Löschvorgänge muss der Stack mit diesem Tool erstellt worden sein (d. h. mit CreatedBy = gekennzeichnetEksMcpServer).

Parameter:

  • cluster_name (erforderlich): Name des EKS-Clusters (für Operationen zum Generieren, Bereitstellen, Beschreiben und Löschen). Dieser Name wird zur Ableitung des CloudFormation Stack-Namens verwendet und in die Cluster-Ressourcen eingebettet.

  • Vorgang (erforderlich): Der auszuführende Vorgang. Zulässige Werte:

  • generate: Generieren Sie eine CloudFormation Vorlage

  • deploy: Stellen Sie einen CloudFormation Stapel bereit (erforderlichtemplate_content)

  • describe: Describe/read ein CloudFormation Stapel (schreibgeschützt)

  • delete: Löscht einen Stapel CloudFormation

  • template_content (optional): CloudFormation Vorlageninhalt (für Bereitstellungsvorgänge). Dies sollte der vollständige Inhalt der YAML- oder JSON-Vorlage sein. Unterstützt sowohl einzelne Ressourcen als auch YAML-Inhalte aus mehreren Dokumenten, getrennt durch '-- '.

add_inline_policy

Fügt einer IAM-Rolle eine neue Inline-Richtlinie hinzu.

Parameter:

  • Berechtigungen (erforderlich): Berechtigungen, die als JSON-Zeichenfolgen, die IAM-Richtlinienanweisungen darstellen, in die Richtlinie aufgenommen werden sollen. Kann entweder eine einzelne JSON-Zeichenfolge oder ein Array von JSON-Zeichenfolgen sein.

  • policy_name (erforderlich): Name der zu erstellenden Inline-Richtlinie. Muss innerhalb der Rolle eindeutig sein.

  • role_name (erforderlich): Name der IAM-Rolle, zu der die Richtlinie hinzugefügt werden soll. Die Rolle muss existieren.