Menghubungkan cluster Kubernetes eksternal ke Konsol Manajemen Amazon EKS

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

Untuk konfigurasi Konektor, tentukan peran IAM agen Konektor Amazon EKS 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 menggunakan activationCode nilai aws-regionactivationId,, dan pada langkah berikutnya.

Buka konsol Amazon EKS.

Pilih Tambah cluster dan pilih Daftar untuk membuka halaman konfigurasi.

Pada bagian Konfigurasi cluster, isi bidang 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 YAML, pilih Unduh file YAML untuk mengunduh file manifes ke drive lokal Anda.

File perintah atau manifes hanya dapat digunakan sekali untuk cluster terdaftar. Jika Anda menghapus sumber daya dari cluster Kubernetes, Anda harus mendaftarkan ulang cluster 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 file yang dihasilkan:

kubectl apply -f eks-connector.yaml,eks-connector-clusterrole.yaml,eks-connector-console-dashboard-full-access-group.yaml

Jika Anda menggunakan AWS CLI pada langkah sebelumnya, ganti perintah ACTIVATION_CODE dan ACTIVATION_ID di berikut denganactivationId, dan activationCode nilai masing-masing. Ganti aws-region dengan Wil AWS ayah yang Anda gunakan pada langkah sebelumnya. Kemudian jalankan perintah untuk menginstal eks-connector agen pada cluster terdaftar:

$ 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 Konsol Manajemen AWS pada langkah sebelumnya, gunakan perintah yang Anda salin dari langkah sebelumnya yang memiliki nilai-nilai ini diisi.

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

Unduh file YAML 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 Amazon EKS Connector YAML untuk mengganti semua referensi %AWS_REGION%%EKS_ACTIVATION_ID%,aws-region, %EKS_ACTIVATION_CODE% denganactivationId,, dan activationCode dari output langkah sebelumnya.

Perintah contoh 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 YAML pengikatan peran diterapkan ke cluster Kubernetes Anda, konfirmasikan bahwa cluster sekarang terhubung.

aws eks describe-cluster \
     --name "my-first-registered-cluster" \
     --region AWS_REGION

Outputnya harus termasukstatus=ACTIVE.

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