View a markdown version of this page

Referensi Alat Server MCP Amazon EKS - Amazon EKS
Read-only alatAlat akses penuh (tulis)

Bantu meningkatkan 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 GitHub tautan Edit halaman ini di 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 sedang dalam rilis pratinjau untuk Amazon EKS dan dapat berubah.

Read-only alat

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

penelusuran_eks_dokumentasi

Cari dokumentasi EKS untuk informasi dan panduan terkini. Alat ini menyediakan akses ke dokumentasi EKS terbaru, termasuk fitur baru dan penyempurnaan terbaru yang mungkin tidak diketahui agen.

Parameter:

  • kueri (wajib): Pertanyaan spesifik Anda atau permintaan pencarian terkait dokumentasi, fitur, atau praktik terbaik EKS.

  • batas (opsional): Jumlah maksimum hasil dokumentasi untuk dikembalikan (1-10). Standar: 5.

penelusuran_eks_panduan pemecahan masalah

Menelusuri Panduan Pemecahan Masalah EKS untuk informasi pemecahan masalah berdasarkan kueri. Ini membantu mengidentifikasi masalah umum dan memberikan solusi langkah demi langkah.

Parameter:

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

deskripsi_eks_resource

Mengambil informasi terperinci tentang sumber daya cluster EKS tertentu termasuk konfigurasi, status, dan metadata.

Parameter:

  • cluster_name (wajib): Nama cluster EKS (diperlukan untuk sumber daya bercakupan 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 yang akan dijelaskan (diperlukan untuk sebagian besar jenis sumber daya).

list_eks_resources

Mencantumkan 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 yang akan 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 bercakupan cluster).

dapat_eks_wawasan

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

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 paginasi untuk mendapatkan rangkaian hasil berikutnya.

dapatkan_eks_vpc_config

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

Parameter:

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

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

get_k8s_events

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

Parameter:

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

  • jenis (wajib): Jenis objek yang terlibat (misalnya, “Pod”, “Penyebaran”, “Layanan”). 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 sumber daya dengan ruang nama (seperti Pod, Deployments). Tidak diperlukan untuk sumber daya bercakupan cluster (seperti Nodes,). PersistentVolumes

dapat_pod_log

Mengambil log dari pod di cluster EKS dengan opsi pemfilteran.

Parameter:

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

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

  • pod_name (wajib): Nama pod untuk mengambil log.

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

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

  • sebelumnya (opsional): Kembalikan log kontainer yang dihentikan sebelumnya (defaultnya 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 yang akan dikembalikan dari akhir log. Default: 100.

daftar_api_versi_

Mencantumkan semua versi API yang tersedia di cluster Kubernetes yang ditentukan.

Parameter:

  • cluster_name (wajib): Nama cluster EKS.

list_k8s_resources

Mencantumkan sumber daya Kubernetes dari jenis tertentu dalam cluster EKS.

Parameter:

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

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

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

  • field_selector (opsional): Pemilih bidang 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 sumber daya Kubernetes yang akan dicantumkan. Jika tidak disediakan, sumber daya akan dicantumkan di semua ruang nama (untuk sumber daya spasi nama).

baca_k8s_sumber daya

Mengambil informasi terperinci tentang sumber daya Kubernetes tertentu di cluster EKS.

Parameter:

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

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

  • jenis (wajib): Jenis sumber daya Kubernetes (misalnya, “Pod”, “Layanan”, “Penerapan”).

  • nama (wajib): Nama sumber daya Kubernetes untuk dibaca.

  • namespace (opsional): Namespace sumber daya Kubernetes. Diperlukan untuk sumber daya spasi nama. Tidak diperlukan untuk sumber daya bercakupan 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 penerapan dan nama layanan, dan untuk label.

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

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

  • “internal” (hanya VPC pribadi)

  • “berhadapan dengan internet” (akses publik).

  • Default: “internal”.

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

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

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

  • port (opsional): Port kontainer yang didengarkan aplikasi. Standar: 80

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

dapat_cloudwatch_log

CloudWatch Log kueri dengan pemfilteran berdasarkan parameter input dan dukungan untuk grup log standar yang digunakan untuk pengamatan cluster EKS.

Parameter:

  • cluster_name (wajib): 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 difilter.

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

  • “aplikasi”: Container/application log

  • “host”: log Node-level sistem

  • “kinerja”: Log metrik kinerja

  • “control-plane”: log pesawat kontrol EKS

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

  • resource_name (opsional): Nama sumber daya untuk mencari 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. Standar: 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- T00:00:00Z 01-01 “). Jika disediakan, ganti parameter menit.

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

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

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

  • limit (opsional): Jumlah maksimum entri log yang akan 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 met CloudWatch rik dan titik data untuk pemantauan cluster EKS dan analisis kinerja. Menangani metrik Wawasan Kontainer, metrik khusus, serta periode waktu dan dimensi yang dapat dikonfigurasi.

