

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](https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html). 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`](#eks-access-entries-matrix).

## Valori per `accessoEntry.desiredState`
<a name="eks-access-entries-desired-state"></a>

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](#eks-access-entries-reconciliation) 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](#eks-access-entries-reconciliation) 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](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeComputeEnvironments.html) 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 `desiredState`o 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](batch_eks_invalid_compute_environment.md#batch_eks_access_entry_incomplete).

**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`
<a name="eks-access-entries-matrix"></a>

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`.


<table>
<thead>
  <tr><th>Grappolo <code>authenticationMode</code></th><th>Ambiente di elaborazione <code>accessEntry.desiredState=ENABLED</code></th><th>Ambiente di elaborazione <code>accessEntry.desiredState=DISABLED</code></th><th>Ambiente di elaborazione <code>accessEntry.desiredState=INHERIT_FROM_CLUSTER</code></th></tr>
</thead>
<tbody>
  <tr><td><code>CONFIG_MAP</code></td><td colspan="3">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 <code>CreateComputeEnvironment</code> o <code>UpdateComputeEnvironment</code> chiamata che specifica <code>desiredState</code>.</td></tr>
  <tr><td><code>API_AND_CONFIG_MAP</code></td><td colspan="2">AWS Batch confronta i valori registrati negli ambienti di elaborazione che condividono il cluster: vedi <a href="#eks-access-entries-reconciliation">In che modo AWS Batch riconcilia `Stato desiderato` in tutti gli ambienti di elaborazione</a>.</td><td>La modalità di accesso esistente viene mantenuta. AWS Batch non aggiunge o rimuove una voce di accesso.</td></tr>
  <tr><td><code>API</code></td><td>La voce di accesso viene creata e gestita nel cluster.</td><td>La richiesta viene respinta. Un cluster in questa modalità non supporta <code>aws-auth</code> ConfigMape il ConfigMap il metodo non può essere abilitato dopo la creazione del cluster, quindi <code>DISABLED</code> lascerebbe l'ambiente di calcolo senza alcun modo di autenticarsi.</td><td>La voce di accesso viene creata e gestita nel cluster. Quando il cluster è <code>API</code>-only, ereditare equivale a <code>ENABLED</code>.</td></tr>
</tbody>
</table>


## In che modo AWS Batch riconcilia `Stato desiderato` in tutti gli ambienti di elaborazione
<a name="eks-access-entries-reconciliation"></a>

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_CLUSTER`e 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
<a name="eks-access-entries-what-batch-creates"></a>

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](#eks-access-entries-additional-configuration).

## Autorizzazioni richieste
<a name="eks-access-entries-permissions"></a>

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
<a name="eks-access-entries-configure"></a>

È possibile configurare la voce di accesso in un ambiente di calcolo tramite `eksConfiguration.accessEntry` campo del [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html) o [UpdateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html) API.

------
#### [ AWS CLI ]

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

```sh
$ 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**

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

**Controlla lo stato**

```sh
$ 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`:

```JSON
{
    "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`](#eks-access-entries-matrix): `DISABLED` viene rifiutato in un cluster la cui modalità di autenticazione è `API`e 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](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html) o [UpdateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html) richiesta.

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

Includere `accessEntry` nel corpo della richiesta:

```JSON
{
    "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**

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

Per ulteriori informazioni, vedere [`EksAccessEntry`](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksAccessEntry.html), [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html), e [UpdateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html) nel *AWS Batch Riferimento API*.

------

## Configurazione del cluster che devi comunque fornire
<a name="eks-access-entries-additional-configuration"></a>

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:

  ```sh
  $ 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](getting-started-eks-configmap.md#getting-started-eks-configmap-step-1). 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:  

```sh
$ 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](https://docs.aws.amazon.com/eks/latest/userguide/creating-access-entries.html) nel **Guida per l'utente di Amazon EKS**.  
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
<a name="eks-access-entries-choosing"></a>

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](verify-configmap-config.md).