Erstellen Sie einen Amazon EKS-Cluster

Wenn Sie bereits über eine Cluster-IAM-Rolle verfügen oder mit der Sie Ihren Cluster erstellen möchteneksctl, können Sie diesen Schritt überspringen. Standardmäßig erstellt eksctl eine Rolle für Sie.

Führen Sie den folgenden Befehl aus, um eine JSON-Datei für eine IAM-Vertrauensrichtlinie zu erstellen.

cat >eks-cluster-role-trust-policy.json <<EOF
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Service": "eks.amazonaws.com"
      },
      "Action": "sts:AssumeRole"
    }
  ]
}
EOF

Erstellen Sie die Amazon-EKS-Cluster-IAM-Rolle. Falls erforderlich, stellen Sie eks-cluster-role-trust-policy.json den Pfad auf Ihrem Computer voran, in den Sie im vorherigen Schritt die Datei geschrieben haben. Der Befehl verknüpft die im vorherigen Schritt erstellte Vertrauensrichtlinie mit der Rolle. Um eine IAM-Rolle zu erstellen, muss dem IAM-Prinzipal, der die Rolle erstellt, die iam:CreateRole-Aktion (Berechtigung) zugewiesen werden.

aws iam create-role --role-name myAmazonEKSClusterRole --assume-role-policy-document file://"eks-cluster-role-trust-policy.json"

Sie können entweder die von Amazon EKS verwaltete Richtlinie zuweisen oder Ihre eigene benutzerdefinierte Richtlinie erstellen. Informationen zu den Mindestberechtigungen, die Sie in Ihrer benutzerdefinierten Richtlinie verwenden müssen, finden Sie unter Amazon-EKS-Cluster-IAM-Rolle.

Fügen Sie der Rolle die von Amazon EKS verwaltete Richtlinie mit dem Namen Amazon EKSCluster Policy hinzu. Um eine IAM-Richtlinie an einen IAM-Prinzipal anzuhängen, muss der Prinzipal, der die Richtlinie anhängt, eine der folgenden IAM-Aktionen (Berechtigungen) zugewiesen werden: iam:AttachUserPolicy oder iam:AttachRolePolicy.

aws iam attach-role-policy --policy-arn arn:aws: iam::aws:policy/AmazonEKSClusterPolicy --role-name myAmazonEKSClusterRole

Sie benötigen eine Version 0.205.0 oder eine neuere Version des eksctl Befehlszeilentools, das auf Ihrem Gerät installiert ist oder. AWS CloudShell Informationen zum Installieren und Aktualisieren von eksctl finden Sie in der Dokumentation zu eksctl unter Installation.

Erstellen Sie einen Amazon IPv4 EKS-Cluster mit der Amazon EKS-Standardversion von Kubernetes in Ihrer AWS Standardregion. Nehmen Sie vor der Ausführung des Befehls die folgenden Ersetzungen vor:

region-codeErsetzen Sie es durch die AWS Region, in der Sie Ihren Cluster erstellen möchten.

Ersetzen Sie my-cluster durch Ihren Cluster-Namen. Der Name darf nur alphanumerische Zeichen (wobei die Groß- und Kleinschreibung beachtet werden muss) und Bindestriche enthalten. Es muss mit einem alphanumerischen Zeichen beginnen und darf nicht länger als 100 Zeichen sein. Der Name muss innerhalb der AWS Region und des AWS Kontos, in dem Sie den Cluster erstellen, eindeutig sein.

Ersetzen Sie 1.32 durch eine von Amazon EKS unterstützte Version.

Ändern Sie die Werte für vpc-private-subnets, um Ihre Anforderungen zu erfüllen. Sie können auch weitere hinzufügen IDs. Sie müssen mindestens zwei Subnetze IDs angeben. Wenn Sie lieber öffentliche Subnetze angeben möchten, können Sie zu wechseln--vpc-private-subnets. --vpc-public-subnets Öffentlichen Subnetzen ist eine Routing-Tabelle mit einer Route zu einem Internet-Gateway zugeordnet, privaten Subnetzen ist jedoch keine Routing-Tabelle zugeordnet. Wir empfehlen, nach Möglichkeit private Subnetze zu verwenden.

