View a markdown version of this page

Authentifizierung bei Amazon EKS-Zugangseinträgen - AWS Batch

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Authentifizierung bei Amazon EKS-Zugangseinträgen

Amazon EKS unterstützt zwei Mechanismen, um einem IAM-Prinzipal die Erlaubnis zu erteilen, die des Clusters aufzurufen Kubernetes API: das Erbe aws-auth ConfigMap und das neuere auf die Eingabe-API zugreifen. Ein Zugangseintrag gewährt Kubernetes API-Zugriff auf einen IAM-Prinzipal, ohne dass Sie einen bearbeiten müssen ConfigMap. AWS Batch kann sich über einen der beiden Mechanismen bei Ihrem Cluster authentifizieren.

Wenn Sie einstellen eksConfiguration.accessEntry.desiredState zu ENABLED in einer Computerumgebung AWS Batch kann den Zugriffseintrag für diese Computerumgebung auf dem Cluster verwalten. Sie müssen das nicht mehr manuell bearbeiten aws-auth ConfigMap.

Ob AWS Batch Bestimmungen ein Zugangseintrag hängt von Ihrem ab AWS Batch Rechenumgebung und Ihre Amazon EKS-Cluster-Konfiguration. Details dazu finden Sie unter Interaktion mit dem Cluster Authentifizierungsmodus.

Werte für ZugriffEntry.desiredState

Das desiredState Feld an EksAccessEntry deklariert den gewünschten Zugriffsstatus für die Rechenumgebung. Folgende sind gültige Werte:

ENABLED

AWS Batch erstellt eine AWS Batch-verwalteter Zugriffseintrag auf dem Cluster für die Rechenumgebung. AWS Batch erstellt nur eine AWS Batch-verwalteter Zugriffseintrag, wenn alle Rechenumgebungen auf dem Cluster eingerichtet sind desiredState zu ENABLED (siehe Wie AWS Batch versöhnt Gewünschter Zustand in allen Computerumgebungen für Einzelheiten).

DISABLED

AWS Batch löscht den AWS Batch-verwalteter Zugriffseintrag für den Cluster. AWS Batch löscht nur eine AWS Batch-verwalteter Zugriffseintrag, wenn alle Rechenumgebungen auf dem Cluster eingerichtet sind desiredState zu DISABLED (siehe Wie AWS Batch versöhnt Gewünschter Zustand in allen Computerumgebungen für Einzelheiten). Der Zugriff auf den Cluster muss über den konfiguriert werden aws-auth ConfigMap.

INHERIT_FROM_CLUSTER

AWS Batch bezieht sich auf den aktuellen Zugriffseintrag des Clusters status. Auf einem Amazon EKS-Cluster, dessen Authentifizierungsmodus lautet API, AWS Batch erstellt und verwaltet einen Zugriffseintrag, da der Cluster keinen hat aws-auth ConfigMap um darauf zurückgreifen zu können. Auf einem Cluster, dessen Authentifizierungsmodus lautet CONFIG_MAP oder API_AND_CONFIG_MAP, AWS Batch fügt weder einen Zugangseintrag hinzu noch entfernt er ihn.

In der Rechenumgebung ist außerdem ein schreibgeschützter Modus verfügbar accessEntry.status Feld in DescribeComputeEnvironments Antworten. ACTIVE bedeutet, dass ein AWS Batch Der Eintrag für den verwalteten Zugriff für die Rechenumgebung ist auf dem Cluster vorhanden und hat Vorrang vor dem aws-auth ConfigMap. INACTIVE bedeutet, dass nein AWS Batch-verwalteter Zugriffseintrag ist vorhanden. Das kann daran liegen desiredState ist DISABLED, weil sich die Computerumgebungen, die auf den Cluster abzielen, noch nicht einig sind desiredState, oder weil der Eintrag noch nicht bereitgestellt wurde. Wenn accessEntry.status ist INACTIVE, Batch-Anwendungen aws-auth ConfigMap für den Cluster-Zugriff.

Anmerkung

Ein Zugriffseintrag meldet ACTIVE sobald es auf dem Cluster existiert, auch wenn AWS Batch hat die Zuordnung der Zugriffsrichtlinie, die sie nutzbar macht, noch nicht abgeschlossen. Wenn sich der Status der Computerumgebung zu ändert INVALID während accessEntry.status ist ACTIVE, siehe Die Einrichtung des Amazon EKS-Zugangseintrags ist unvollständig.