Parameter:

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

  • dimensi (wajib): Dimensi yang akan digunakan untuk kueri CloudWatch metrik sebagai string JSON. Harus menyertakan dimensi yang sesuai untuk jenis sumber daya dan metrik (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 Ukuran

  • 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": Untuk metrik instans EC2

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

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

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

  • end_time (opsional): Waktu akhir dalam format ISO (misalnya, “2023- T01:00:00Z 01-01 “). 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 granular tetapi dapat memengaruhi kinerja. Standar: 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 untuk digunakan untuk agregasi metrik. Default: “Rata-rata”. Nilai valid:

  • Average: Nilai rata-rata selama periode

  • Sum: Nilai total selama periode

  • Maximum: Nilai tertinggi selama periode

  • Minimum: Nilai terendah selama periode

  • SampleCount: Jumlah sampel selama periode tersebut.

get_eks_metrik_panduan

Dapatkan panduan CloudWatch metrik untuk jenis sumber daya tertentu di cluster 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).

dapatkan_politika_untuk_peran

Mengambil semua kebijakan yang dilampirkan ke peran IAM tertentu, termasuk kebijakan peran asumsi, kebijakan terkelola, dan kebijakan sebaris.

Parameter:

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

Alat akses penuh (tulis)

Bagian ini menjelaskan alat akses penuh (tulis) yang tersedia untuk EKS MCP Server. Perhatikan bahwa (per “hari ini”) semua operasi tulis Kubernetes API hanya dapat mengakses:

  • Cluster publik (titik akhir PublicAccess = benar)

manage_k8s_resource

Mengelola sumber daya Kubernetes tunggal 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: Memperbarui bidang tertentu dari sumber daya yang ada

  • delete: Menghapus sumber daya yang ada

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

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

  • jenis (wajib): Jenis sumber daya Kubernetes (misalnya, “Pod”, “Layanan”, “Penerapan”).

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

  • 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 patch, ini seharusnya hanya berisi bidang yang akan diperbarui.

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

  • namespace (opsional): Namespace sumber daya Kubernetes. Diperlukan untuk sumber daya spasi nama. Tidak diperlukan untuk sumber daya bercakupan cluster (seperti Nodes,). PersistentVolumes

aplikasi_yaml

Menerapkan manifes Kubernetes YAML ke cluster EKS.

Parameter:

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

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

  • yamlcontent/ (wajib): Konten YAML 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 templat, menyebarkan, mendeskripsikan, dan menghapus cluster EKS dan infrastruktur yang mendasarinya. Pembuatan cluster biasanya membutuhkan waktu 15-20 menit untuk menyelesaikannya. Untuk operasi penerapan dan penghapusan, 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 yang harus dilakukan. Nilai valid:

  • generate: Menghasilkan CloudFormation templat

  • deploy: Menyebarkan CloudFormation tumpukan (membutuhkantemplate_content)

  • describe: CloudFormation tum Describe/read pukan (baca-saja)

  • delete: Hapus CloudFormation tumpukan

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

tambahkan_inline_policy

Menambahkan kebijakan sebaris baru ke peran IAM.

Parameter:

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

  • policy_name (wajib): Nama kebijakan sebaris yang akan dibuat. Harus unik dalam peran.

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