Die von Ihnen gewählten Subnetze müssen die Anforderungen für Amazon-EKS-Subnetze erfüllen. Bevor Sie Subnetze auswählen, empfehlen wir, dass Sie mit allen Anforderungen und Überlegungen zu Amazon EKS VPC und Subnetzen vertraut sind.

Führen Sie den folgenden Befehl aus:

eksctl create cluster --name my-cluster --region region-code --version 1.32 --vpc-private-subnets subnet-ExampleID1,subnet-ExampleID2 --without-nodegroup

Die Clusterbereitstellung dauert mehrere Minuten. Während der Cluster erstellt wird, werden mehrere Ausgabezeilen angezeigt. Die letzte Ausgabezeile ähnelt der folgenden Beispielzeile.

[✓]  EKS cluster "my-cluster" in "region-code" region is ready

Fahren Sie fort mit Schritt 3: Kubeconfig aktualisieren

Öffnen Sie die Amazon-EKS-Konsole.

Wählen Sie Cluster hinzufügen und dann Erstellen aus.

Wählen Sie unter Konfigurationsoptionen die Option Benutzerdefinierte Konfiguration

Schalten Sie unter EKS-Automatikmodus die Option EKS-Automatikmodus verwenden aus.

Füllen Sie auf der Seite Configure cluster (Cluster konfigurieren) die folgenden Felder aus:

Geben Sie auf der Seite „Cluster konfigurieren“ im Bereich Clusterzugriff die folgenden Felder ein:

Wählen Sie auf der Seite Specify networking (Netzwerk angeben) die Werte für die folgenden Felder aus:

Sie können diese Option nur angeben, wenn Sie die IPv4-Adressfamilie verwenden, und nur bei Erstellen des Clusters. Wenn Sie dies nicht angeben, weist Kubernetes Dienst-IP-Adressen entweder aus den oder den CIDR-Blöcken zu. 10.100.0.0/16 172.20.0.0/16

(Optional) Auf der Seite Beobachtbarkeit konfigurieren können Sie Metriken und Optionen zur Steuerebenen-Protokollierung aktivieren. Standardmäßig sind alle Protokollierungstypen deaktiviert.

Wenn Sie mit dieser Seite fertig sind, wählen Sie Weiter aus.

Wählen Sie auf der Seite Select add-ons (Add-Ons auswählen) die Add-Ons aus, die Sie Ihrem Cluster hinzufügen möchten. Bestimmte Add-Ons sind vorausgewählt. Sie können so viele Amazon EKS-Add-Ons und AWS Marketplace-Add-Ons auswählen, wie Sie benötigen. Wenn die AWS Marketplace-Add-Ons, die Sie installieren möchten, nicht aufgeführt sind, können Sie auf die Seitennummerierung klicken, um zusätzliche Seitenergebnisse anzuzeigen, oder nach verfügbaren AWS Marketplace-Add-Ons suchen, indem Sie Text in das Suchfeld eingeben. Sie können auch nach Kategorie, Anbieter oder Preismodell filtern und dann die Add-Ons aus den Suchergebnissen auswählen. Beim Erstellen eines Clusters können Sie jedes Add-on, das EKS Pod Identities unterstützt, anzeigen, auswählen und installieren, wie unter beschriebenErfahren Sie, wie EKS Pod Identity Pods Zugriff auf AWS Dienste gewährt.

Wenn Sie mit dieser Seite fertig sind, wählen Sie Weiter aus.

Einige Add-Ons, wie Amazon VPC CNI, CoreDNS und kube-proxy, sind standardmäßig installiert. Wenn Sie eines der Standard-Add-Ons deaktivieren, kann dies Ihre Fähigkeit beeinträchtigen, Kubernetes-Anwendungen auszuführen.

