View a markdown version of this page

Autenticazione degli accessi ad Amazon EKS - AWS Batch

Le traduzioni sono generate tramite traduzione automatica. In caso di conflitto tra il contenuto di una traduzione e la versione originale in Inglese, quest'ultima prevarrà.

Autenticazione degli accessi ad Amazon EKS

Amazon EKS supporta due meccanismi per concedere a un principale IAM l'autorizzazione a chiamare i cluster Kubernetes API: l'eredità aws-auth ConfigMap e il più recente API di accesso. Un ingresso garantisce Kubernetes Accesso tramite API a un responsabile IAM senza la necessità di modificare un ConfigMap. AWS Batch può autenticarsi nel cluster tramite entrambi i meccanismi.

Quando imposti eksConfiguration.accessEntry.desiredState a ENABLED in un ambiente informatico, AWS Batch può gestire la voce di accesso per quell'ambiente di calcolo sul cluster. Non è più necessario modificare manualmente aws-auth ConfigMap.

Se AWS Batch le disposizioni e la voce di accesso dipendono dal tuo AWS Batch ambiente di elaborazione e configurazione del cluster Amazon EKS. Per informazioni dettagliate, vedi Interazione con il cluster Modalità di autenticazione.

Valori per accessoEntry.desiredState

Le desiredState campo su EksAccessEntry dichiara lo stato di accesso desiderato per l'ambiente di calcolo. I valori validi sono:

ENABLED

AWS Batch crea un AWS Batch-voce di accesso gestita sul cluster per l'ambiente di elaborazione. AWS Batch creerà solo un AWS Batch-accesso gestito se tutti gli ambienti di calcolo del cluster sono impostati desiredState a ENABLED (vedi In che modo AWS Batch riconcilia Stato desiderato in tutti gli ambienti di elaborazione per i dettagli).

DISABLED

AWS Batch elimina il AWS Batch-voce di accesso gestita per il cluster. AWS Batch eliminerà solo un AWS Batch-accesso gestito se tutti gli ambienti di elaborazione del cluster sono impostati desiredState a DISABLED (vedi In che modo AWS Batch riconcilia Stato desiderato in tutti gli ambienti di elaborazione per i dettagli). L'accesso al cluster deve essere configurato tramite aws-auth ConfigMap.

INHERIT_FROM_CLUSTER

AWS Batch rimanda alla voce di accesso corrente del cluster status. In un cluster Amazon EKS la cui modalità di autenticazione è API, AWS Batch crea e gestisce una voce di accesso perché il cluster non ha aws-auth ConfigMap a cui ricorrere. In un cluster la cui modalità di autenticazione è CONFIG_MAP o API_AND_CONFIG_MAP, AWS Batch non aggiunge né rimuove una voce di accesso.

L'ambiente di elaborazione espone anche una modalità di sola lettura accessEntry.status campo in DescribeComputeEnvironments risposte. ACTIVE significa che un AWS Batch-la voce di accesso gestito per l'ambiente di calcolo esiste nel cluster e ha la precedenza su aws-auth ConfigMap. INACTIVE significa che no AWS Batch-è presente una voce di accesso gestito. Questo può essere perché desiredState è DISABLED, perché gli ambienti di calcolo destinati al cluster non sono ancora d'accordo desiredStateo perché la voce non è ancora stata effettuata il provisioning. Se accessEntry.status è INACTIVE, Batch utilizza aws-auth ConfigMap per l'accesso al cluster.

Nota

Una voce di accesso ai report ACTIVE non appena esiste nel cluster, anche se AWS Batch non ha terminato l'associazione della policy di accesso che lo rende utilizzabile. Se lo stato dell'ambiente di calcolo cambia in INVALID mentre accessEntry.status è ACTIVE, vedi La configurazione della voce di accesso di Amazon EKS è incompleta.

Nota

Se si omette il accessEntry campo, AWS Batch non registra un desiredState per l'ambiente di elaborazione e DescribeComputeEnvironments non ne restituisce uno. Ai fini della fornitura della voce di accesso, AWS Batch si comporta come per INHERIT_FROM_CLUSTER.

Interazione con il cluster Modalità di autenticazione