Anmerkung

Wenn Sie das weglassen accessEntry Feld, AWS Batch zeichnet keine auf desiredState für die Rechenumgebung und DescribeComputeEnvironments gibt keinen zurück. Zum Zweck der Bereitstellung des Zugangseintrags AWS Batch verhält sich wie bei INHERIT_FROM_CLUSTER.

Interaktion mit dem Cluster Authentifizierungsmodus

Wie AWS Batch verhält sich für eine bestimmte Zeit desiredState hängt vom Authentifizierungsmodus des Clusters ab. Die folgende Tabelle gilt für beide CreateComputeEnvironment und UpdateComputeEnvironment.

Cluster authenticationMode

Umgebung berechnen accessEntry.desiredState=ENABLED

Umgebung berechnen accessEntry.desiredState=DISABLED

Umgebung berechnen accessEntry.desiredState=INHERIT_FROM_CLUSTER

CONFIG_MAP

Access-Einträge sind auf dem Cluster nicht verfügbar, also AWS Batch erstellt oder entfernt keins. AWS Batch zeichnet immer noch den von Ihnen angegebenen Wert auf. Nachdem Sie den Authentifizierungsmodus des Clusters geändert haben, wird dieser aufgezeichnete Wert bei Ihrem nächsten Mal wirksam CreateComputeEnvironment oder UpdateComputeEnvironment Anruf, der spezifiziert desiredState.

API_AND_CONFIG_MAP

AWS Batch vergleicht die aufgezeichneten Werte in den Rechenumgebungen, die den Cluster gemeinsam nutzen — siehe Wie AWS Batch versöhnt Gewünschter Zustand in allen Computerumgebungen.

Der bestehende Zugriffsmodus wird beibehalten. AWS Batch fügt keinen Zugriffseintrag hinzu oder entfernt ihn.

API

Der Zugriffseintrag wird auf dem Cluster erstellt und verwaltet.

Die Anforderung wurde abgelehnt. Ein Cluster in diesem Modus unterstützt nicht aws-auth ConfigMap, und der ConfigMap Die Methode kann nach der Clustererstellung nicht aktiviert werden, also DISABLED würde der Rechenumgebung keine Möglichkeit zur Authentifizierung geben.

Der Zugriffseintrag wird auf dem Cluster erstellt und verwaltet. Wenn der Cluster API-only, Vererben ist gleichbedeutend mit ENABLED.

Wie AWS Batch versöhnt Gewünschter Zustand in allen Computerumgebungen

Weil ein einzelner Amazon EKS-Cluster mehrere unterstützen kann AWS Batch In Computerumgebungen ist die Zugriffskonfiguration eines Clusters eine gemeinsam genutzte Ressource. AWS Batch gleicht daher das ab oder vergleicht und löst das desiredState Werte, die in diesen Rechenumgebungen aufgezeichnet wurden.

Wenn der Cluster authenticationMode ist API_AND_CONFIG_MAP, AWS Batch vergleicht die desiredState aufgezeichnet für jede Computerumgebung in derselben AWS Konto und AWS Region, die auf den Cluster abzielt. AWS Batch verwendet diesen Vergleich, um zu ermitteln, ob der Zugriffseintrag für jedes Objekt hinzugefügt oder entfernt werden soll CreateComputeEnvironment oder UpdateComputeEnvironment Operation, die spezifiziert desiredState.

Jede Computerumgebung hat desiredState=ENABLED

AWS Batch erstellt den Zugriffseintrag auf dem Cluster.

Jede Computerumgebung hat desiredState=DISABLED

AWS Batch löscht den Zugriffseintrag aus dem Cluster, falls einer existiert.

Das aufgezeichnete desiredState Die Werte stimmen nicht alle überein

AWS Batch behält den vorhandenen Zugriffsmodus bei. Der Zugriffseintrag wird weder hinzugefügt noch entfernt. Dies beinhaltet jede Mischung aus ENABLED, DISABLED, und INHERIT_FROM_CLUSTER, und es schließt auch jede Computerumgebung ein, die keine desiredState aufgezeichnet.

Anmerkung

Um einen Cluster zu wechseln, dessen Authentifizierungsmodus lautet API_AND_CONFIG_MAP von aws-auth ConfigMap um auf die Eingabeauthentifizierung zuzugreifen, setzen desiredState=ENABLED auf jedem AWS Batch Rechenumgebung, die auf den Cluster abzielt. Um zurück zu wechseln, setzen Sie desiredState=DISABLED auf jedem von ihnen.

