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 auf, 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.

Tools, die nur lesbar sind

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 Informationen und Anleitungen up-to-date. Dieses Tool bietet Zugriff auf die neueste EKS-Dokumentation, einschließlich neuer Funktionen und aktueller Verbesserungen, von denen Agenten möglicherweise nichts wissen.

Parameter:

  • Anfrage (erforderlich): Ihre spezifische Frage oder Suchanfrage im Zusammenhang mit der EKS-Dokumentation, den 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 Problembehandlung auf der Grundlage einer Abfrage nach Informationen zur Problembehandlung. Es hilft bei der Identifizierung häufiger Probleme und bietet step-by-step Lösungen.

Parameter:

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

describe_eks_resource

Ruft detaillierte Informationen zu einer bestimmten EKS-Clusterressource 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 Addon-Namen)

  • cluster (erfordert cluster_name), nodegroup (erfordert cluster_name und resource_name als Knotengruppennamen).

  • 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 Einblicke in den EKS-Cluster und Empfehlungen zur Optimierung ab. Bietet umsetzbare Erkenntnisse zur Sicherheits-, Leistungs- und Kostenoptimierung auf der Grundlage von AWS Best Practices und Clusteranalysen.

Parameter:

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

  • Kategorie (optional): Optionale Kategorie zum Filtern von Erkenntnissen (z. B. „MISCONFIGURATION“ oder „UPGRADE_READINESS“).

  • insight_id (optional): Optionale ID einer bestimmten Erkenntnis, für die detaillierte Informationen abgerufen werden sollen.

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

get_eks_vpc_config

Ruft die VPC-Konfiguration für einen EKS-Cluster ab, einschließlich Subnetzen, Routentabellen 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, falls nicht angegeben).

get_k8s_events

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

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 Nodes,). 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 Logs abgerufen werden sollen.

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

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

  • previous (optional): Gibt zuvor beendete Container-Logs zurück (standardmäßig falsch). Nützlich, um Protokolle für Pods abzurufen, die neu gestartet werden.

  • since_seconds (optional): Gibt nur Protokolle zurück, die jünger als diese Anzahl von Sekunden sind. Nützlich, um aktuelle Protokolle abzurufen, ohne den gesamten Verlauf abzurufen.

  • tail_lines (optional): Anzahl der Zeilen, die vom 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', '1'). apps/v1', 'networking.k8s.io/v Verwenden Sie das list_api_versions Tool, um verfügbare API-Versionen zu finden.

  • field_selector (optional): Feldauswahl 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"," 1"). apps/v1", "networking.k8s.io/v

  • 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 zu lesenden Kubernetes-Ressource.

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

generate_app_manifest

Generiert standardisierte Kubernetes-Bereitstellungs- und Dienstmanifeste 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-Image-URI mit Tag (z. B. 123456789012.dkr.ecr.region.amazonaws.com/repo: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 dem Internet verbunden“ (öffentlicher Zugang).

  • Standard: „intern“.

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

  • memory (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 ab, wobei die Filterung auf der Grundlage der Eingabeparameter erfolgt und Standardprotokollgruppen unterstützt werden, die für die EKS-Cluster-Observability 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 durchsucht werden sollen. 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“: Systemprotokolle auf Knotenebene

  • „Leistung“: Protokolle zu Leistungsmetriken

  • „Steuerebene“: Protokolle der EKS-Steuerungsebene

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

  • resource_name (optional): Ressourcenname, nach dem in Protokollnachrichten gesucht werden soll (z. B. Pod-Name, Knotenname, Containername). Wird verwendet, um Logs nach der spezifischen Ressource zu filtern.

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

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

  • end_time (optional): Endzeit im ISO-Format (z. B. „2023-01-01T 01:00:00 Z“). 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“, „field=value“).

  • limit (optional): Maximale Anzahl zurückzugebender Protokolleinträge. 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 und 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 geeignete Dimensionen für den Ressourcentyp und die Metrik enthalten (z. B. '{“ ClusterName „: „my-cluster“, "PodName„: „my-pod“, „Namespace“: „default"}').

  • metric_name (erforderlich): Name der Metrik, die abgerufen werden soll. Allgemeine Beispiele:

  • cpu_usage_total: CPU-Auslastung insgesamt

  • memory_rss: Speichernutzung von Resident Set Size

  • network_rx_bytes: Empfangene Netzwerk-Bytes

  • network_tx_bytes: Übertragene Netzwerk-Bytes

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

  • "ContainerInsights": Für Container-Metriken

  • "AWS/EC2": EC2 Zum Beispiel Metriken

  • "AWS/EKS": Für Metriken der EKS-Kontrollebene

  • Minuten (optional): Anzahl der Minuten, für die nach Metriken gesucht werden soll. Standard: 15. Wird ignoriert, wenn start_time angegeben ist.

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

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

  • limit (optional): Maximale Anzahl zurückzugebender Datenpunkte. 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 aber 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

Hier finden Sie Anleitungen zu CloudWatch Metriken für bestimmte Ressourcentypen in EKS-Clustern. Hilfreich für den Agenten bei der Bestimmung der richtigen Dimensionen für die Verwendung mit dem Tool get_cloudwatch_metrics.

Parameter:

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

get_policies_for_role

Ruft alle Richtlinien ab, die einer bestimmten IAM-Rolle zugeordnet sind, einschließlich Richtlinien zur Übernahme von Rollen, verwalteten Richtlinien und Inline-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 schreibgeschützten Tools beschrieben, die für den EKS MCP-Server verfügbar sind. Beachten Sie, dass (Stand „heute“) alle Kubernetes-API-Schreiboperationen nur auf Folgendes zugreifen können:

  • Öffentliche Cluster (=true) endpointPublicAccess

manage_k8s_resource

Verwaltet eine einzelne Kubernetes-Ressource mit Schreiboperationen (erstellen, aktualisieren, patchen oder löschen).

Parameter:

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

  • create:Eine neue Ressource erstellen

  • 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"," 1"). apps/v1", "networking.k8s.io/v

  • body (optional): Ressourcendefinition als JSON-Zeichenfolge. Erforderlich für Erstellungs-, Ersetzungs- und Patch-Operationen. Für Erstellen und Ersetzen sollte dies eine vollständige Ressourcendefinition sein. Bei Patches 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 Nodes,). 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 Ressourcen mit Namespace 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 bei 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 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 Generierungs-, Bereitstellungs-, Beschreib- und Löschvorgänge). Dieser Name wird zur Ableitung des CloudFormation Stack-Namens verwendet und in die Clusterressourcen eingebettet.

  • Operation (erforderlich): Durchzuführender Vorgang. Zulässige Werte:

  • generate: Generieren Sie eine CloudFormation Vorlage

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

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

  • delete: Löscht einen Stapel CloudFormation

  • template_content (optional): Inhalt der CloudFormation Vorlage (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 mit 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. Dabei kann es sich entweder um eine einzelne JSON-Zeichenfolge oder um ein Array von JSON-Zeichenfolgen handeln.

  • 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.