View a markdown version of this page

Référence des outils du serveur Amazon EKS MCP - Amazon EKS
Read-only outilsOutils d'accès complet (écriture)

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.

Pour contribuer à ce guide de l'utilisateur, cliquez sur le GitHub lien Modifier cette page qui se trouve dans le volet droit de chaque 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.

Référence des outils du serveur Amazon EKS MCP

Le serveur expose les outils MCP suivants.

Note

Le serveur Amazon EKS MCP est en version préliminaire pour Amazon EKS et est sujet à modification.

Read-only outils

Cette section décrit les outils en lecture seule disponibles pour le serveur EKS MCP. Notez que toutes les opérations de l'API Kubernetes en lecture seule peuvent accéder à la fois :

  • Clusters privés (voir Point de terminaison privé du cluster)

  • Clusters publics

search_eks_documentation

Consultez la documentation EKS pour obtenir des informations et des conseils à jour. Cet outil permet d'accéder à la documentation EKS la plus récente, y compris aux nouvelles fonctionnalités et aux améliorations récentes dont les agents ne sont peut-être pas au courant.

Paramètres :

  • requête (obligatoire) : votre question ou requête de recherche spécifique liée à la documentation, aux fonctionnalités ou aux meilleures pratiques d'EKS.

  • limite (facultatif) : nombre maximum de résultats de documentation à renvoyer (1 à 10). Valeur par défaut : 5.

search_eks_dépannage_guide

Effectue des recherches dans le guide de dépannage EKS pour obtenir des informations de dépannage en fonction d'une requête. Il permet d'identifier les problèmes courants et propose des solutions étape par étape.

Paramètres :

  • requête (obligatoire) : votre question spécifique ou la description du problème lié au dépannage d'EKS.

describe_eks_resource