Was AWS Batch erstellt auf Ihrem Cluster

AWS Batch erstellt einen Zugriffseintrag pro Cluster, der die oben genannten Bedingungen erfüllt, und ordnet dann den AWSBatchClusterPolicy Amazon EKS-Zugriffsrichtlinie für diesen Zugriffseintrag. Der Zugriffseintrag erfolgt pro Cluster und nicht pro Rechenumgebung, also alle AWS Batch Rechenumgebungen, die auf denselben Cluster abzielen, nutzen ihn gemeinsam.

Anmerkung

Durch das Löschen einer Rechenumgebung wird der Zugriffseintrag nicht entfernt, auch wenn es sich um den letzten Eintrag handelt AWS Batch Rechenumgebung auf dem Cluster. Um eine zu entfernen AWS Batch-managed access entry, rufen Sie UpdateComputeEnvironment mit desiredState=DISABLED auf jedem AWS Batch Berechne die Umgebung, die auf den Cluster abzielt, bevor du sie löschst.

Ein Zugriffseintrag allein reicht nicht aus, um Jobs auf dem Cluster auszuführen. Für den Kubernetes Berechtigungen und Knotenzugriff, die Sie selbst konfigurieren müssen, finden Sie unter Cluster-Konfiguration, die Sie noch bereitstellen müssen.

Erforderliche Berechtigungen

AWS Batch verwaltet den Zugriffseintrag mithilfe der Anmeldeinformationen der IAM-Identität, die den aufruft CreateComputeEnvironment oder UpdateComputeEnvironment Betrieb. Diese Identität muss berechtigt sein, die folgenden Amazon EKS-Aktionen auszuführen:

  • eks:DescribeCluster

  • eks:DescribeAccessEntry

  • eks:CreateAccessEntry

  • eks:AssociateAccessPolicy

  • eks:DeleteAccessEntry

Konfigurieren Sie den Zugriffseintrag

Sie können den Zugriffseintrag in einer Computerumgebung über den eksConfiguration.accessEntry Feld des CreateComputeEnvironment oder UpdateComputeEnvironment API.

AWS CLI

Aktiviere eine AWS Batch-verwalteter Zugriffseintrag beim Erstellen einer Computerumgebung

$ aws batch create-compute-environment \ --compute-environment-name my-eks-ce \ --type MANAGED \ --eks-configuration 'eksClusterArn=arn:aws:eks:us-east-1:123456789012:cluster/my-cluster,kubernetesNamespace=my-aws-batch-namespace,accessEntry={desiredState=ENABLED}' \ --compute-resources 'type=EC2,maxvCpus=128,subnets=subnet-a123456b,securityGroupIds=sg-a12b3456,instanceRole=arn:aws:iam::123456789012:instance-profile/my-node-instance-profile'

Aktiviere eine AWS Batch-verwalteter Zugriffseintrag in einer vorhandenen Computerumgebung

$ aws batch update-compute-environment \ --compute-environment my-eks-ce \ --eks-configuration 'accessEntry={desiredState=ENABLED}'

Überprüfen Sie den Status

$ aws batch describe-compute-environments \ --compute-environments my-eks-ce \ --query "computeEnvironments[0].eksConfiguration.accessEntry"

Die Antwort beinhaltet sowohl desiredState die Sie angegeben haben und die beobachteten status:

{ "desiredState": "ENABLED", "status": "ACTIVE" }
Anmerkung

AWS Batch kehrt zurück accessEntry.status für alle Amazon EKS-Rechenumgebungen und Rücksendungen desiredState nur wenn Sie es eingestellt haben. Eine Rechenumgebung, in der Sie nie angegeben haben accessEntry kehrt zurück status allein.

Um aufzuhören AWS Batch aus der Verwaltung des Zugangseintrags setzen desiredState zu DISABLED stattdessen. Bevor Sie dies tun, überprüfen Sie Interaktion mit dem Cluster Authentifizierungsmodus: DISABLED wird auf einem Cluster abgelehnt, dessen Authentifizierungsmodus APIund auf einem Cluster, dessen Authentifizierungsmodus lautet API_AND_CONFIG_MAP der Zugriffseintrag wird erst nach jedem entfernt AWS Batch Die Rechenumgebung, auf die der Cluster abzielt, ist wie folgt eingestellt DISABLED.

