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
desiredStatezuENABLED(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
desiredStatezuDISABLED(siehe Wie AWS Batch versöhnt Gewünschter Zustand in allen Computerumgebungen für Einzelheiten). Der Zugriff auf den Cluster muss über den konfiguriert werdenaws-authConfigMap. INHERIT_FROM_CLUSTER-
AWS Batch bezieht sich auf den aktuellen Zugriffseintrag des Clusters
status. Auf einem Amazon EKS-Cluster, dessen Authentifizierungsmodus lautetAPI, AWS Batch erstellt und verwaltet einen Zugriffseintrag, da der Cluster keinen hataws-authConfigMap um darauf zurückgreifen zu können. Auf einem Cluster, dessen Authentifizierungsmodus lautetCONFIG_MAPoderAPI_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.
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.
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 |
Umgebung berechnen |
Umgebung berechnen |
Umgebung berechnen |
|---|---|---|---|
|
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 |
||
|
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. |
|
|
Der Zugriffseintrag wird auf dem Cluster erstellt und verwaltet. |
Die Anforderung wurde abgelehnt. Ein Cluster in diesem Modus unterstützt nicht |
Der Zugriffseintrag wird auf dem Cluster erstellt und verwaltet. Wenn der Cluster |
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
desiredStateDie 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, undINHERIT_FROM_CLUSTER, und es schließt auch jede Computerumgebung ein, die keinedesiredStateaufgezeichnet.
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.
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.
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.
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 festlegstdesiredState=ENABLEDin allen Computerumgebungen, die auf einen Cluster abzielen, AWS Batch erstellt einen Zugriffseintrag auf Cluster-EbeneAWSBatchClusterPolicy. Sie müssen dann den Namespace-Bereich zuordnenAWSBatchNamespacePolicygewä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-namemy-cluster\ --principal-arnarn: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-namespaceErsetzen
my-aws-batch-namespacemit dem Wert, den Sie angegeben habeneksConfiguration.kubernetesNamespace.WichtigOhne die politische Assoziation, die sich auf den Namespace-Bereich bezieht, bleiben Arbeitsplätze hängen
RUNNABLEStatus. 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.AnmerkungWenn 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
VALIDwä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
authenticationModeistCONFIG_MAP— Du musst das benutzenaws-authConfigMap. Zugriffseinträge werden auf diesen Clustern nicht unterstützt. -
Auf Clustern, deren
authenticationModeistAPI_AND_CONFIG_MAP— Die Node-Instance-Rolle kann sich mit einer der folgenden Methoden authentifizierenaws-authConfigMap 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
authenticationModeistAPI— Sie müssen einen Zugriffseintrag für die Node-Instance-Rolle erstellen. • Deraws-authConfigMap 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-namemy-cluster\ --principal-arnarn:aws:iam::123456789012:role/my-node-instance-role\ --type EC2_LINUXWeitere Informationen finden Sie unter Zugriffseinträge erstellen in der Amazon EKS-Benutzerhandbuch.
WichtigOhne den richtigen Clusterzugriff für die Node-Instance-Rolle können EC2-Instances dem Cluster nicht beitreten. Die Jobs verbleiben im
RUNNABLEStatus, 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-authConfigMap 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
authenticationModeistAPI, die das nicht unterstützenaws-authConfigMap.
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.