Bekerja dengan sumber daya kemampuan - Amazon EKS

View a markdown version of this page

Bekerja dengan sumber daya kemampuan - Amazon EKS

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.

Bekerja dengan sumber daya kemampuan

Buat daftar, jelaskan, perbarui, dan hapus sumber daya kemampuan di cluster Amazon EKS Anda.

Sumber daya kemampuan EKS

Kemampuan EKS adalah AWS sumber daya yang mengaktifkan fungsionalitas terkelola di cluster Amazon EKS Anda. Kemampuan berjalan di EKS, menghilangkan kebutuhan untuk menginstal dan memelihara pengontrol dan komponen operasional lainnya pada node pekerja Anda. Kemampuan dibuat untuk cluster EKS tertentu, dan tetap berafiliasi dengan cluster tersebut selama seluruh siklus hidupnya.

Setiap sumber daya kemampuan memiliki:

  • Nama unik dalam cluster Anda

  • Jenis kemampuan (ACK, ARGOCD, atau KRO)

  • Nama Sumber Daya Amazon (ARN), menentukan nama dan jenis

  • Peran kemampuan IAM

  • Status yang menunjukkan keadaannya saat ini

  • Konfigurasi, baik generik maupun khusus untuk jenis kemampuan

Memahami status kemampuan

Sumber daya kemampuan memiliki status yang menunjukkan keadaan mereka saat ini. Anda dapat melihat status kemampuan dan kesehatan di konsol EKS atau menggunakan AWS CLI.

Konsol:

  1. Buka konsol Amazon EKS di https://console.aws.amazon.com/eks/home #/cluster.

  2. Pilih nama cluster Anda.

  3. Pilih tab Capabilities untuk melihat status semua kemampuan.

  4. Untuk informasi kesehatan terperinci, pilih tab Observability, lalu Monitor cluster, lalu tab Cap abilities.

AWS CLI:

aws eks describe-capability \ --region region-code \ --cluster-name my-cluster \ --capability-name my-capability-name

Status kemampuan

MENCIPTAKAN: Kemampuan sedang disiapkan. Anda dapat menavigasi jauh dari konsol — kemampuan akan terus membuat di latar belakang.

AKTIF: Kemampuan berjalan dan siap digunakan. Jika sumber daya tidak berfungsi seperti yang diharapkan, periksa status sumber daya dan izin IAM. Lihat Pemecahan Masalah Kemampuan EKS untuk panduan.

MEMPER BARUI: Perubahan konfigurasi sedang diterapkan. Tunggu status kembali keACTIVE.

MENGHAPUS: Kemampuan sedang dihapus dari cluster.

CREATE_FAILED: Pengaturan mengalami kesalahan. Penyebab umum meliputi:

  • Kebijakan kepercayaan peran IAM salah atau hilang

  • Peran IAM tidak ada atau tidak dapat diakses

  • Masalah akses cluster

  • Parameter konfigurasi tidak valid

Periksa bagian kesehatan kemampuan untuk detail kesalahan tertentu.

UPDATE_FAILED: Pembaruan konfigurasi gagal. Periksa bagian kesehatan kemampuan untuk detail dan verifikasi izin IAM.

Tip

Untuk panduan pemecahan masalah terperinci, lihat:

Buat kemampuan

Untuk membuat kemampuan pada cluster Anda, lihat topik berikut:

Daftar kemampuan

Anda dapat mencantumkan semua sumber daya kemampuan pada cluster.

Konsol

  1. Buka konsol Amazon EKS di https://console.aws.amazon.com/eks/home #/cluster.

  2. Pilih nama cluster Anda untuk membuka halaman detail cluster.

  3. Pilih tab Capabilities.

  4. Lihat sumber daya kemampuan di bawah Kemampuan terkelola.

AWS CLI

Gunakan list-capabilities perintah untuk melihat semua kemampuan pada cluster Anda. Ganti region-code dengan AWS Wilayah tempat cluster Anda berada dan ganti my-cluster dengan nama cluster Anda.

aws eks list-capabilities \ --region region-code \ --cluster-name my-cluster
{ "capabilities": [ { "capabilityName": "my-ack", "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/ack/my-ack/abc123", "type": "ACK", "status": "ACTIVE", "createdAt": "2025-11-02T10:30:00.000000-07:00", "modifiedAt": "2025-11-02T10:32:15.000000-07:00" }, { "capabilityName": "my-kro", "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/kro/my-kro/abc123", "type": "KRO", "status": "ACTIVE", "version": "v0.6.3", "createdAt": "2025-11-02T10:30:00.000000-07:00", "modifiedAt": "2025-11-02T10:32:15.000000-07:00" }, { "capabilityName": "my-argocd", "arn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/argocd/my-argocd/abc123", "type": "ARGOCD", "status": "ACTIVE", "version": "3.1.8-eks-1", "createdAt": "2025-11-21T08:22:28.486000-05:00", "modifiedAt": "2025-11-21T08:22:28.486000-05:00" } ] }