Come AWS Batch si comporta per un dato desiredState dipende dalla modalità di autenticazione del cluster. La tabella seguente si applica a entrambi CreateComputeEnvironment e UpdateComputeEnvironment.

Grappolo authenticationMode

Ambiente di elaborazione accessEntry.desiredState=ENABLED

Ambiente di elaborazione accessEntry.desiredState=DISABLED

Ambiente di elaborazione accessEntry.desiredState=INHERIT_FROM_CLUSTER

CONFIG_MAP

Le voci di accesso non sono disponibili nel cluster, quindi AWS Batch non ne crea né ne rimuove uno. AWS Batch registra ancora il valore specificato. Dopo aver modificato la modalità di autenticazione del cluster, il valore registrato ha effetto alla successiva CreateComputeEnvironment o UpdateComputeEnvironment chiamata che specifica desiredState.

API_AND_CONFIG_MAP

AWS Batch confronta i valori registrati negli ambienti di elaborazione che condividono il cluster: vedi In che modo AWS Batch riconcilia Stato desiderato in tutti gli ambienti di elaborazione.

La modalità di accesso esistente viene mantenuta. AWS Batch non aggiunge o rimuove una voce di accesso.

API

La voce di accesso viene creata e gestita nel cluster.

La richiesta viene respinta. Un cluster in questa modalità non supporta aws-auth ConfigMape il ConfigMap il metodo non può essere abilitato dopo la creazione del cluster, quindi DISABLED lascerebbe l'ambiente di calcolo senza alcun modo di autenticarsi.

La voce di accesso viene creata e gestita nel cluster. Quando il cluster è API-only, ereditare equivale a ENABLED.

In che modo AWS Batch riconcilia Stato desiderato in tutti gli ambienti di elaborazione

Perché un singolo cluster Amazon EKS può eseguire il backup di più cluster AWS Batch in ambienti di calcolo, la configurazione di accesso di un cluster è una risorsa condivisa. AWS Batch pertanto riconcilia, o confronta e risolve, il desiredState valori registrati in tali ambienti di elaborazione.

Quando il cluster è authenticationMode è API_AND_CONFIG_MAP, AWS Batch confronta il desiredState registrato per ogni ambiente di elaborazione nello stesso AWS account e AWS Regione destinata al cluster. AWS Batch utilizza questo confronto per determinare se aggiungere o rimuovere la voce di accesso su ciascuna CreateComputeEnvironment o UpdateComputeEnvironment operazione che specifica desiredState.

Ogni ambiente di elaborazione ha desiredState=ENABLED

AWS Batch crea la voce di accesso sul cluster.

Ogni ambiente di elaborazione ha desiredState=DISABLED

AWS Batch elimina la voce di accesso dal cluster, se ne esiste una.

La registrata desiredState i valori non coincidono tutti

AWS Batch mantiene la modalità di accesso esistente. La voce di accesso non viene né aggiunta né rimossa. Ciò include qualsiasi combinazione di ENABLED, DISABLED, e INHERIT_FROM_CLUSTERe include anche qualsiasi ambiente di elaborazione che non abbia desiredState registrato.

Nota

Per effettuare la transizione di un cluster la cui modalità di autenticazione è API_AND_CONFIG_MAP da aws-auth ConfigMap per accedere all'autenticazione delle entrate, imposta desiredState=ENABLED su ogni AWS Batch ambiente di calcolo destinato al cluster. Per tornare indietro, imposta desiredState=DISABLED su ognuno di essi.

What AWS Batch crea sul tuo cluster

AWS Batch crea una voce di accesso per cluster che soddisfa le condizioni precedenti, quindi associa AWSBatchClusterPolicy politica di accesso di Amazon EKS con tale voce di accesso. L'accesso è per cluster anziché per ambiente di elaborazione, quindi tutto AWS Batch gli ambienti di calcolo che hanno come target lo stesso cluster la condividono.

Nota

L'eliminazione di un ambiente di calcolo non rimuove la voce di accesso, anche se è l'ultima AWS Batch ambiente di calcolo sul cluster. Per rimuovere un AWS Batch-accesso gestito, chiama UpdateComputeEnvironment con desiredState=DISABLED su ogni AWS Batch ambiente di calcolo destinato al cluster prima di eliminarli.

