Verbinden Sie einen externen Kubernetes-Cluster mit der Amazon-EKS-Managementkonsole

Die AWS-CLI muss installiert sein. Informationen zur Installation oder Aktualisierung finden Sie unter Installieren der AWS-CLI.

Geben Sie für die Connector-Konfiguration Ihre Amazon-EKS-Connector-Agent-IAM-Rolle an. Weitere Informationen finden Sie unter Erforderliche IAM-Rollen für Amazon EKS Connector.

aws eks register-cluster \
     --name my-first-registered-cluster \
     --connector-config roleArn=arn:aws:iam::111122223333:role/AmazonEKSConnectorAgentRole,provider="OTHER" \
     --region aws-region

Eine Beispielausgabe sieht wie folgt aus.

{
    "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"
    }
}

Sie verwenden die Werte aws-region, activationId und activationCode im nächsten Schritt.

Öffnen Sie die Amazon-EKS-Konsole.

Wählen Sie Add cluster (Cluster hinzufügen) und Register (Registrieren) aus, um die Konfigurationsseite aufzurufen.

Füllen Sie im Abschnitt Cluster konfigurieren die folgenden Felder aus:

Wählen Sie Cluster registrieren aus.

Die Seite Cluster-Übersicht wird angezeigt. Wenn Sie das Helm-Chart verwenden möchten, kopieren Sie den Befehl helm install und fahren Sie mit dem nächsten Schritt fort. Wenn Sie das YAML-Manifest verwenden möchten, wählen Sie YAML-Datei herunterladen aus, um die Manifestdatei auf Ihr lokales Laufwerk herunterzuladen.

Der Befehl bzw. die Manifestdatei kann nur einmal für den registrierten Cluster verwendet werden. Wenn Sie Ressourcen aus dem Kubernetes-Cluster löschen, müssen Sie den Cluster erneut registrieren und eine neue Manifestdatei abrufen.

eksctl-Version 0.68 oder höher muss installiert sein. Informationen zur Installation oder Aktualisierung finden Sie unter Erste Schritte mit Amazon EKS – eksctl.

Registrieren Sie den Cluster unter Angabe eines Namens, eines Anbieters und einer Region.

eksctl register cluster --name my-cluster --provider my-provider --region region-code

Beispielausgabe:

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

Dadurch werden Dateien auf Ihrem lokalen Computer erstellt. Diese Dateien müssen innerhalb von 3 Tagen auf den externen Cluster angewendet werden, sonst läuft die Registrierung ab.

Wenden Sie in einem Terminal, das Zugriff auf den Cluster hat, die Datei eks-connector-binding.yaml an:

kubectl apply -f eks-connector-binding.yaml

Wenn Sie im vorherigen Schritt die AWS-CLI verwendet haben, ersetzen Sie ACTIVATION_CODE und ACTIVATION_ID im folgenden Befehl durch die Werte activationId bzw. activationCode. Ersetzen Sie die aws-region durch die AWS-Region, die Sie im vorherigen Schritt verwendet haben. Führen Sie dann den Befehl aus, um den eks-connector-Agent auf dem registrierenden Cluster zu installieren:

$ 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

Wenn Sie im vorherigen Schritt die AWS-Managementkonsole verwendet haben, verwenden Sie den Befehl, den Sie aus dem vorherigen Schritt kopiert haben und in den diese Werte eingetragen sind.

Überprüfen Sie den Zustand der installierten eks-connector-Bereitstellung und warten Sie, bis der Status des registrierten Clusters in Amazon EKS ACTIVE lautet.

Laden Sie die Amazon EKS Connector YAML-Datei herunter.

curl -O https://amazon-eks.s3.us-west-2.amazonaws.com/eks-connector/manifests/eks-connector/latest/eks-connector.yaml

Bearbeiten Sie die YAML-Datei von Amazon EKS Connector und ersetzen Sie alle Verweise auf %AWS_REGION%, %EKS_ACTIVATION_ID%, %EKS_ACTIVATION_CODE% durch die aws-region, activationId und activationCode aus der Ausgabe des vorherigen Schritts.

Der folgende Beispielbefehl kann diese Werte ersetzen.

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

In einem Terminal, das auf den Cluster zugreifen kann, können Sie jetzt die aktualisierte Manifestdatei mit dem folgenden Befehl anwenden:

kubectl apply -f eks-connector.yaml

Nachdem die YAML-Dateien des Amazon-EKS-Connector-Manifests und der Rollenbindung auf Ihren Kubernetes-Cluster angewendet wurden, bestätigen Sie, dass der Cluster jetzt verbunden ist.

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

Die Ausgabe sollte status=ACTIVE enthalten.

(Optional) Fügen Sie Ihrem Cluster Tags hinzu. Weitere Informationen finden Sie unter Organisation von Amazon-EKS-Ressourcen mit Tags.