**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.
# Connect cluster Kubernetes eksternal ke Amazon EKS Management Console
Anda dapat menghubungkan cluster Kubernetes eksternal ke Amazon EKS dengan menggunakan beberapa metode dalam proses berikut. Proses ini melibatkan dua langkah: Mendaftarkan cluster dengan Amazon EKS dan menginstal `eks-connector` agen di cluster.
**penting**
Anda harus menyelesaikan langkah kedua dalam waktu 3 hari setelah menyelesaikan langkah pertama, sebelum pendaftaran berakhir.
## Pertimbangan
Anda dapat menggunakan manifes YAMAL saat menginstal agen. Atau, Anda dapat menggunakan Helm jika Anda mendaftarkan cluster dengan Konsol Manajemen AWS atau Antarmuka Baris AWS Perintah. Namun, Anda tidak dapat menggunakan Helm untuk menginstal agen jika Anda mendaftarkan cluster. `eksctl`
## Prasyarat
+ Pastikan peran agen Amazon EKS Connector telah dibuat. Ikuti langkah-langkah dalam [Membuat peran agen konektor Amazon EKS](connector-iam-role.md#create-connector-role).
+ Anda harus memiliki izin berikut untuk mendaftarkan klaster:
+ `eks:RegisterCluster`
+ `ssm:CreateActivation`
+ `ssm:DeleteActivation`
+ `iam:PassRole`
## Langkah 1: Mendaftarkan cluster
Untuk mendaftarkan cluster ke konektor Amazon EKS, Anda dapat menggunakan salah satu alat berikut:
+ [AWS CLI](#awscli_register_cluster_connect)
+ [Konsol Manajemen AWS](#console_register_cluster_connect)
+ [`eksctl`](#eksctl_register_cluster_connect)
### AWS CLI
1. AWS CLI harus diinstal. Untuk menginstal atau memutakhirkannya, lihat [Menginstal AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-install.html).
1. Untuk konfigurasi Konektor, tentukan peran IAM agen Amazon EKS Connector Anda. Untuk informasi selengkapnya, lihat [Peran IAM yang diperlukan untuk Konektor Amazon EKS](eks-connector.md#connector-iam-permissions).
```
aws eks register-cluster \
--name my-first-registered-cluster \
--connector-config roleArn=arn:aws: iam::111122223333:role/AmazonEKSConnectorAgentRole,provider="OTHER" \
--region aws-region
```
Contoh output adalah sebagai berikut.
```
{
"cluster": {
"name": "my-first-registered-cluster",
"arn": "arn:aws: eks:region:111122223333:cluster/my-first-registered-cluster",
"createdAt": 1627669203.531,
"ConnectorConfig": {
"activationId": "xxxxxxxxACTIVATION_IDxxxxxxxx",
"activationCode": "xxxxxxxxACTIVATION_CODExxxxxxxx",
"activationExpiry": 1627672543.0,
"provider": "OTHER",
"roleArn": "arn:aws: iam::111122223333:role/AmazonEKSConnectorAgentRole"
},
"status": "CREATING"
}
}
```
Anda menggunakan`aws-region`,`activationId`, dan `activationCode` nilai di langkah berikutnya.
### Konsol Manajemen AWS
1. Buka [konsol Amazon EKS](https://console.aws.amazon.com/eks/home#/clusters).
1. Pilih **Add cluster** dan pilih **Register** untuk membuka halaman konfigurasi.
1. Pada bagian **Configure cluster**, isi kolom berikut:
+ **Nama** — Nama unik untuk klaster Anda.
+ **Provider** — Pilih untuk menampilkan daftar dropdown dari penyedia klaster Kubernetes. Jika Anda tidak tahu penyedia tertentu, pilih **Lainnya**.
+ **Peran Konektor EKS** - Pilih peran yang akan digunakan untuk menghubungkan cluster.
1. Pilih **Daftar cluster**.
1. Halaman ikhtisar Cluster ditampilkan. Jika Anda ingin menggunakan bagan Helm, salin `helm install` perintah dan lanjutkan ke langkah berikutnya. Jika Anda ingin menggunakan manifes YAMM, pilih **Unduh file YAMM untuk mengunduh file** manifes ke drive lokal Anda.
**penting**
Ini adalah satu-satunya kesempatan Anda untuk menyalin `helm install` perintah atau mengunduh file ini. Jangan menavigasi jauh dari halaman ini, karena tautan tidak akan dapat diakses dan Anda harus membatalkan pendaftaran cluster dan memulai langkah-langkahnya dari awal.
Perintah atau file manifes hanya dapat digunakan sekali untuk cluster terdaftar. Jika Anda menghapus sumber daya dari klaster Kubernetes, Anda harus mendaftarkan ulang klaster dan mendapatkan file manifes baru.
Lanjutkan ke langkah berikutnya untuk menerapkan file manifes ke cluster Kubernetes Anda.
### `eksctl`
1. `eksctl`versi `0.68` atau yang lebih baru harus diinstal. Untuk menginstal atau memutakhirkannya, lihat[Memulai dengan Amazon EKS - `eksctl`](getting-started-eksctl.md).
1. Daftarkan cluster dengan memberikan nama, penyedia, dan wilayah.
```
eksctl register cluster --name my-cluster --provider my-provider --region region-code
```
Contoh output:
```
2021-08-19 13:47:26 [ℹ] creating IAM role "eksctl-20210819194112186040"
2021-08-19 13:47:26 [ℹ] registered cluster "" successfully
2021-08-19 13:47:26 [ℹ] wrote file eks-connector.yaml to
2021-08-19 13:47:26 [ℹ] wrote file eks-connector-clusterrole.yaml to
2021-08-19 13:47:26 [ℹ] wrote file eks-connector-console-dashboard-full-access-group.yaml to
2021-08-19 13:47:26 [!] note: "eks-connector-clusterrole.yaml" and "eks-connector-console-dashboard-full-access-group.yaml" give full EKS Console access to IAM identity "", edit if required; read https://eksctl.io/usage/eks-connector for more info
2021-08-19 13:47:26 [ℹ] run `kubectl apply -f eks-connector.yaml,eks-connector-clusterrole.yaml,eks-connector-console-dashboard-full-access-group.yaml` before expiry> to connect the cluster
```
Ini membuat file di komputer lokal Anda. File-file ini harus diterapkan ke cluster eksternal dalam waktu 3 hari, atau pendaftaran berakhir.
1. Di terminal yang dapat mengakses cluster, terapkan `eks-connector-binding.yaml` file:
```
kubectl apply -f eks-connector-binding.yaml
```
## Langkah 2: Memasang `eks-connector` agen
Untuk menginstal `eks-connector` agen, gunakan salah satu alat berikut:
+ [Helm](#helm_agent_cluster_connect)
+ [yaml](#yaml_agent_cluster_connect)
### Helm
**catatan**
Jika Anda mendaftarkan kluster`eksctl`, gunakan metode manifes YAMAL alih-alih metode bagan Helm.
1. Jika Anda menggunakan AWS CLI pada langkah sebelumnya, ganti `ACTIVATION_CODE` dan `ACTIVATION_ID` dalam perintah berikut dengan`activationId`, dan `activationCode` nilai masing-masing. Ganti `aws-region` dengan AWS Region yang Anda gunakan pada langkah sebelumnya. Kemudian jalankan perintah untuk menginstal `eks-connector` agen pada cluster pendaftaran:
```
$ helm install eks-connector \
--namespace eks-connector \
oci://public.ecr.aws/eks-connector/eks-connector-chart \
--set eks.activationCode=ACTIVATION_CODE \
--set eks.activationId=ACTIVATION_ID \
--set eks.agentRegion=aws-region
```
Jika Anda menggunakan langkah sebelumnya, gunakan perintah yang Anda salin dari langkah sebelumnya yang memiliki nilai-nilai ini terisi. Konsol Manajemen AWS
1. Periksa kesehatan `eks-connector` penerapan yang diinstal dan tunggu status cluster terdaftar di Amazon EKS. `ACTIVE`
### yaml
Selesaikan koneksi dengan menerapkan file manifes Amazon EKS Connector ke cluster Kubernetes Anda. Untuk melakukan ini, Anda harus menggunakan metode yang dijelaskan sebelumnya. Jika manifes tidak diterapkan dalam tiga hari, pendaftaran Amazon EKS Connector akan kedaluwarsa. Jika koneksi cluster kedaluwarsa, cluster harus dideregistrasi sebelum menghubungkan cluster lagi.
1. Unduh file YAMM Konektor Amazon EKS.
```
curl -O https://amazon-eks.s3.us-west-2.amazonaws.com/eks-connector/manifests/eks-connector/latest/eks-connector.yaml
```
1. Edit file YAMM Konektor Amazon EKS untuk mengganti semua referensi `%AWS_REGION%``%EKS_ACTIVATION_ID%`,`aws-region`, `%EKS_ACTIVATION_CODE%` dengan`activationId`,, dan `activationCode` dari output langkah sebelumnya.
Contoh perintah berikut dapat menggantikan nilai-nilai ini.
```
sed -i "s~%AWS_REGION%~$aws-region~g; s~%EKS_ACTIVATION_ID%~$EKS_ACTIVATION_ID~g; s~%EKS_ACTIVATION_CODE%~$(echo -n $EKS_ACTIVATION_CODE | base64)~g" eks-connector.yaml
```
**penting**
Pastikan kode aktivasi Anda dalam format base64.
1. Di terminal yang dapat mengakses cluster, Anda dapat menerapkan file manifes yang diperbarui dengan menjalankan perintah berikut:
```
kubectl apply -f eks-connector.yaml
```
1. Setelah manifes Amazon EKS Connector dan file YAMM yang mengikat peran diterapkan ke klaster Kubernetes Anda, konfirmasikan bahwa klaster tersebut sekarang terhubung.
```
aws eks describe-cluster \
--name "my-first-registered-cluster" \
--region AWS_REGION
```
Outputnya harus mencakup`status=ACTIVE`.
1. (Opsional) Tambahkan tag ke cluster Anda. Untuk informasi selengkapnya, lihat [Mengatur sumber daya Amazon EKS dengan tag](eks-using-tags.md).
## Langkah selanjutnya
Jika Anda memiliki masalah dengan langkah-langkah ini, lihat[Memecahkan masalah Konektor Amazon EKS](troubleshooting-connector.md).
Untuk memberikan akses [prinsipal IAM tambahan ke konsol Amazon EKS](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html#iam-term-principal) untuk melihat sumber daya Kubernetes di klaster yang terhubung, lihat. [Berikan akses untuk melihat resource klaster Kubernetes di konsol Amazon EKS](connector-grant-access.md)