Récupère des informations détaillées sur une ressource de cluster EKS spécifique, notamment la configuration, l'état et les métadonnées.

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS (obligatoire pour les ressources étendues au cluster).

  • resource_type (obligatoire) : type de ressource EKS à décrire. Valeurs valides :

  • accessentry (nécessite cluster_name et resource_name comme PrincipalArn)

  • addon (nécessite cluster_name et resource_name comme nom d'addon)

  • cluster (nécessite cluster_name), nodegroup (nécessite cluster_name et resource_name comme nom de groupe de nœuds).

  • resource_name (facultatif) : nom de la ressource spécifique à décrire (obligatoire pour la plupart des types de ressources).

list_eks_resources

Répertorie les ressources EKS d'un type spécifique, renvoyant un résumé de toutes les ressources du type spécifié qui sont accessibles.

Paramètres :

  • resource_type (obligatoire) : type de ressource EKS à répertorier. Valeurs valides :

  • accessentry (nécessite cluster_name)

  • addon (nécessite cluster_name)

  • cluster (aucun paramètre supplémentaire n'est requis)

  • nodegroup (nécessite cluster_name).

  • cluster_name (facultatif) : nom du cluster EKS (obligatoire pour les ressources étendues au cluster).

get_eks_insights

Récupère des informations sur le cluster EKS et des recommandations d'optimisation. Fournit des informations exploitables pour l'optimisation de la sécurité, des performances et des coûts sur la base des AWS meilleures pratiques et de l'analyse des clusters.

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS.

  • catégorie (facultatif) : catégorie facultative permettant de filtrer les informations (par exemple, « MISCONFIGURATION » ou « UPGRADE_READINESS »).

  • insight_id (facultatif) : identifiant facultatif d'un aperçu spécifique pour lequel vous souhaitez obtenir des informations détaillées.

  • next_token (facultatif) : jeton facultatif pour la pagination afin d'obtenir la prochaine série de résultats.

get_eks_vpc_config

Récupère la configuration VPC d'un cluster EKS, y compris les sous-réseaux, les tables de routage et la connectivité réseau.

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS pour lequel obtenir la configuration du VPC.

  • vpc_id (facultatif) : ID du VPC spécifique à interroger (facultatif, utilisera un VPC de cluster s'il n'est pas spécifié).

get_k8s_events

Récupère les événements Kubernetes liés à des ressources spécifiques pour le dépannage et la surveillance.

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS où se trouve la ressource.

  • type (obligatoire) : type de l'objet concerné (par exemple, « Pod », « Déploiement », « Service »). Doit correspondre exactement au type de ressource.

  • nom (obligatoire) : nom de l'objet concerné pour lequel vous souhaitez obtenir des événements.

  • namespace (facultatif) : espace de noms de l'objet concerné. Obligatoire pour les ressources avec espace de noms (comme les pods, les déploiements). Non requis pour les ressources limitées au cluster (comme les nœuds,). PersistentVolumes

get_pod_logs

Récupère les journaux des pods d'un cluster EKS avec des options de filtrage.

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS sur lequel le pod est exécuté.

  • namespace (obligatoire) : espace de noms Kubernetes où se trouve le pod.

  • pod_name (obligatoire) : nom du pod depuis lequel récupérer les journaux.

  • container_name (facultatif) : nom du conteneur spécifique à partir duquel obtenir les journaux. Obligatoire uniquement si le pod contient plusieurs contenants.

  • limit_bytes (facultatif) : nombre maximum d'octets à renvoyer. Par défaut : 10 Ko (10 240 octets).

  • previous (facultatif) : renvoie les journaux de conteneurs fermés précédemment (la valeur par défaut est false). Utile pour obtenir les journaux des pods qui redémarrent.

  • since_seconds (facultatif) : renvoie uniquement les journaux dont la durée est supérieure à ce nombre de secondes. Utile pour obtenir des journaux récents sans récupérer l'historique complet.

  • tail_lines (facultatif) : nombre de lignes à renvoyer à partir de la fin des journaux. Par défaut : 100.

lister les versions de l'API

Répertorie toutes les versions d'API disponibles dans le cluster Kubernetes spécifié.

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS.

list_k8s_resources

Répertorie les ressources Kubernetes d'un type spécifique dans un cluster EKS.

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS où se trouvent les ressources.

  • kind (obligatoire) : type de ressources Kubernetes à répertorier (par exemple, « Pod », « Service », « Deployment »). Utilisez l'list_api_versionsoutil pour trouver les types de ressources disponibles.

  • api_version (obligatoire) : version de l'API des ressources Kubernetes (par exemple, « v1 », « networking.k8s. apps/v1 io/v1'). Utilisez l'list_api_versionsoutil pour trouver les versions d'API disponibles.

  • field_selector (facultatif) : sélecteur de champ pour filtrer les ressources (par exemple, « metadata.name=my-pod, status.phase=Running »). Utilise la même syntaxe que l'indicateur --field-selector de kubectl.

  • label_selector (facultatif) : sélecteur d'étiquettes pour filtrer les ressources (par exemple, « app=nginx, tier=frontend »). Utilise la même syntaxe que l'indicateur de kubectl. --selector

  • namespace (facultatif) : espace de noms des ressources Kubernetes à répertorier. Si elles ne sont pas fournies, les ressources seront répertoriées dans tous les espaces de noms (pour les ressources avec espace de noms).

read_k8s_resource

Récupère des informations détaillées sur une ressource Kubernetes spécifique dans un cluster EKS.

Paramètres :

  • api_version (obligatoire) : version de l'API de la ressource Kubernetes (par exemple, « v1", « networking.k8s. apps/v1 io/v1«).

  • cluster_name (obligatoire) : nom du cluster EKS où se trouve la ressource.

  • type (obligatoire) : type de ressource Kubernetes (par exemple, « Pod », « Service », « Déploiement »).

  • name (obligatoire) : nom de la ressource Kubernetes à lire.

  • namespace (facultatif) : espace de noms de la ressource Kubernetes. Obligatoire pour les ressources avec espace de noms. Non requis pour les ressources limitées au cluster (comme les nœuds,). PersistentVolumes

générer_app_manifest

Génère des manifestes de déploiement et de service Kubernetes standardisés pour les applications conteneurisées.

Paramètres :

  • app_name (obligatoire) : nom de l'application. Utilisé pour les noms de déploiement et de service, ainsi que pour les étiquettes.

  • image_uri (obligatoire) : URI d'image ECR complet avec balise (par exemple, 123456789012.dkr.ecr.region.amazonaws). com/repo:étiquette). Doit inclure le chemin complet du référentiel et la balise.

  • load_balancer_scheme (facultatif) : schéma d'équilibrage de charge. AWS Valeurs valides :

  • « interne » (VPC privé uniquement)

  • « accès à Internet » (accès public).

  • Par défaut : « internal ».

  • cpu (facultatif) : demande de processeur pour chaque conteneur (par exemple, « 100 m » pour 0,1 cœur de processeur, « 500 m » pour un demi-cœur). Par défaut : « 100 m ».

  • mémoire (facultatif) : demande de mémoire pour chaque conteneur (par exemple, « 128Mi » pour 128 MiB, « 1Gi » pour 1 GiB). Par défaut : « 128Mi »

  • namespace (facultatif) : espace de noms Kubernetes dans lequel déployer l'application. Par défaut : « par défaut ».

  • port (facultatif) : port du conteneur sur lequel l'application écoute. Par défaut: 80

  • répliques (facultatif) : nombre de répliques à déployer. Par défaut: 2

get_cloudwatch_logs

CloudWatch Interroge les journaux avec filtrage basé sur les paramètres d'entrée et prise en charge des groupes de journaux standard utilisés pour l'observabilité du cluster EKS.

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS où se trouve la ressource. Utilisé pour créer le nom du groupe de CloudWatch journaux.

  • resource_type (obligatoire) : type de ressource pour rechercher dans les journaux. Valeurs valides :+"pod », « node », « container », « cluster ». Cela détermine la manière dont les journaux sont filtrés.

  • log_type (obligatoire) : type de journal à interroger. Valeurs valides :

  • « application » : Container/application journaux

  • « host » : journaux Node-level système

  • « performance » : journaux de mesures de performance

  • « plan de contrôle » : journaux du plan de contrôle EKS

  • « your-log-group-name » : fournissez directement un nom de groupe de journaux personnalisé. CloudWatch

  • resource_name (facultatif) : nom de la ressource à rechercher dans les messages du journal (par exemple, nom du pod, nom du conteneur). Utilisé pour filtrer les journaux d'une ressource spécifique.

  • minutes (facultatif) : nombre de minutes nécessaires pour consulter les journaux. Par défaut : 15. Ignoré si start_time est fourni. Utilisez des valeurs plus petites pour les numéros récents et des valeurs plus élevées pour l'analyse historique.

  • start_time (facultatif) : heure de début au format ISO (par exemple, « T00:00:00Z 2023-01-01 »). S'il est fourni, remplace le paramètre minutes.

  • end_time (facultatif) : heure de fin au format ISO (par exemple, « T01:00:00Z 2023-01-01 »). Si elle n'est pas fournie, la valeur par défaut est l'heure actuelle.

  • champs (facultatif) : champs personnalisés à inclure dans les résultats de la requête (par défaut, "@timestamp, @message «). Utilisez la syntaxe des champs CloudWatch Logs Insights.

  • filter_pattern (facultatif) : modèle de filtre de CloudWatch journaux supplémentaire à appliquer. Utilise la syntaxe de CloudWatch Logs Insights (par exemple, « ERROR », « field=value »).

  • limite (facultatif) : nombre maximum d'entrées de journal à renvoyer. Utilisez des valeurs plus faibles (10 à 50) pour des requêtes plus rapides et des valeurs plus élevées (100 à 1 000) pour des résultats plus complets. Des valeurs élevées peuvent avoir un impact sur les performances.

get_cloudwatch_metrics

Récupère CloudWatch les métriques et les points de données pour la surveillance du cluster EKS et l'analyse des performances. Gère les métriques Container Insights, les métriques personnalisées et les périodes et dimensions configurables.

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS pour lequel obtenir les métriques.

  • dimensions (obligatoire) : dimensions à utiliser pour la requête CloudWatch métrique sous forme de chaîne JSON. Doit inclure les dimensions appropriées pour le type de ressource et la métrique (par exemple, '{» ClusterName « : « my-cluster », "PodName« : « my-pod », « Namespace » : « default"}').

  • metric_name (obligatoire) : nom de la métrique à récupérer. Exemples courants :

  • cpu_usage_total: utilisation totale du processeur

  • memory_rss: Utilisation de la mémoire Resident Set Size

  • network_rx_bytes: octets réseau reçus

  • network_tx_bytes: octets réseau transmis

  • namespace (obligatoire) : CloudWatch espace de noms dans lequel la métrique est stockée. Valeurs communes :

  • "ContainerInsights": Pour les métriques relatives aux conteneurs

  • "AWS/EC2": Pour les métriques d'instance EC2

  • "AWS/EKS": Pour les métriques du plan de contrôle EKS

  • minutes (facultatif) : nombre de minutes nécessaires pour consulter les statistiques. Par défaut : 15. Ignoré si start_time est fourni.

  • start_time (facultatif) : heure de début au format ISO (par exemple, « T00:00:00Z 2023-01-01 »). S'il est fourni, remplace le paramètre minutes.

  • end_time (facultatif) : heure de fin au format ISO (par exemple, « T01:00:00Z 2023-01-01 »). Si elle n'est pas fournie, la valeur par défaut est l'heure actuelle.

  • limite (facultatif) : nombre maximum de points de données à renvoyer. Des valeurs plus élevées (100-1000) fournissent des données plus granulaires mais peuvent avoir un impact sur les performances. Par défaut : 50.

  • période (facultatif) : période en secondes pour les points de données métriques. Par défaut : 60 (1 minute). Des valeurs plus faibles (1 à 60) fournissent une résolution plus élevée mais peuvent être moins disponibles.

  • stat (facultatif) : statistique à utiliser pour l'agrégation des métriques. Par défaut : « Moyenne ». Valeurs valides :

  • Average: Valeur moyenne au cours de la période

  • Sum: Valeur totale au cours de la période

  • Maximum: valeur la plus élevée de la période

  • Minimum: valeur la plus faible de la période

  • SampleCount: Nombre d'échantillons au cours de la période.

get_eks_metrics_guidance

Obtenez CloudWatch des conseils sur les métriques pour des types de ressources spécifiques dans les clusters EKS. Utile pour l'agent lorsqu'il s'agit de déterminer les dimensions correctes à utiliser avec l'outil get_cloudwatch_metrics.

Paramètres :

  • resource_type (obligatoire) : type de ressource pour laquelle obtenir des métriques (cluster, nœud, pod, espace de noms, service).

get_policies_for_role

Récupère toutes les politiques associées à un rôle IAM spécifié, y compris la stratégie d'attribution du rôle, les politiques gérées et les politiques en ligne.

Paramètres :

  • role_name (obligatoire) : nom du rôle IAM pour lequel vous souhaitez obtenir les politiques. Le rôle doit exister dans votre AWS compte.

Outils d'accès complet (écriture)

Cette section décrit les outils d'accès complet (écriture) disponibles pour le serveur EKS MCP. Notez que (à compter d'aujourd'hui), toutes les opérations d'écriture de l'API Kubernetes ne peuvent accéder qu'aux éléments suivants :

  • Clusters publics (endpoint PublicAccess = true)

gérer_k8s_resource

Gère une seule ressource Kubernetes avec des opérations d'écriture (création, mise à jour, correction ou suppression).

Paramètres :

  • opération (obligatoire) : opération à effectuer sur la ressource. Valeurs valides :

  • create:Créer une nouvelle ressource

  • replace: Remplacer une ressource existante

  • patch: Mettre à jour des champs spécifiques d'une ressource existante

  • delete: Supprimer une ressource existante

  • Remarque  : utilisez read_k8s_resource pour lire les ressources et list_k8s_resources pour répertorier plusieurs ressources.

  • cluster_name (obligatoire) : nom du cluster EKS dans lequel se trouve la ressource ou sera créée.

  • type (obligatoire) : type de ressource Kubernetes (par exemple, « Pod », « Service », « Déploiement »).

  • api_version (obligatoire) : version de l'API de la ressource Kubernetes (par exemple, « v1", « networking.k8s. apps/v1 io/v1«).

  • body (facultatif) : définition de la ressource sous forme de chaîne JSON. Nécessaire pour les opérations de création, de remplacement et de correction. Pour créer et remplacer, il doit s'agir d'une définition complète de la ressource. Pour le correctif, celui-ci ne doit contenir que les champs à mettre à jour.

  • name (facultatif) : nom de la ressource Kubernetes. Obligatoire pour toutes les opérations sauf create (où cela peut être spécifié dans le corps).

  • namespace (facultatif) : espace de noms de la ressource Kubernetes. Obligatoire pour les ressources avec espace de noms. Non requis pour les ressources limitées au cluster (comme les nœuds,). PersistentVolumes

appliquer_yaml

Applique les manifestes YAML de Kubernetes à un cluster EKS.

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS dans lequel les ressources seront créées ou mises à jour.

  • namespace (obligatoire) : espace de noms Kubernetes auquel appliquer les ressources. Sera utilisé pour les ressources avec espace de noms qui ne spécifient pas d'espace de noms.

  • yaml_content (obligatoire) : contenu YAML à appliquer au cluster. Peut contenir plusieurs documents séparés par « ---».

  • force (facultatif) : s'il faut mettre à jour les ressources si elles existent déjà (similaire à kubectl apply). Définissez sur false pour créer uniquement de nouvelles ressources.

gérer_eks_stacks

Gère les CloudFormation piles EKS avec des opérations de génération de modèles, de déploiement, de description et de suppression des clusters EKS et de leur infrastructure sous-jacente. La création d'un cluster prend généralement 15 à 20 minutes. Pour les opérations de déploiement et de suppression, la pile doit avoir été créée par cet outil (c'est-à-dire étiquetée avec CreatedBy =EksMcpServer).

Paramètres :

  • cluster_name (obligatoire) : nom du cluster EKS (pour les opérations de génération, de déploiement, de description et de suppression). Ce nom sera utilisé pour dériver le nom de la CloudFormation pile et sera intégré dans les ressources du cluster.

  • opération (obligatoire) : opération à effectuer. Valeurs valides :

  • generate: Générez un CloudFormation modèle

  • deploy: Déployez une CloudFormation pile (nécessitetemplate_content)

  • describe: Describe/read une CloudFormation pile (lecture seule)

  • delete: Supprimer une CloudFormation pile

  • template_content (facultatif) : contenu du CloudFormation modèle (pour les opérations de déploiement). Il doit s'agir du contenu complet du modèle YAML ou JSON. Supporte à la fois les ressources uniques et le contenu YAML multi-documents séparés par « ---».

ajouter_inline_policy

Ajoute une nouvelle politique en ligne à un rôle IAM.

Paramètres :

  • autorisations (obligatoires) : autorisations à inclure dans la politique sous forme de chaînes JSON représentant les déclarations de stratégie IAM. Il peut s'agir d'une chaîne JSON unique ou d'un tableau de chaînes JSON.

  • policy_name (obligatoire) : nom de la politique en ligne à créer. Le rôle doit être unique.

  • role_name (obligatoire) : nom du rôle IAM auquel ajouter la politique. Le rôle doit exister.