Una voce di accesso non è sufficiente da sola per eseguire processi sul cluster. Per Kubernetes le autorizzazioni e l'accesso ai nodi che devi configurare tu stesso, vedi Configurazione del cluster che devi comunque fornire.

Autorizzazioni richieste

AWS Batch gestisce l'accesso utilizzando le credenziali dell'identità IAM che chiama il CreateComputeEnvironment o UpdateComputeEnvironment operazione. Tale identità deve essere autorizzata a eseguire le seguenti azioni Amazon EKS:

  • eks:DescribeCluster

  • eks:DescribeAccessEntry

  • eks:CreateAccessEntry

  • eks:AssociateAccessPolicy

  • eks:DeleteAccessEntry

Configura la voce di accesso

È possibile configurare la voce di accesso in un ambiente di calcolo tramite eksConfiguration.accessEntry campo del CreateComputeEnvironment o UpdateComputeEnvironment API.

AWS CLI

Abilita un AWS Batch-accesso gestito durante la creazione di un ambiente di elaborazione

$ 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'

Abilita un AWS Batch-accesso gestito su un ambiente di elaborazione esistente

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

Controlla lo stato

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

La risposta include sia desiredState che hai specificato e osservato status:

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

AWS Batch restituisce accessEntry.status per tutti gli ambienti di elaborazione Amazon EKS e resi desiredState solo se l'hai impostato. Un ambiente di calcolo in cui non è mai stato specificato accessEntry restituisce status da solo.

Fermarsi AWS Batch dalla gestione della voce di accesso, imposta desiredState a DISABLED invece. Prima di farlo, rivedi Interazione con il cluster Modalità di autenticazione: DISABLED viene rifiutato in un cluster la cui modalità di autenticazione è APIe su un cluster la cui modalità di autenticazione è API_AND_CONFIG_MAP la voce di accesso viene rimossa solo dopo ogni AWS Batch l'ambiente di calcolo destinato al cluster è impostato su DISABLED.

API

Usa il eksConfiguration.accessEntry oggetto nel tuo CreateComputeEnvironment o UpdateComputeEnvironment richiesta.

Crea un ambiente di elaborazione con un AWS Batch-ingresso di accesso gestito

Includere accessEntry nel corpo della richiesta:

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

Aggiornare la voce di accesso in un ambiente di elaborazione esistente

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

Per ulteriori informazioni, vedere EksAccessEntry, CreateComputeEnvironment, e UpdateComputeEnvironment nel AWS Batch Riferimento API.

Configurazione del cluster che devi comunque fornire

Una voce di accesso controlla solo in che modo AWS Batch si autentica nel tuo cluster. Non concede AWS Batch lo Kubernetes le autorizzazioni di cui ha bisogno per eseguire i tuoi lavori e non le consente alle istanze AWS Batch i lanci si uniscono al cluster. Indipendentemente dal meccanismo di autenticazione utilizzato, è comunque necessario configurare entrambi i seguenti elementi.

Importante

Una volta AWS Batch-viene creata una voce di accesso gestito per AWS Batch ruolo collegato al servizio in un cluster (accessEntry.status=ACTIVE), ha la precedenza su aws-auth ConfigMap configurazione per il ruolo. La ConfigMap iscrizioni per il AWS Batch il ruolo collegato al servizio non è utilizzato e AWS Batch si autentica utilizzando invece la voce di accesso. Per tornare a ConfigMap autenticazione, impostata desiredState=DISABLED su tutti gli ambienti di elaborazione destinati al cluster. Questo rimuove il AWS Batch-ingresso di accesso gestito.

Kubernetes autorizzazioni per AWS Batch namespace

