

 **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
<a name="working-with-capabilities"></a>

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

## Sumber daya kemampuan EKS
<a name="_eks_capability_resources"></a>

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
<a name="_understanding_capability_status"></a>

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.

1. Pilih nama cluster Anda.

1. Pilih ** tab ** Capabilities untuk melihat status semua kemampuan.

1. 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
<a name="_capability_statuses"></a>

 **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](capabilities-troubleshooting.md) untuk panduan.

 **MEMPER ** BARUI: Perubahan konfigurasi sedang diterapkan. Tunggu status kembali ke`ACTIVE`.

 **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:  
 [Pemecahan Masalah Kemampuan EKS](capabilities-troubleshooting.md)- Pemecahan masalah kemampuan umum
 [Memecahkan masalah dengan kemampuan ACK](ack-troubleshooting.md)- ACK-specific masalah
 [Memecahkan masalah dengan kemampuan CD Argo](argocd-troubleshooting.md)- Masalah Argo CD-specific 
 [Memecahkan masalah dengan kemampuan kro](kro-troubleshooting.md)- masalah khusus kro-

## Buat kemampuan
<a name="_create_capabilities"></a>

Untuk membuat kemampuan pada cluster Anda, lihat topik berikut:
+  [Buat kemampuan ACK](create-ack-capability.md)— Buat kemampuan ACK untuk mengelola AWS sumber daya menggunakan API Kubernetes
+  [Membuat kemampuan Argo CD](create-argocd-capability.md)— Buat kemampuan CD Argo untuk pengiriman GitOps berkelanjutan
+  [Buat kemampuan kro](create-kro-capability.md)— Buat kemampuan kro untuk komposisi sumber daya dan orkestrasi

## Daftar kemampuan
<a name="_list_capabilities"></a>

Anda dapat mencantumkan semua sumber daya kemampuan pada cluster.

### Konsol
<a name="_console"></a>

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

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

1. Pilih ** tab ** Capabilities.

1. Lihat sumber daya kemampuan di bawah Kemampuan ** terkelola**.

### AWS CLI
<a name="shared_aws_cli"></a>

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
<a name="_describe_a_capability"></a>

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

### Konsol
<a name="_console_2"></a>

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

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

1. Pilih ** tab ** Capabilities.

1. Pilih kemampuan yang ingin Anda lihat dari kemampuan ter ** kelola**.

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

### AWS CLI
<a name="shared_aws_cli"></a>

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`, atau`my-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
<a name="_update_the_configuration_of_a_capability"></a>

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
<a name="shared_aws_cli"></a>

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
<a name="capabilities-delete"></a>

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 ](ack-considerations.md) 

### Konsol
<a name="_console_3"></a>

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

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

1. Pilih ** tab ** Capabilities.

1. Pilih kemampuan yang ingin Anda hapus dari daftar kemampuan ter ** kelola**.

1. Pilih kemampuan ** Hapus**.

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

1. Pilih **Hapus**.

### AWS CLI
<a name="shared_aws_cli"></a>

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
<a name="_next_steps"></a>
+  [Kemampuan sumber daya Kubernetes](capability-kubernetes-resources.md)— Pelajari tentang sumber daya Kubernetes yang disediakan oleh setiap jenis kemampuan
+  [Konsep ACK](ack-concepts.md)— Memahami konsep ACK dan siklus hidup sumber daya
+  [Bekerja dengan Argo CD](working-with-argocd.md)- Bekerja dengan kemampuan Argo CD untuk GitOps alur kerja
+  [konsep kro](kro-concepts.md)— Memahami konsep kro dan komposisi sumber daya