API

Benutze das eksConfiguration.accessEntry Objekt in deinem CreateComputeEnvironment oder UpdateComputeEnvironment Anfrage.

Erstellen Sie eine Rechenumgebung mit einem AWS Batch-verwalteter Zugriffseintrag

Einschließen accessEntry im Anfragetext:

{ "computeEnvironmentName": "my-eks-ce", "type": "MANAGED", "state": "ENABLED", "eksConfiguration": { "eksClusterArn": "arn:aws:eks:us-east-1:123456789012:cluster/my-cluster", "kubernetesNamespace": "my-aws-batch-namespace", "accessEntry": { "desiredState": "ENABLED" } }, "computeResources": { "type": "EC2", "maxvCpus": 128, "subnets": ["subnet-a123456b"], "securityGroupIds": ["sg-a12b3456"], "instanceRole": "arn:aws:iam::123456789012:instance-profile/my-node-instance-profile" } }

Aktualisieren Sie den Zugriffseintrag in einer vorhandenen Computerumgebung

{ "computeEnvironment": "my-eks-ce", "eksConfiguration": { "accessEntry": { "desiredState": "ENABLED" } } }

Weitere Informationen finden Sie unter EksAccessEntry, CreateComputeEnvironment, und UpdateComputeEnvironment in der AWS Batch API-Referenz.

Cluster-Konfiguration, die Sie noch bereitstellen müssen

Ein Zugriffseintrag steuert nur, wie AWS Batch authentifiziert sich bei Ihrem Cluster. Es gewährt nicht AWS Batch die Kubernetes Berechtigungen, die es benötigt, um Ihre Jobs auszuführen, und das lässt die Instanzen nicht zu AWS Batch Starts treten dem Cluster bei. Unabhängig davon, welchen Authentifizierungsmechanismus Sie verwenden, müssen Sie dennoch beide der folgenden Optionen konfigurieren.

Wichtig

Einmal ein AWS Batch-verwalteter Zugriffseintrag wird erstellt für AWS Batch serviceverknüpfte Rolle auf einem Cluster (accessEntry.status=ACTIVE), es hat Vorrang vor dem aws-auth ConfigMap Konfiguration für die Rolle. Die ConfigMap Einträge für die AWS Batch serviceverknüpfte Rollen werden nicht verwendet, und AWS Batch authentifiziert sich stattdessen mit dem Zugriffseintrag. Um zurückzukehren zu ConfigMap Authentifizierung, setzen desiredState=DISABLED in allen Computerumgebungen, die auf den Cluster abzielen. Dadurch wird das entfernt AWS Batch-verwalteter Zugriffseintrag.

Kubernetes Berechtigungen für AWS Batch Namensraum

AWS Batch Bedürfnisse Kubernetes Berechtigungen zum Erstellen und Verwalten von Pods in dem Namespace, den Sie angeben eksConfiguration.kubernetesNamespace. Erstellen Sie den Namespace und konfigurieren Sie diese Berechtigungen dann je nach Ihrem Authentifizierungsansatz mit einer der folgenden Methoden:

  • Zuordnung der Zugriffsrichtlinien (erforderlich bei der Zugriffseingabe) status=ACTIVE) — Wenn du festlegst desiredState=ENABLED in allen Computerumgebungen, die auf einen Cluster abzielen, AWS Batch erstellt einen Zugriffseintrag auf Cluster-Ebene AWSBatchClusterPolicy. Sie müssen dann den Namespace-Bereich zuordnen AWSBatchNamespacePolicy gewähren AWS Batch Erlaubnis zum Erstellen und Verwalten von Pods.

    Nachdem der Zugriffseintrag erreicht ist status=ACTIVE, verknüpfen Sie die Namespace-Richtlinie mithilfe von AWS CLI:

    $ aws eks associate-access-policy \ --cluster-name my-cluster \ --principal-arn arn:aws:iam::123456789012:role/aws-service-role/batch.amazonaws.com/AWSServiceRoleForBatch \ --policy-arn arn:aws:eks::aws:cluster-access-policy/AWSBatchNamespacePolicy \ --access-scope type=namespace,namespaces=my-aws-batch-namespace

    Ersetzen my-aws-batch-namespace mit dem Wert, den Sie angegeben haben eksConfiguration.kubernetesNamespace.

    Wichtig

    Ohne die politische Assoziation, die sich auf den Namespace-Bereich bezieht, bleiben Arbeitsplätze hängen RUNNABLE Status. Die Richtlinie auf Clusterebene allein gewährt keine Pod-Verwaltungsberechtigungen.

  • Kubernetes Rollen und Rollenbindungen (beim Zugriff auf den Eintrag) status=INACTIVE) — Wenn der AWS Batch Der Eintrag -managed access ist nicht aktiv, erstellen Sie den Kubernetes Rollen und Rollenbindungen, die diese Berechtigungen gewähren, wie unter beschrieben Schritt 2: Bereiten Sie Ihren Amazon EKS-Cluster vor für AWS Batch. Sie tun dies einmal für jeden Cluster.

    Anmerkung

    Wenn ein AWS Batch-verwalteter Zugriffseintrag ist aktiv (status=ACTIVE), der Kubernetes RBAC-Rollen werden umgangen. Sie müssen stattdessen die Zugriffsrichtlinien-Zuordnungsmethode verwenden.

