Referensi Alat Server MCP Amazon EKS - Amazon EKS
Hanya baca alatsearch_eks_documentationsearch_eks_troubleshooting_guidedescribe_eks_resourcelist_eks_resourcesget_eks_insightsget_eks_vpc_configget_k8s_eventget_pod_logslist_api_versionslist_k8s_resourcesread_k8s_resourcegenerate_app_manifestget_cloudwatch_logsget_cloudwatch_metricsget_eks_metrics_guidanceget_policies_for_roleAlat akses penuh (tulis)manage_k8s_resourceterapkan_yamlmanage_eks_stacksadd_inline_policy

Bantu tingkatkan halaman ini

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Untuk berkontribusi pada panduan pengguna ini, pilih Edit halaman ini pada GitHub tautan yang terletak di panel kanan setiap halaman.

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

Referensi Alat Server MCP Amazon EKS

Server mengekspos alat MCP berikut.

catatan

Amazon EKS MCP Server dalam rilis pratinjau untuk Amazon EKS dan dapat berubah sewaktu-waktu.

Hanya baca alat

Bagian ini menjelaskan alat read-only yang tersedia untuk EKS MCP Server. Perhatikan bahwa semua operasi API Kubernetes read-only dapat mengakses keduanya:

search_eks_documentation

Cari dokumentasi EKS untuk up-to-date informasi dan panduan. Alat ini menyediakan akses ke dokumentasi EKS terbaru, termasuk fitur baru dan peningkatan terbaru yang mungkin tidak diketahui oleh agen.

Parameter:

  • kueri (wajib): Pertanyaan spesifik atau kueri penelusuran Anda yang terkait dengan dokumentasi, fitur, atau praktik terbaik EKS.

  • limit (opsional): Jumlah maksimum hasil dokumentasi yang akan dikembalikan (1-10). Default: 5.

search_eks_troubleshooting_guide

Mencari Panduan Pemecahan Masalah EKS untuk informasi pemecahan masalah berdasarkan kueri. Ini membantu mengidentifikasi masalah umum dan memberikan step-by-step solusi.

Parameter:

  • kueri (wajib): Pertanyaan spesifik atau deskripsi masalah Anda terkait dengan pemecahan masalah EKS.

describe_eks_resource

Mengambil informasi rinci tentang sumber daya kluster EKS tertentu termasuk konfigurasi, status, dan metadata.

Parameter:

  • cluster_name (wajib): Nama cluster EKS (diperlukan untuk sumber daya cakupan cluster).

  • resource_type (wajib): Jenis sumber daya EKS untuk dijelaskan. Nilai valid:

  • accessentry (membutuhkan cluster_name dan resource_name sebagai PrincipalArn)

  • addon (membutuhkan cluster_name dan resource_name sebagai nama addon)

  • cluster (membutuhkan cluster_name), nodegroup (membutuhkan cluster_name dan resource_name sebagai nama nodegroup).

  • resource_name (opsional): Nama sumber daya spesifik untuk dijelaskan (diperlukan untuk sebagian besar jenis sumber daya).

list_eks_resources

Daftar sumber daya EKS dari jenis tertentu, mengembalikan ringkasan semua sumber daya dari jenis tertentu yang dapat diakses.

Parameter:

  • resource_type (wajib): Jenis sumber daya EKS untuk dicantumkan. Nilai valid:

  • accessentry (membutuhkan cluster_name)

  • addon (membutuhkan cluster_name)

  • cluster (tidak diperlukan parameter tambahan)

  • nodegroup (membutuhkan cluster_name).

  • cluster_name (opsional): Nama cluster EKS (diperlukan untuk sumber daya cakupan cluster).

get_eks_insights

Mengambil wawasan dan rekomendasi cluster EKS untuk pengoptimalan. Memberikan wawasan yang dapat ditindaklanjuti untuk keamanan, kinerja, dan pengoptimalan biaya berdasarkan praktik AWS terbaik dan analisis klaster.

