Direkt zum Inhalt

Wie behebe ich Zugriffsprobleme in meinen Amazon-EKS-Clustern?

Lesedauer: 4 Minute
0

Beim Versuch, Zugriff auf die Cluster des Amazon Elastic Kubernetes Service (Amazon EKS) zu gewähren, treten Schwierigkeiten auf.

Behebung

Hinweis: Wenn du beim Ausführen von AWS Command Line Interface (AWS CLI)-Befehlen Fehlermeldungen erhältst, findest du weitere Informationen dazu unter Problembehandlung bei der AWS CLI. Stelle außerdem sicher, dass du die neueste Version von AWS CLI verwendest.

Verwende Amazon-EKS-Zugriffseinträge, um Benutzern und Rollen von AWS Identity and Access Management (IAM) Zugriff auf die Kubernetes-API zu gewähren.

IAM-Prinzipalberechtigungen konfigurieren

Der IAM-Prinzipal muss über die folgenden Berechtigungen für deinen Cluster verfügen:

  • CreateAccessEntry
  • ListAccessEntries
  • DescribeAccessEntry
  • DeleteAccessEntry
  • UpdateAccessEntry
  • ListAccessPolicies
  • AssociateAccessPolicy
  • DisassociateAccessPolicy

Weitere Informationen zu Amazon-EKS-Berechtigungen findest du unter Von Amazon-Elastic-Kubernetes-Service definierte Aktionen.

Zugriffsrichtlinienberechtigungen konfigurieren

Die Zugriffsrichtlinie legt die Zugriffsebene fest, auf der ein Benutzer auf die Kubernetes-API zugreifen kann. Verwende die folgenden Richtlinien, um Zugriffseinträge zu erstellen:

Wenn du Zugriffseinträge mit den oben genannten Richtlinien erstellst, gewährst du Zugriff auf einen Namespace für Berechtigungen auf Kubernetes-Clusterebene.

Hinweis: Du kannst den Inhalt einer Zugriffsrichtlinie nicht ändern und auch keine eigenen Zugriffsrichtlinien erstellen.

IAM-Benutzern Zugriff auf deinen Amazon-EKS-Cluster gewähren

Ändere den Authentifizierungsmodus

Wichtig: Nachdem du die Zugriffseintragsmethode aktiviert hast, kannst du sie nicht mehr deaktivieren.

Um Zugriffseinträge zu verwenden, ändere den Authentifizierungsmodus für den Amazon-EKS-Cluster entweder auf API oder API_AND_CONFIG_MAP. Führe den folgenden update-cluster-config-AWS-CLI-Befehl aus:

aws eks update-cluster-config \
   --name my-cluster \
   --access-config authenticationMode=API_AND_CONFIG_MAP

**Hinweis:**Ersetze my-cluster durch den Clusternamen. Um die ConfigMap-Methode dauerhaft zu deaktivieren, ersetze API_AND_CONFIG_MAP durch API.

Erstelle einen Zugriffseintrag für die IAM-Entität und hänge die Zugriffsrichtlinie an

Gewähre Clusteradministrator-Zugriff auf deinen Amazon-EKS-Cluster. Führe zunächst den folgenden create-access-entry-Befehl aus, um einen Zugriffseintrag für deinen IAM-Benutzer oder deine IAM-Rolle zu erstellen:

aws eks create-access-entry --cluster-name my-cluster \
  --principal-arn arn:aws:iam::111122223333:user/example-user

Hinweis: Ersetze my-cluster durch deinen Clusternamen und arn:aws:iam::111122223333:user/example-user durch deine IAM-Rolle oder den ARN des Benutzers.

Führe danach den folgenden associate-access-policy-Befehl aus, um die AmazonEKSClusterAdminPolicy dem IAM-Benutzer oder der IAM-Rolle zuzuordnen:

aws eks associate-access-policy --cluster-name my-cluster\
  --principal-arn arn:aws:iam::111122223333:user/example-user \
  --policy-arn arn:aws:eks::aws:cluster-access-policy/AmazonEKSClusterAdminPolicy \
  --access-scope type=cluster

Hinweis: Ersetze my-cluster durch deinen Clusternamen und arn:aws:iam::111122223333:user/example-user durch deine IAM-Rolle oder den ARN des Benutzers.

Um dem IAM-Benutzer oder der IAM-Rolle Administratorzugriff auf einen bestimmten Namespace zu gewähren, führe den folgenden associate-access-policy-Befehl aus:

aws eks associate-access-policy --cluster-name my-cluster\
  --principal-arn arn:aws:iam::111122223333:role/example-role \
  --policy-arn arn:aws:eks::aws:cluster-access-policy/AmazonEKSAdminPolicy \
  --access-scope type=namespace,namespaces=test*

Hinweis: Ersetze my-cluster durch deinen Clusternamen und arn:aws:iam::111122223333:role/example-role durch deine IAM-Rolle oder den ARN des Benutzers. Ersetze außerdem test durch deinen Namespace-Namen.

Um Zugriffseinträge zusammen mit der rollenbasierten Zugriffskontrolle (RBAC) von Kubernetes zu verwenden, führe den folgenden create-access-entry-Befehl aus:

aws eks create-access-entry --cluster-name my-cluster \
  --principal-arn arn:aws:iam::111122223333:role/example-role-2 \
  --kubernetes-groups viewers

Hinweis: Ersetze my-cluster durch deinen Clusternamen und arn:aws:iam::111122223333:user/example-role-2 durch deine IAM-Rolle oder den ARN des Benutzers. Ersetze viewers durch den Namen der Gruppe, die im Kubernetes-Objekt RoleBinding oder im Kubernetes-Objekt ClusterRoleBinding in deinem Cluster angegeben ist.

Bestätige deine Anmeldeinformationen für die IAM-Entität

Um die IAM-Benutzer- oder Rollenanmeldeinformationen zu überprüfen, die in der AWS CLI verwendet werden, führe den folgenden get-caller-identity-Befehl aus:

aws sts get-caller-identity

Die Befehlsausgabe muss den IAM-Benutzer oder die IAM-Rolle zurückgeben, für die du einen Zugriffseintrag erstellt hast. Wenn du eine andere IAM-Rolle oder einen anderen IAM-Benutzer erhältst, stelle sicher, dass du die Anmeldeinformationen der Rolle oder des Benutzers richtig konfiguriert hast.

Kubeconfig für deine IAM-Entität erstellen

Um die Kubeconfig für deine IAM-Rolle oder deinen IAM-Benutzer zu erstellen, führe den folgenden update-kubeconfig-Befehl aus:

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

Hinweis: Ersetze my-cluster durch den Namen deines Clusters und aws-region durch deine AWS-Region.

Überprüfe deinen Kubernetes-Zugriff

Vergewissere dich, dass deine IAM-Entität authentifiziert ist und du auf deine Amazon-EKS-Cluster-Ressourcen zugreifen kannst.

Führe den folgenden Befehl aus, um festzustellen, ob du Pods in einem beliebigen Namespace erstellen kannst:

kubectl auth can-i create pods --all-namespaces

Führe den folgenden Befehl aus, um festzustellen, ob du Bereitstellungen in einem bestimmten Namespace auflisten kannst:

kubectl auth can-i list deployments.apps -n test

Hinweis: Ersetze test durch den Namen deines Namespaces.

AWS OFFICIALAktualisiert vor 2 Jahren