Jelaskan suatu kemampuan

Dapatkan informasi terperinci tentang kemampuan tertentu, termasuk konfigurasi dan statusnya.

Konsol

  1. Buka konsol Amazon EKS di https://console.aws.amazon.com/eks/home #/cluster.

  2. Pilih nama cluster Anda untuk membuka halaman detail cluster.

  3. Pilih tab Capabilities.

  4. Pilih kemampuan yang ingin Anda lihat dari kemampuan ter kelola.

  5. Lihat detail kemampuan, termasuk status, konfigurasi, dan waktu pembuatan.

AWS CLI

Gunakan describe-capability perintah untuk melihat informasi terperinci. Ganti region-code dengan AWS Wilayah tempat cluster Anda berada, ganti my-cluster dengan nama cluster Anda, dan ganti capability-name dengan nama yang Anda berikan kemampuan Anda saat Anda membuatnya (misalnya,my-ack,my-argocd, ataumy-kro).

aws eks describe-capability \ --region region-code \ --cluster-name my-cluster \ --capability-name capability-name

Contoh keluaran:

{ "capability": { "capabilityName": "my-ack", "capabilityArn": "arn:aws:eks:us-west-2:111122223333:capability/my-cluster/ack/my-ack/abc123", "clusterName": "my-cluster", "type": "ACK", "roleArn": "arn:aws:iam::111122223333:role/AmazonEKSCapabilityACKRole", "status": "ACTIVE", "configuration": {}, "tags": {}, "health": { "issues": [] }, "createdAt": "2025-11-19T17:11:30.242000-05:00", "modifiedAt": "2025-11-19T17:11:30.242000-05:00", "deletePropagationPolicy": "RETAIN" } }

Memperbarui konfigurasi kemampuan

Anda dapat memperbarui aspek tertentu dari konfigurasi kemampuan setelah pembuatan. Opsi konfigurasi spesifik bervariasi menurut jenis kemampuan.

catatan

Sumber daya kemampuan EKS sepenuhnya dikelola, termasuk tambalan dan pembaruan versi. Memperbarui kemampuan akan memperbarui konfigurasi sumber daya dan tidak akan menghasilkan pembaruan versi komponen kemampuan terkelola.

AWS CLI

Gunakan update-capability perintah untuk memodifikasi kemampuan:

aws eks update-capability \ --region region-code \ --cluster-name my-cluster \ --capability-name capability-name \ --role-arn arn:aws:iam::111122223333:role/NewCapabilityRole
catatan

Tidak semua properti kemampuan dapat diperbarui setelah pembuatan. Lihat dokumentasi khusus kemampuan untuk detail tentang apa yang dapat dimodifikasi.

Menghapus kemampuan

Bila Anda tidak lagi memerlukan kemampuan pada cluster Anda, Anda dapat menghapus sumber daya kemampuan.

penting

Hapus sumber daya cluster sebelum menghapus kemampuan.

Menghapus sumber daya kemampuan tidak secara otomatis menghapus sumber daya yang dibuat melalui kemampuan itu:

  • Semua Definisi Sumber Daya Kustom Kubernetes (CRD) tetap diinstal di cluster Anda.

  • Sumber daya ACK tetap berada di cluster Anda, dan AWS sumber daya yang sesuai tetap ada di akun Anda

  • Aplikasi CD Argo dan sumber daya Kubernetes mereka tetap berada di cluster Anda

  • kro ResourceGraphDefinitions dan instance tetap berada di cluster Anda

Anda harus menghapus sumber daya ini sebelum menghapus kemampuan untuk menghindari sumber daya yatim piatu.

Anda dapat secara opsional memilih untuk mempertahankan AWS sumber daya yang terkait dengan sumber daya ACK Kubernetes. Lihat pertimbangan ACK

Konsol

  1. Buka konsol Amazon EKS di https://console.aws.amazon.com/eks/home #/cluster.

  2. Pilih nama cluster Anda untuk membuka halaman detail cluster.

  3. Pilih tab Capabilities.

  4. Pilih kemampuan yang ingin Anda hapus dari daftar kemampuan ter kelola.

  5. Pilih kemampuan Hapus.

  6. Dalam dialog konfirmasi, ketik nama kemampuan untuk mengkonfirmasi penghapusan.

  7. Pilih Hapus.

AWS CLI

Gunakan delete-capability perintah untuk menghapus sumber daya kemampuan:

Ganti region-code dengan AWS Wilayah tempat cluster Anda berada, ganti my-cluster dengan nama cluster Anda, dan ganti capability-name dengan nama kemampuan untuk dihapus.

aws eks delete-capability \ --region region-code \ --cluster-name my-cluster \ --capability-name capability-name

Langkah selanjutnya