Parameter:

  • cluster_name (wajib): Nama cluster EKS.

  • kategori (opsional): Kategori opsional untuk memfilter wawasan berdasarkan (misalnya, “MISCONFIGURATION” atau “UPGRADE_READINESS”).

  • insight_id (opsional): ID opsional dari wawasan tertentu untuk mendapatkan informasi terperinci.

  • next_token (opsional): Token opsional untuk pagination untuk mendapatkan set hasil berikutnya.

get_eks_vpc_config

Mengambil konfigurasi VPC untuk kluster EKS, termasuk subnet, tabel rute, dan konektivitas jaringan.

Parameter:

  • cluster_name (required): Nama cluster EKS untuk mendapatkan konfigurasi VPC.

  • vpc_id (opsional): ID dari VPC tertentu untuk kueri (opsional, akan menggunakan VPC cluster jika tidak ditentukan).

get_k8s_event

Mengambil peristiwa Kubernetes yang terkait dengan sumber daya tertentu untuk pemecahan masalah dan pemantauan.

Parameter:

  • cluster_name (required): Nama cluster EKS tempat sumber daya berada.

  • kind (required): Jenis objek yang terlibat (misalnya, “Pod”, “Deployment”, “Service”). Harus cocok dengan jenis sumber daya dengan tepat.

  • name (required): Nama objek yang terlibat untuk mendapatkan acara.

  • namespace (opsional): Namespace dari objek yang terlibat. Diperlukan untuk resource namespaced (seperti Pod, Deployment). Tidak diperlukan untuk sumber daya dengan cakupan cluster (seperti Nodes,). PersistentVolumes

get_pod_logs

Mengambil log dari pod di cluster EKS dengan opsi pemfilteran.

Parameter:

  • cluster_name (required): Nama cluster EKS tempat pod berjalan.

  • namespace (required): Namespace Kubernetes tempat pod berada.

  • pod_name (required): Nama pod untuk mengambil log dari.

  • container_name (opsional): Nama wadah khusus untuk mendapatkan log dari. Diperlukan hanya jika pod berisi beberapa kontainer.

  • limit_bytes (opsional): Jumlah maksimum byte untuk dikembalikan. Default: 10KB (10240 byte).

  • sebelumnya (opsional): Kembalikan log kontainer yang dihentikan sebelumnya (default ke false). Berguna untuk mendapatkan log untuk pod yang memulai ulang.

  • since_seconds (opsional): Hanya mengembalikan log yang lebih baru dari beberapa detik ini. Berguna untuk mendapatkan log terbaru tanpa mengambil seluruh riwayat.

  • tail_lines (opsional): Jumlah baris untuk kembali dari akhir log. Default: 100.

list_api_versions

Daftar semua versi API yang tersedia di klaster Kubernetes yang ditentukan.

Parameter:

  • cluster_name (wajib): Nama cluster EKS.

list_k8s_resources

Daftar sumber daya Kubernetes dari jenis tertentu dalam klaster EKS.

Parameter:

  • cluster_name (wajib): Nama cluster EKS tempat sumber daya berada.

  • kind (required): Jenis resource Kubernetes yang akan dicantumkan (misalnya, 'Pod', 'Service', 'Deployment'). Gunakan list_api_versions alat ini untuk menemukan jenis sumber daya yang tersedia.

  • api_version (wajib): Versi API dari sumber daya Kubernetes (misalnya, 'v1', '1'). apps/v1', 'networking.k8s.io/v Gunakan list_api_versions alat ini untuk menemukan versi API yang tersedia.

  • field_selector (opsional): Pemilih lapangan untuk memfilter sumber daya (misalnya, 'metadata.name=my-pod, status.phase=running'). Menggunakan sintaks yang sama dengan flag --field-selector kubectl.

  • label_selector (opsional): Pemilih label untuk memfilter sumber daya (misalnya, 'app=nginx, tier=frontend'). Menggunakan sintaks yang sama dengan flag kubectl. --selector

  • namespace (opsional): Namespace dari resource Kubernetes yang akan dicantumkan. Jika tidak disediakan, sumber daya akan dicantumkan di semua ruang nama (untuk sumber daya namespaced).

read_k8s_resource

Mengambil informasi rinci tentang sumber daya Kubernetes tertentu di klaster EKS.