AWS Batch erstellt diese Ressourcen nicht für Sie, und ein AWS Batch Ein Eintrag mit verwaltetem Zugriff ersetzt sie nicht. Wenn sie fehlen, kann die Rechenumgebung trotzdem VALID während Ihre Jobs nicht gestartet werden können.

Cluster-Zugriff für die Node-Instance-Rolle

Instanzen, die AWS Batch Starts treten dem Cluster mithilfe des Instanzprofils bei, das Sie in angeben computeResources.instanceRole. Diese Rolle benötigt einen eigenen Zugriff auf den Cluster, der getrennt ist von dem AWS Batch-verwalteter Zugriffseintrag und welcher AWS Batch konfiguriert nicht.

Die Konfigurationsmethode hängt von Ihrem Cluster ab authenticationMode:

  • Auf Clustern, deren authenticationMode ist CONFIG_MAP — Du musst das benutzen aws-auth ConfigMap. Zugriffseinträge werden auf diesen Clustern nicht unterstützt.

  • Auf Clustern, deren authenticationMode ist API_AND_CONFIG_MAP — Die Node-Instance-Rolle kann sich mit einer der folgenden Methoden authentifizieren aws-auth ConfigMap oder einen Zugangseintrag. Wenn die Instanzrolle bereits in der zugeordnet ist ConfigMap, Knoten werden erfolgreich verknüpft, ohne dass ein Zugriffseintrag für die Rolle erstellt wird.

  • Auf Clustern, deren authenticationMode ist API — Sie müssen einen Zugriffseintrag für die Node-Instance-Rolle erstellen. • Der aws-auth ConfigMap wird nicht für die Authentifizierung auf diesen Clustern verwendet.

Um einen Zugriffseintrag für die Node-Instance-Rolle zu erstellen, verwenden Sie den AWS CLI:

$ aws eks create-access-entry \ --cluster-name my-cluster \ --principal-arn arn:aws:iam::123456789012:role/my-node-instance-role \ --type EC2_LINUX

Weitere Informationen finden Sie unter Zugriffseinträge erstellen in der Amazon EKS-Benutzerhandbuch.

Wichtig

Ohne den richtigen Clusterzugriff für die Node-Instance-Rolle können EC2-Instances dem Cluster nicht beitreten. Die Jobs verbleiben im RUNNABLE Status, weil keine Kapazität im Cluster registriert ist.

Wählen Sie zwischen aws-auth ConfigMap und auf Einträge zugreifen

Die Authentifizierung von Zugangseinträgen ist der empfohlene Pfad für neue AWS Batch in Amazon EKS-Rechenumgebungen, und es bietet die folgenden Vorteile:

  • Beseitigt die Notwendigkeit, das manuell zu bearbeiten aws-auth ConfigMap zu gewähren AWS Batch Zugriff auf den Cluster.

  • Bietet eine überprüfbare, API-driven Aufzeichnung der Principals, die Zugriff auf den Cluster haben.

  • Ist für Cluster erforderlich, deren authenticationMode ist API, die das nicht unterstützen aws-auth ConfigMap.

Wenn Ihr Cluster authenticationMode ist CONFIG_MAP, Zugangseinträge sind nicht verfügbar und AWS Batch authentifiziert sich über die aws-auth ConfigMap. Detaillierte Anweisungen finden Sie unter Stellen Sie sicher, dass die aws-auth ConfigMap ist korrekt konfiguriert.