Wählen Sie auf der Seite Einstellungen für ausgewählte Add-ons konfigurieren die Version aus, die Sie installieren möchten. Sie können nach der Clustererstellung jederzeit auf eine neuere Version aktualisieren.

Bei Add-Ons, die EKS Pod Identities unterstützen, können Sie die Konsole verwenden, um die Rolle automatisch zu generieren, wobei der Name, die AWS verwaltete Richtlinie und die Vertrauensrichtlinie speziell für das Add-on vorausgefüllt sind. Sie können vorhandene Rollen wiederverwenden oder neue Rollen für unterstützte Add-Ons erstellen. Die Schritte zur Verwendung der Konsole zum Erstellen von Rollen für Add-Ons, die EKS Pod Identities unterstützen, finden Sie unter. Add-on erstellen (AWS Konsole) Wenn ein Add-On EKS Pod Identity nicht unterstützt, wird eine Meldung mit Anweisungen zur Verwendung des Assistenten zum Erstellen der IAM-Rollen für Dienstkonten (IRSA) angezeigt, nachdem der Cluster erstellt wurde.

Sie können die Konfiguration jedes Add-Ons nach der Cluster-Erstellung aktualisieren. Weitere Informationen zum Konfigurieren eines Add-Ons finden Sie unter Ein Amazon EKS-Add-on aktualisieren. Wenn Sie mit dieser Seite fertig sind, wählen Sie Weiter aus.

Überprüfen Sie auf der Seite Review and create (Überprüfen und erstellen) die Informationen, die Sie auf den vorherigen Seiten eingegeben oder ausgewählt haben. Wenn Sie Änderungen vornehmen müssen, wählen Sie Edit (Bearbeiten). Wenn Sie zufrieden sind, wählen Sie Create. Das Feld Status zeigt CREATING (WIRD ERSTELLT) an, während der Cluster bereitgestellt wird.

Die Clusterbereitstellung dauert mehrere Minuten.

Fahren Sie fort mit Schritt 3: Kubeconfig aktualisieren

Erstellen Sie den Cluster mit dem folgenden Befehl. Nehmen Sie vor der Ausführung des Befehls die folgenden Ersetzungen vor:

Sie können diese Option nur angeben, wenn Sie die IPv4-Adressfamilie verwenden, und nur bei Erstellen des Clusters. Wenn Sie dies nicht angeben, weist Kubernetes Dienst-IP-Adressen entweder aus den oder den CIDR-Blöcken zu. 10.100.0.0/16 172.20.0.0/16

Die Bereitstellung des Clusters dauert mehrere Minuten. Sie können den Status Ihres Clusters mit dem folgenden Befehl überprüfen.

aws eks describe-cluster --region region-code --name my-cluster --query "cluster.status"

Fahren Sie erst mit dem nächsten Schritt fort, wenn die zurückgegebene Ausgabe ACTIVE

Fahren Sie fort mit Schritt 3: Kubeconfig aktualisieren

Wenn Sie Ihren Cluster mit eksctl erstellt haben, können Sie diesen Schritt überspringen. Das liegt daran, dass eksctl diesen Schritt bereits für Sie durchgeführt hat. Aktivieren Sie kubectl, um mit Ihrem Cluster zu kommunizieren, indem Sie einen neuen Kontext zur Datei kubectl config hinzufügen. Weitere Informationen zum Erstellen und Aktualisieren der Datei finden Sie unter Connect kubectl mit einem EKS-Cluster, indem Sie eine kubeconfig-Datei erstellen.

aws eks update-kubeconfig --region region-code --name my-cluster

Eine Beispielausgabe sieht wie folgt aus.

Added new context arn:aws: eks:region-code:111122223333:cluster/my-cluster to /home/username/.kube/config

