

 **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.

# Bekerja dengan sumber daya kemampuan
<a name="working-with-capabilities"></a>

Topik ini menjelaskan operasi umum untuk mengelola sumber daya kemampuan di semua jenis kemampuan.

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

Kemampuan EKS adalah AWS sumber daya yang memungkinkan fungsionalitas terkelola di kluster 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 kluster EKS tertentu, dan tetap berafiliasi dengan cluster tersebut untuk seluruh siklus hidupnya.

Setiap sumber daya kemampuan memiliki:
+ Nama unik di dalam klaster Anda
+ Jenis kemampuan (ACK, ARGOCD, atau KRO)
+ Nama Sumber Daya Amazon (ARN), yang menentukan nama dan jenis
+ Peran kemampuan IAM
+ Status yang menunjukkan keadaannya saat ini
+ Konfigurasi, baik generik maupun spesifik 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/ rumah\$1/cluster.

1. Pilih nama cluster Anda.

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

1. Untuk informasi kesehatan yang mendetail, pilih tab **Observability**, lalu **Monitor cluster**, lalu tab **Capabilities**.

 ** 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 diatur. Anda dapat menavigasi jauh dari konsol—kemampuan akan terus dibuat 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 [Memecahkan Masalah Kemampuan EKS](capabilities-troubleshooting.md) untuk panduan.

 **MEMPERBARUI**: Perubahan konfigurasi sedang diterapkan. Tunggu statusnya kembali`ACTIVE`.

 **MENGHAPUS**: Kemampuan sedang dihapus dari cluster.

 **CREATE\$1FAILED**: Pengaturan mengalami kesalahan. Penyebab umum meliputi:
+ Kebijakan kepercayaan peran IAM salah atau tidak ada
+ Peran IAM tidak ada atau tidak dapat diakses
+ Masalah akses klaster
+ Parameter konfigurasi tidak valid

Periksa bagian kesehatan kemampuan untuk detail kesalahan tertentu.

 **UPDATE\$1FAILED: Pembaruan konfigurasi gagal**. Periksa bagian kesehatan kemampuan untuk detail dan verifikasi izin IAM.

**Tip**  
Untuk panduan pemecahan masalah terperinci, lihat:  
 [Memecahkan Masalah Kemampuan EKS](capabilities-troubleshooting.md)- Pemecahan masalah kemampuan umum
 [Memecahkan masalah dengan kemampuan ACK](ack-troubleshooting.md)- Masalah khusus ACK
 [Memecahkan masalah dengan kemampuan Argo CD](argocd-troubleshooting.md)- Masalah khusus Argo CD
 [Memecahkan masalah dengan kemampuan kro](kro-troubleshooting.md)- masalah khusus kro

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

Untuk membuat kapabilitas di klaster Anda, lihat topik berikut:
+  [Buat kemampuan ACK](create-ack-capability.md)— Buat kemampuan ACK untuk mengelola AWS sumber daya menggunakan Kubernetes APIs
+  [Membuat kemampuan Argo CD](create-argocd-capability.md)— Buat kemampuan Argo CD 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 membuat daftar semua sumber daya kemampuan pada sebuah cluster.

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

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

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

1. Pilih tab **Kemampuan**.

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 di cluster Anda. Ganti *region-code* dengan AWS Region 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 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/ rumah\$1/cluster.

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

1. Pilih tab **Kemampuan**.

1. Pilih kemampuan yang ingin Anda lihat dari **kemampuan Terkelola**.

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 rinci. Ganti *region-code* dengan AWS Region tempat cluster Anda berada, ganti *my-cluster* dengan nama cluster Anda, dan ganti *capability-name* dengan nama kemampuan (ack, argocd, atau 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"
  }
}
```

## Perbarui konfigurasi kemampuan
<a name="_update_the_configuration_of_a_capability"></a>

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

**catatan**  
Sumber daya kemampuan EKS dikelola sepenuhnya, termasuk penambalan 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::[.replaceable]111122223333:role/NewCapabilityRole
```

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

## Hapus kemampuan
<a name="_delete_a_capability"></a>

Ketika Anda tidak lagi membutuhkan kemampuan di 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 Kubernetes Custom Resource Definitions (CRDs) tetap terpasang di klaster Anda.
Sumber daya ACK tetap ada di klaster Anda, dan AWS sumber daya terkait tetap ada di akun Anda
Aplikasi Argo CD dan sumber daya Kubernetes mereka tetap ada di klaster Anda
kro ResourceGraphDefinitions dan instance tetap ada di cluster Anda
Anda harus menghapus sumber daya ini sebelum menghapus kemampuan untuk menghindari sumber daya yatim piatu.  
Anda dapat 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/ rumah\$1/cluster.

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

1. Pilih tab **Kemampuan**.

1. Pilih kemampuan yang ingin Anda hapus dari daftar **Kemampuan terkelola**.

1. Pilih **Hapus kemampuan**.

1. Dalam dialog konfirmasi, ketikkan nama kemampuan untuk mengonfirmasi 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 Region tempat klaster 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 kapabilitas
+  [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