AWS Batch necessità Kubernetes autorizzazioni per creare e gestire i pod nello spazio dei nomi specificato in eksConfiguration.kubernetesNamespace. Crea il namespace, quindi configura tali autorizzazioni utilizzando uno dei seguenti metodi a seconda del tuo approccio di autenticazione:

  • Associazione ai criteri di accesso (richiesta al momento dell'accesso) status=ACTIVE) — Quando imposti desiredState=ENABLED su tutti gli ambienti di elaborazione destinati a un cluster, AWS Batch crea una voce di accesso a livello di cluster AWSBatchClusterPolicy. È quindi necessario associare il namespace-scoped AWSBatchNamespacePolicy concedere AWS Batch il permesso di creare e gestire i pod.

    Una volta raggiunto l'accesso status=ACTIVE, associa la politica dello spazio dei nomi utilizzando il 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

    Sostituire my-aws-batch-namespace con il valore specificato in eksConfiguration.kubernetesNamespace.

    Importante

    Senza l'associazione politica denominata namespace-scoped, i posti di lavoro rimarranno bloccati RUNNABLE stato. La politica a livello di cluster da sola non concede autorizzazioni di gestione dei pod.

  • Kubernetes ruoli e associazioni di ruolo (quando si accede) status=INACTIVE) — Se AWS Batch-la voce di accesso gestito non è attiva, crea Kubernetes ruoli e associazioni di ruolo che concedono tali autorizzazioni, come descritto in Fase 2: Prepara il tuo cluster Amazon EKS per AWS Batch. Questa operazione viene eseguita una volta per ogni cluster.

    Nota

    Quando un AWS Batch-la voce di accesso gestito è attiva (status=ACTIVE), il Kubernetes I ruoli RBAC vengono ignorati. È invece necessario utilizzare il metodo di associazione dei criteri di accesso.

AWS Batch non crea queste risorse per te e un AWS Batch-la voce di accesso gestito non le sostituisce. Se mancano, l'ambiente di elaborazione può comunque diventare VALID mentre i tuoi lavori non iniziano.

Accesso al cluster per il ruolo di istanza del nodo

Istanze che AWS Batch le avviate si uniscono al cluster utilizzando il profilo di istanza specificato in computeResources.instanceRole. Tale ruolo necessita di un proprio accesso al cluster, che è separato dal AWS Batch-ingresso di accesso gestito e quale AWS Batch non si configura.

Il metodo di configurazione dipende dal cluster authenticationMode:

  • Su cluster di cui authenticationMode è CONFIG_MAP — È necessario utilizzare il aws-auth ConfigMap. Le voci di accesso non sono supportate in questi cluster.

  • Sui cluster di cui authenticationMode è API_AND_CONFIG_MAP — Il ruolo dell'istanza del nodo può autenticarsi utilizzando aws-auth ConfigMap o una voce di accesso. Se il ruolo dell'istanza è già mappato nel ConfigMap, i nodi si uniranno correttamente senza creare una voce di accesso per il ruolo.

  • Sui cluster di cui authenticationMode è API — È necessario creare una voce di accesso per il ruolo dell'istanza del nodo. Il aws-auth ConfigMap non viene utilizzato per l'autenticazione su questi cluster.

Per creare una voce di accesso per il ruolo di istanza del nodo, usa 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

Per ulteriori informazioni, vedere Creazione di voci di accesso nel Guida per l'utente di Amazon EKS.

Importante

Senza un accesso adeguato al cluster per il ruolo di istanza del nodo, le istanze EC2 non possono entrare a far parte del cluster. I lavori rimarranno in RUNNABLE stato perché nessuna capacità viene registrata nel cluster.

Scegliere tra aws-auth ConfigMap e accedi alle voci

L'autenticazione degli accessi è il percorso consigliato per le nuove AWS Batch su ambienti di elaborazione Amazon EKS e offre i seguenti vantaggi:

  • Elimina la necessità di modificare manualmente il aws-auth ConfigMap concedere AWS Batch accesso al cluster.

  • Fornisce un documento verificabile, API-driven registrazione dei principali che hanno accesso al cluster.

  • È richiesto per i cluster i cui authenticationMode è API, che non supportano il aws-auth ConfigMap.

Se il tuo cluster è authenticationMode è CONFIG_MAP, le voci di accesso non sono disponibili e AWS Batch si autentica tramite aws-auth ConfigMap. Per istruzioni, consulta Verificare che il aws-auth ConfigMap è configurato correttamente.