Bestätigen Sie die Kommunikation mit Ihrem Cluster, indem Sie den folgenden Befehl ausführen.

kubectl get svc

Eine Beispielausgabe sieht wie folgt aus.

NAME         TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGE
kubernetes   ClusterIP   10.100.0.1   <none>        443/TCP   28h

(Empfohlen) Um einige Amazon EKS-Add-Ons zu verwenden oder einzelnen Kubernetes-Workloads bestimmte AWS Identity and Access Management (IAM) -Berechtigungen zuzuweisen, erstellen Sie einen IAM OpenID Connect (OIDC) -Anbieter für Ihren Cluster. Sie müssen einen IAM-OIDC-Anbieter für Ihren Cluster nur einmal erstellen. Weitere Informationen zu Amazon EKS-Add-ons finden Sie unter Amazon-EKS-Add-ons. Weitere Informationen zum Zuweisen bestimmter IAM-Berechtigungen zu Ihren Workloads finden Sie unter IAM-Rollen für Servicekonten.

(Empfohlen) Konfigurieren Sie Ihren Cluster für das Amazon VPC CNI-Plug-In für Kubernetes, bevor Sie EC2 Amazon-Knoten in Ihrem Cluster bereitstellen. Standardmäßig wurde das Plugin mit Ihrem Cluster installiert. Wenn Sie EC2 Amazon-Knoten zu Ihrem Cluster hinzufügen, wird das Plugin automatisch auf jedem EC2 Amazon-Knoten bereitgestellt, den Sie hinzufügen. Das Plugin erfordert, dass Sie einer IAM-Rolle eine der folgenden IAM-Richtlinien zuordnen. Wenn Ihr Cluster die IPv4 Familie verwendet, verwenden Sie die von Amazoneks_CNI_Policy verwaltete IAM-Richtlinie. Wenn Ihr Cluster die IPv6 Familie verwendet, verwenden Sie eine von Ihnen erstellte IAM-Richtlinie.

Die IAM-Rolle, an die Sie die Richtlinie anhängen, kann die IAM-Rolle des Knotens oder eine dedizierte Rolle sein, die nur für das Plugin verwendet wird. Wir empfehlen, die Richtlinie an diese Rolle anzuhängen. Weitere Informationen zum Erstellen der Rolle finden Sie unter Amazon VPC CNI-Plugin für die Verwendung von IRSA konfigurieren oder Amazon EKS node IAM role.

Wenn Sie Ihren Cluster mit dem bereitgestellt haben AWS Management Console, können Sie diesen Schritt überspringen. Der AWS Management Console stellt standardmäßig das Amazon VPC CNI-Plug-In für Kubernetes-, CoreDNS- und kube-proxy Amazon EKS-Add-Ons bereit.

Wenn Sie Ihren Cluster entweder mit der CLI eksctl oder mit der AWS CLI bereitstellen, werden das Amazon VPC CNI-Plug-In für Kubernetes, CoreDNS und selbstverwaltete Add-Ons bereitgestellt. kube-proxy Sie können das Amazon VPC CNI-Plug-In für Kubernetes, CoreDNS und kube-proxy selbstverwaltete Add-Ons, die mit Ihrem Cluster bereitgestellt werden, zu Amazon EKS-Add-Ons migrieren. Weitere Informationen finden Sie unter Amazon-EKS-Add-ons.

(Optional) Falls Sie dies noch nicht getan haben, können Sie Prometheus-Metriken für Ihren Cluster aktivieren. Weitere Informationen finden Sie unter Erstellen eine Scrapers im Benutzerhandbuch von Amazon Managed Service für Prometheus.

Wenn Sie planen, Workloads in Ihrem Cluster bereitzustellen, die Amazon EBS-Volumes verwenden, und Sie einen 1.23 oder einen späteren Cluster erstellt haben, müssen Sie Amazon EBS CSI auf Ihrem Cluster installieren, bevor Sie die Workloads bereitstellen.