Connect cluster Kubernetes eksternal ke Amazon EKS Management Console

AWS CLI harus diinstal. Untuk menginstal atau memutakhirkannya, lihat Menginstal AWS CLI.

Untuk konfigurasi Konektor, tentukan peran IAM agen Amazon EKS Connector Anda. Untuk informasi selengkapnya, lihat Peran IAM yang diperlukan untuk Konektor Amazon EKS.

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 menggunakanaws-region,activationId, dan activationCode nilai di langkah berikutnya.

Buka konsol Amazon EKS.

Pilih Add cluster dan pilih Register untuk membuka halaman konfigurasi.

Pada bagian Configure cluster, isi kolom berikut:

Pilih Daftar cluster.

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.

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.

eksctlversi 0.68 atau yang lebih baru harus diinstal. Untuk menginstal atau memutakhirkannya, lihatMemulai dengan Amazon EKS - eksctl.

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 "<name>" successfully
2021-08-19 13:47:26 [ℹ]  wrote file eks-connector.yaml to <current directory>
2021-08-19 13:47:26 [ℹ]  wrote file eks-connector-clusterrole.yaml to <current directory>
2021-08-19 13:47:26 [ℹ]  wrote file eks-connector-console-dashboard-full-access-group.yaml to <current directory>
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 "<aws-arn>", 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.

Di terminal yang dapat mengakses cluster, terapkan eks-connector-binding.yaml file:

kubectl apply -f eks-connector-binding.yaml

Jika Anda menggunakan AWS CLI pada langkah sebelumnya, ganti ACTIVATION_CODE dan ACTIVATION_ID dalam perintah berikut denganactivationId, 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. AWS Management Console

Periksa kesehatan eks-connector penerapan yang diinstal dan tunggu status cluster terdaftar di Amazon EKS. ACTIVE

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

Edit file YAMM Konektor Amazon EKS untuk mengganti semua referensi %AWS_REGION%%EKS_ACTIVATION_ID%,aws-region, %EKS_ACTIVATION_CODE% denganactivationId,, 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

Di terminal yang dapat mengakses cluster, Anda dapat menerapkan file manifes yang diperbarui dengan menjalankan perintah berikut:

kubectl apply -f eks-connector.yaml

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 mencakupstatus=ACTIVE.

(Opsional) Tambahkan tag ke cluster Anda. Untuk informasi selengkapnya, lihat Mengatur sumber daya Amazon EKS dengan tag.