Parameter:

  • api_version (wajib): Versi API dari sumber daya Kubernetes (misalnya, “v1"," 1"). apps/v1", "networking.k8s.io/v

  • cluster_name (required): Nama cluster EKS tempat sumber daya berada.

  • kind (required): Jenis sumber daya Kubernetes (misalnya, “Pod”, “Service”, “Deployment”).

  • name (required): Nama resource Kubernetes untuk dibaca.

  • namespace (opsional): Namespace dari sumber daya Kubernetes. Diperlukan untuk sumber daya namespaced. Tidak diperlukan untuk sumber daya dengan cakupan cluster (seperti Nodes,). PersistentVolumes

generate_app_manifest

Menghasilkan penerapan Kubernetes standar dan manifes layanan untuk aplikasi kontainer.

Parameter:

  • app_name (wajib): Nama aplikasi. Digunakan untuk penyebaran dan nama layanan, dan untuk label.

  • image_uri (wajib): URI gambar ECR lengkap dengan tag (misalnya, 123456789012.dkr.ecr.region.amazonaws.com/repo:tag). Harus menyertakan jalur dan tag repositori lengkap.

  • load_balancer_scheme (opsional): skema penyeimbang beban. AWS Nilai valid:

  • “internal” (hanya VPC pribadi)

  • “Menghadap internet” (akses publik).

  • Default: “internal”.

  • cpu (opsional): Permintaan CPU untuk setiap kontainer (misalnya, “100m” untuk 0,1 inti CPU, “500m” untuk setengah inti). Default: “100m”.

  • memori (opsional): Permintaan memori untuk setiap wadah (misalnya, “128Mi” untuk 128 MiB, “1Gi” untuk 1 GiB). Default: “128Mi”

  • namespace (opsional): Namespace Kubernetes untuk menyebarkan aplikasi ke. Default: “default”.

  • port (opsional): Port kontainer tempat aplikasi mendengarkan. Default: 80

  • replika (opsional): Jumlah replika yang akan digunakan. Default: 2

get_cloudwatch_logs

Kueri CloudWatch log dengan pemfilteran berdasarkan parameter input dan dukungan untuk grup log standar yang digunakan untuk observabilitas kluster EKS.

Parameter:

  • cluster_name (required): Nama cluster EKS tempat sumber daya berada. Digunakan untuk membangun nama grup CloudWatch log.

  • resource_type (wajib): Jenis sumber daya untuk mencari log. Nilai yang valid: +"pod”, “node”, “container”, “cluster”. Ini menentukan bagaimana log disaring.

  • log_type (wajib): Jenis log ke kueri. Nilai valid:

  • “aplikasi”: Container/application log

  • “host”: Log sistem tingkat node

  • “kinerja”: Log metrik kinerja

  • “control-plane”: Log bidang kontrol EKS

  • “your-log-group-name“: Berikan nama grup CloudWatch log kustom secara langsung.

  • resource_name (opsional): Nama sumber daya untuk dicari dalam pesan log (misalnya, nama pod, nama node, nama wadah). Digunakan untuk memfilter log untuk sumber daya tertentu.

  • menit (opsional): Jumlah menit untuk melihat kembali log. Default: 15. Diabaikan jika start_time disediakan. Gunakan nilai yang lebih kecil untuk masalah terbaru, nilai yang lebih besar untuk analisis historis.

  • start_time (opsional): Waktu mulai dalam format ISO (misalnya, “2023-01-01T 00:00:00 Z”). Jika disediakan, ganti parameter menit.

  • end_time (opsional): Waktu akhir dalam format ISO (misalnya, “2023-01-01T 01:00:00 Z”). Jika tidak disediakan, default ke waktu saat ini.

  • bidang (opsional): Bidang khusus untuk disertakan dalam hasil kueri (default ke "@timestamp, @message “). Gunakan sintaks bidang Wawasan CloudWatch Log.

  • filter_pattern (opsional): Pola filter CloudWatch Log tambahan untuk diterapkan. Menggunakan sintaks Wawasan CloudWatch Log (misalnya, “ERROR”, “field=value”).

  • limit (opsional): Jumlah maksimum entri log untuk dikembalikan. Gunakan nilai yang lebih rendah (10-50) untuk kueri yang lebih cepat, nilai yang lebih tinggi (100-1000) untuk hasil yang lebih komprehensif. Nilai yang lebih tinggi dapat memengaruhi kinerja.

get_cloudwatch_metrics

Mengambil CloudWatch metrik dan titik data untuk pemantauan klaster EKS dan analisis kinerja. Menangani metrik Container Insights, metrik kustom, serta periode waktu dan dimensi yang dapat dikonfigurasi.

Parameter:

  • cluster_name (wajib): Nama cluster EKS untuk mendapatkan metrik.

  • dimensi (wajib): Dimensi yang akan digunakan untuk kueri CloudWatch metrik sebagai string JSON. Harus menyertakan dimensi yang sesuai untuk jenis dan metrik sumber daya (misalnya, '{” ClusterName “: “my-cluster”, "PodName“: “my-pod”, “Namespace”: “default"}').

  • metric_name (wajib): Nama metrik untuk diambil. Contoh umum:

  • cpu_usage_total: Total penggunaan CPU

  • memory_rss: Penggunaan memori Resident Set Size

  • network_rx_bytes: Byte jaringan diterima

  • network_tx_bytes: Byte jaringan ditransmisikan

  • namespace (wajib): CloudWatch namespace tempat metrik disimpan. Nilai umum:

  • "ContainerInsights": Untuk metrik kontainer

  • "AWS/EC2": EC2 Misalnya metrik

  • "AWS/EKS": Untuk metrik bidang kontrol EKS

  • menit (opsional): Jumlah menit untuk melihat kembali metrik. Default: 15. Diabaikan jika start_time disediakan.

  • start_time (opsional): Waktu mulai dalam format ISO (misalnya, “2023-01-01T 00:00:00 Z”). Jika disediakan, ganti parameter menit.

  • end_time (opsional): Waktu akhir dalam format ISO (misalnya, “2023-01-01T 01:00:00 Z”). Jika tidak disediakan, default ke waktu saat ini.

  • limit (opsional): Jumlah maksimum titik data yang akan dikembalikan. Nilai yang lebih tinggi (100-1000) memberikan data yang lebih terperinci tetapi dapat memengaruhi kinerja. Default: 50.

  • periode (opsional): Periode dalam detik untuk titik data metrik. Default: 60 (1 menit). Nilai yang lebih rendah (1-60) memberikan resolusi yang lebih tinggi tetapi mungkin kurang tersedia.

  • stat (opsional): Statistik yang digunakan untuk agregasi metrik. Default: “Rata-rata”. Nilai valid:

  • Average: Nilai rata-rata selama periode tersebut

  • Sum:Nilai total selama periode tersebut

  • Maximum: Nilai tertinggi selama periode tersebut

  • Minimum: Nilai terendah selama periode tersebut

  • SampleCount: Jumlah sampel selama periode tersebut.

get_eks_metrics_guidance

Dapatkan panduan CloudWatch metrik untuk jenis sumber daya tertentu di kluster EKS. Berguna untuk agen saat menentukan dimensi yang benar untuk digunakan dengan alat get_cloudwatch_metrics.

Parameter:

  • resource_type (wajib): Jenis sumber daya untuk mendapatkan metrik (cluster, node, pod, namespace, service).

get_policies_for_role

Mengambil semua kebijakan yang dilampirkan pada peran IAM tertentu, termasuk kebijakan peran asumsi, kebijakan terkelola, dan kebijakan inline.

Parameter:

  • role_name (required): Nama peran IAM untuk mendapatkan kebijakan. Peran harus ada di AWS akun Anda.

Alat akses penuh (tulis)

Bagian ini menjelaskan alat read-only yang tersedia untuk EKS MCP Server. Perhatikan bahwa (mulai “hari ini”) semua operasi API Kubernetes tulis hanya dapat mengakses:

  • Cluster publik (endpointPublicAccess= true)

manage_k8s_resource

Mengelola satu sumber daya Kubernetes dengan operasi tulis (membuat, memperbarui, menambal, atau menghapus).

Parameter:

  • operasi (wajib): Operasi untuk melakukan pada sumber daya. Nilai valid:

  • create:Buat sumber daya baru

  • replace: Ganti sumber daya yang ada

  • patch: Perbarui bidang tertentu dari sumber daya yang ada

  • delete: Hapus sumber daya yang ada

  • Catatan: Gunakan read_k8s_resource untuk membaca sumber daya dan list_k8s_resources untuk daftar beberapa sumber daya.

  • cluster_name (required): Nama cluster EKS tempat sumber daya berada atau akan dibuat.

  • kind (required): Jenis sumber daya Kubernetes (misalnya, “Pod”, “Service”, “Deployment”).

  • api_version (wajib): Versi API dari sumber daya Kubernetes (misalnya, “v1"," 1"). apps/v1", "networking.k8s.io/v

  • body (opsional): Definisi sumber daya sebagai string JSON. Diperlukan untuk membuat, mengganti, dan menambal operasi. Untuk membuat dan mengganti, ini harus menjadi definisi sumber daya yang lengkap. Untuk tambalan, ini harus berisi hanya bidang yang akan diperbarui.

  • name (opsional): Nama sumber daya Kubernetes. Diperlukan untuk semua operasi kecuali buat (di mana dapat ditentukan dalam tubuh).

  • namespace (opsional): Namespace dari sumber daya Kubernetes. Diperlukan untuk sumber daya namespaced. Tidak diperlukan untuk sumber daya dengan cakupan cluster (seperti Nodes,). PersistentVolumes

terapkan_yaml

Menerapkan manifes YAMAL Kubernetes ke cluster EKS.

Parameter:

  • cluster_name (required): Nama cluster EKS tempat sumber daya akan dibuat atau diperbarui.

  • namespace (required): Namespace Kubernetes untuk menerapkan resource ke. Akan digunakan untuk sumber daya spasi nama yang tidak menentukan namespace.

  • yaml_content (wajib): Konten YAMAL untuk diterapkan ke cluster. Dapat berisi beberapa dokumen yang dipisahkan oleh '---'.

  • force (opsional): Apakah akan memperbarui sumber daya jika sudah ada (mirip dengan kubectl apply). Setel ke false untuk hanya membuat sumber daya baru.

manage_eks_stacks

Mengelola CloudFormation tumpukan EKS dengan operasi untuk menghasilkan template, menyebarkan, mendeskripsikan, dan menghapus kluster EKS dan infrastruktur dasarnya. Pembuatan cluster biasanya membutuhkan waktu 15-20 menit untuk menyelesaikannya. Untuk operasi deploy dan delete, tumpukan harus dibuat oleh alat ini (yaitu, ditandai dengan CreatedBy =EksMcpServer).

Parameter:

  • cluster_name (wajib): Nama cluster EKS (untuk menghasilkan, menyebarkan, mendeskripsikan, dan menghapus operasi). Nama ini akan digunakan untuk mendapatkan nama CloudFormation tumpukan dan akan disematkan dalam sumber daya cluster.

  • operasi (wajib): Operasi untuk melakukan. Nilai valid:

  • generate: Menghasilkan CloudFormation template

  • deploy: Menyebarkan CloudFormation tumpukan (membutuhkantemplate_content)

  • describe: Describe/read CloudFormation tumpukan (hanya-baca)

  • delete: Hapus CloudFormation tumpukan

  • template_content (opsional): konten CloudFormation template (untuk operasi penerapan). Ini harus berupa konten template YAMAL atau JSON yang lengkap. Mendukung sumber daya tunggal dan konten YAMAL multi-dokumen yang dipisahkan oleh '---'.

add_inline_policy

Menambahkan kebijakan inline baru ke peran IAM.

Parameter:

  • izin (wajib): Izin untuk disertakan dalam kebijakan sebagai string JSON yang mewakili pernyataan kebijakan IAM. Bisa berupa string JSON tunggal atau array string JSON.

  • policy_name (required): Nama kebijakan inline yang akan dibuat. Harus unik dalam peran.

  • role_name (required): Nama peran IAM untuk menambahkan kebijakan. Peran itu harus ada.