

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

# Authentification des entrées d'accès Amazon EKS

Amazon EKS prend en charge deux mécanismes pour accorder à un IAM principal l'autorisation d'appeler le cluster Kubernetes API : l'héritage `aws-auth` ConfigMap et le plus récent [API d'entrée d'accès](https://docs.aws.amazon.com/eks/latest/userguide/access-entries.html). Une entrée d'accès accorde Kubernetes Accès par API à un principal IAM sans que vous ayez à modifier un ConfigMap. AWS Batch peut s'authentifier auprès de votre cluster via l'un ou l'autre des mécanismes.

Lorsque vous définissez `eksConfiguration.accessEntry.desiredState` pour `ENABLED` dans un environnement informatique, AWS Batch peut gérer l'entrée d'accès pour cet environnement informatique sur le cluster. Vous n'avez plus besoin de modifier manuellement le `aws-auth` ConfigMap.

Que ce soit AWS Batch les dispositions et l'entrée d'accès dépendent de votre AWS Batch environnement informatique et configuration de votre cluster Amazon EKS. Consultez [Interaction avec le cluster `Mode d'authentification`](#eks-access-entries-matrix) pour plus de détails.

## Valeurs pour `accèsEntry.desiredState`
<a name="eks-access-entries-desired-state"></a>

Le `desiredState` champ sur `EksAccessEntry` déclare l'état d'entrée d'accès souhaité pour l'environnement informatique. Les valeurs valides sont :

`ENABLED`  
AWS Batch crée un AWS Batch-entrée d'accès gérée sur le cluster pour l'environnement informatique. AWS Batch créera uniquement un AWS Batch-entrée d'accès gérée si tous les environnements de calcul du cluster sont définis `desiredState` pour `ENABLED` (voir [Comment ? AWS Batch réconcilie `État souhaité` dans tous les environnements informatiques](#eks-access-entries-reconciliation) pour plus de détails).

`DISABLED`  
AWS Batch supprime le AWS Batch-entrée d'accès gérée pour le cluster. AWS Batch supprimera uniquement un AWS Batch-entrée d'accès gérée si tous les environnements de calcul du cluster sont définis `desiredState` pour `DISABLED` (voir [Comment ? AWS Batch réconcilie `État souhaité` dans tous les environnements informatiques](#eks-access-entries-reconciliation) pour plus de détails). L'accès au cluster doit être configuré via `aws-auth` ConfigMap.

`INHERIT_FROM_CLUSTER`  
AWS Batch s'en remet à l'entrée d'accès actuelle du cluster `status`. Sur un cluster Amazon EKS dont le mode d'authentification est `API`, AWS Batch crée et gère une entrée d'accès car le cluster ne possède aucun `aws-auth` ConfigMap vers laquelle se rabattre. Sur un cluster dont le mode d'authentification est `CONFIG_MAP` ou `API_AND_CONFIG_MAP`, AWS Batch n'ajoute ni ne supprime aucune entrée d'accès.

L'environnement informatique propose également un accès en lecture seule `accessEntry.status` champ dans [DescribeComputeEnvironments](https://docs.aws.amazon.com/batch/latest/APIReference/API_DescribeComputeEnvironments.html) réponses. `ACTIVE` signifie qu'un AWS Batch-une entrée d'accès gérée pour l'environnement informatique existe sur le cluster et a priorité sur `aws-auth` ConfigMap. `INACTIVE` signifie que non AWS Batch-une entrée d'accès gérée est présente. Cela peut être dû au fait que `desiredState` est `DISABLED`, car les environnements de calcul ciblant le cluster ne sont pas encore d'accord sur `desiredState`, ou parce que l'entrée n'a pas encore été provisionnée. Si `accessEntry.status` est `INACTIVE`, Utilisations par lots `aws-auth` ConfigMap pour accéder au cluster.

**Note**  
Une entrée d'accès aux rapports `ACTIVE` dès qu'il existe sur le cluster, même si AWS Batch n'a pas fini d'associer la politique d'accès qui le rend utilisable. Si l'état de l'environnement de calcul passe à `INVALID` tandis que `accessEntry.status` est `ACTIVE`, voir [La configuration des entrées d'accès Amazon EKS est incomplète](batch_eks_invalid_compute_environment.md#batch_eks_access_entry_incomplete).

**Note**  
Si vous omettez le `accessEntry` terrain, AWS Batch n'enregistre pas de `desiredState` pour l'environnement informatique, et `DescribeComputeEnvironments` n'en renvoie aucun. Aux fins du provisionnement de l'entrée d'accès, AWS Batch se comporte comme il le fait pour `INHERIT_FROM_CLUSTER`.

## Interaction avec le cluster `Mode d'authentification`
<a name="eks-access-entries-matrix"></a>

Comment AWS Batch se comporte pour une donnée `desiredState` dépend du mode d'authentification du cluster. Le tableau suivant s'applique à la fois `CreateComputeEnvironment` et `UpdateComputeEnvironment`.


<table>
<thead>
  <tr><th>Cluster <code>authenticationMode</code></th><th>Environnement informatique <code>accessEntry.desiredState=ENABLED</code></th><th>Environnement informatique <code>accessEntry.desiredState=DISABLED</code></th><th>Environnement informatique <code>accessEntry.desiredState=INHERIT_FROM_CLUSTER</code></th></tr>
</thead>
<tbody>
  <tr><td><code>CONFIG_MAP</code></td><td colspan="3">Les entrées d'accès ne sont pas disponibles sur le cluster, donc AWS Batch n'en crée ni n'en supprime aucun. AWS Batch enregistre toujours la valeur que vous spécifiez. Une fois que vous avez modifié le mode d'authentification du cluster, cette valeur enregistrée prend effet lors de votre prochaine <code>CreateComputeEnvironment</code> ou <code>UpdateComputeEnvironment</code> appel qui spécifie <code>desiredState</code>.</td></tr>
  <tr><td><code>API_AND_CONFIG_MAP</code></td><td colspan="2">AWS Batch compare les valeurs enregistrées dans les environnements informatiques qui partagent le cluster — voir <a href="#eks-access-entries-reconciliation">Comment ? AWS Batch réconcilie `État souhaité` dans tous les environnements informatiques</a>.</td><td>Le mode d'accès existant est conservé. AWS Batch n'ajoute ni ne supprime aucune entrée d'accès.</td></tr>
  <tr><td><code>API</code></td><td>L'entrée d'accès est créée et gérée sur le cluster.</td><td>La demande est rejetée. Dans ce mode, un cluster ne prend pas en charge le <code>aws-auth</code> ConfigMap, et le ConfigMap la méthode ne peut pas être activée après la création du cluster, donc <code>DISABLED</code> laisserait l'environnement informatique sans aucun moyen de s'authentifier.</td><td>L'entrée d'accès est créée et gérée sur le cluster. Lorsque le cluster est <code>API</code>-uniquement, hériter est équivalent à <code>ENABLED</code>.</td></tr>
</tbody>
</table>


## Comment ? AWS Batch réconcilie `État souhaité` dans tous les environnements informatiques
<a name="eks-access-entries-reconciliation"></a>

Parce qu'un seul cluster Amazon EKS peut sauvegarder plusieurs AWS Batch environnements informatiques, la configuration d'accès d'un cluster est une ressource partagée. AWS Batch réconcilie donc, ou compare et résout, les `desiredState` valeurs enregistrées dans ces environnements informatiques.

Lorsque le cluster est `authenticationMode` est `API_AND_CONFIG_MAP`, AWS Batch compare les `desiredState` enregistrés pour chaque environnement informatique du même AWS compte et AWS Région qui cible le cluster. AWS Batch utilise cette comparaison pour déterminer s'il faut ajouter ou supprimer l'entrée d'accès sur chaque `CreateComputeEnvironment` ou `UpdateComputeEnvironment` opération qui spécifie `desiredState`.

Chaque environnement informatique possède `desiredState=ENABLED`  
AWS Batch crée l'entrée d'accès sur le cluster.

Chaque environnement informatique possède `desiredState=DISABLED`  
AWS Batch supprime l'entrée d'accès du cluster, s'il en existe une.

L'enregistré `desiredState` les valeurs ne correspondent pas toutes  
AWS Batch conserve le mode d'accès existant. L'entrée d'accès n'est ni ajoutée ni supprimée. Cela inclut tout mélange de `ENABLED`, `DISABLED`, et `INHERIT_FROM_CLUSTER`, et il inclut également tout environnement de calcul qui n'a pas `desiredState` enregistré.

**Note**  
Pour effectuer la transition d'un cluster dont le mode d'authentification est `API_AND_CONFIG_MAP` à partir de `aws-auth` ConfigMap pour accéder à l'authentification d'entrée, définissez `desiredState=ENABLED` sur chaque AWS Batch environnement informatique qui cible le cluster. Pour revenir en arrière, réglez `desiredState=DISABLED` sur chacun d'entre eux.

## Quoi AWS Batch crée sur votre cluster
<a name="eks-access-entries-what-batch-creates"></a>

AWS Batch crée une entrée d'accès par cluster qui répond aux conditions ci-dessus, puis associe le `AWSBatchClusterPolicy` Politique d'accès Amazon EKS avec cette entrée d'accès. L'entrée d'accès se fait par cluster plutôt que par environnement de calcul, donc tous AWS Batch les environnements informatiques qui ciblent le même cluster le partagent.

**Note**  
La suppression d'un environnement informatique ne supprime pas l'entrée d'accès, même si c'est la dernière AWS Batch environnement de calcul sur le cluster. Pour supprimer un AWS Batch-entrée d'accès gérée, appel `UpdateComputeEnvironment` avec `desiredState=DISABLED` sur chaque AWS Batch environnement de calcul qui cible le cluster avant que vous ne le supprimiez.

Une entrée d'accès ne suffit pas à elle seule pour exécuter des tâches sur le cluster. Pour le Kubernetes autorisations et accès aux nœuds que vous devez configurer vous-même, voir [Configuration de cluster que vous devez toujours fournir](#eks-access-entries-additional-configuration).

## Autorisations requises
<a name="eks-access-entries-permissions"></a>

AWS Batch gère l'entrée d'accès à l'aide des informations d'identification de l'identité IAM qui appelle le `CreateComputeEnvironment` ou `UpdateComputeEnvironment` opération. Cette identité doit être autorisée à effectuer les actions Amazon EKS suivantes :
+ `eks:DescribeCluster`
+ `eks:DescribeAccessEntry`
+ `eks:CreateAccessEntry`
+ `eks:AssociateAccessPolicy`
+ `eks:DeleteAccessEntry`

## Configurer l'entrée d'accès
<a name="eks-access-entries-configure"></a>

Vous pouvez configurer l'entrée d'accès dans un environnement informatique via `eksConfiguration.accessEntry` domaine du [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html) ou [UpdateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html) API.

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

**Activez un AWS Batch-entrée d'accès gérée lors de la création d'un environnement informatique**

```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}}'
```

**Activez un AWS Batch-entrée d'accès gérée sur un environnement informatique existant**

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

**Vérifiez le statut**

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

La réponse inclut à la fois les `desiredState` que vous avez spécifié et observé `status`:

```JSON
{
    "desiredState": "ENABLED",
    "status": "ACTIVE"
}
```

**Note**  
AWS Batch retours `accessEntry.status` pour tous les environnements de calcul Amazon EKS, et retours `desiredState` uniquement si vous l'avez configuré. Un environnement informatique que vous n'avez jamais spécifié `accessEntry` retours `status` seul.

Pour arrêter AWS Batch depuis la gestion de l'entrée d'accès, définissez `desiredState` pour `DISABLED` au lieu de cela. Avant de le faire, passez en revue [Interaction avec le cluster `Mode d'authentification`](#eks-access-entries-matrix): `DISABLED` est rejeté sur un cluster dont le mode d'authentification est `API`, et sur un cluster dont le mode d'authentification est `API_AND_CONFIG_MAP` l'entrée d'accès n'est supprimée qu'après chaque AWS Batch l'environnement de calcul qui cible le cluster est défini sur `DISABLED`.

------
#### [ API ]

Utilisez le `eksConfiguration.accessEntry` objet dans votre [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html) ou [UpdateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html) demande.

**Créez un environnement informatique avec un AWS Batch-entrée d'accès gérée**

Inclure `accessEntry` dans le corps de la demande :

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

**Mettre à jour l'entrée d'accès sur un environnement informatique existant**

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

Pour plus d'informations, voir [`EksAccessEntry`](https://docs.aws.amazon.com/batch/latest/APIReference/API_EksAccessEntry.html), [CreateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_CreateComputeEnvironment.html), et [UpdateComputeEnvironment](https://docs.aws.amazon.com/batch/latest/APIReference/API_UpdateComputeEnvironment.html) dans le *AWS Batch Référence de l'API*.

------

## Configuration de cluster que vous devez toujours fournir
<a name="eks-access-entries-additional-configuration"></a>

Une entrée d'accès ne contrôle que la manière dont AWS Batch s'authentifie auprès de votre cluster. Cela n'accorde pas AWS Batch le Kubernetes autorisations dont il a besoin pour exécuter vos tâches, et il n'autorise pas les instances qui AWS Batch les lancements rejoignent le cluster. Quel que soit le mécanisme d'authentification que vous utilisez, vous devez toujours configurer les deux options suivantes.

**Important**  
Une fois AWS Batch-une entrée d'accès gérée est créée pour AWS Batch rôle lié à un service sur un cluster (`accessEntry.status=ACTIVE`), il a priorité sur le `aws-auth` ConfigMap configuration du rôle. Le ConfigMap entrées pour le AWS Batch les rôles liés à un service ne sont pas utilisés, et AWS Batch s'authentifie à l'aide de l'entrée d'accès à la place. Pour revenir à ConfigMap authentification, paramétrage `desiredState=DISABLED` sur tous les environnements de calcul qui ciblent le cluster. Cela supprime le AWS Batch-entrée d'accès gérée.

Kubernetes autorisations pour AWS Batch espace de noms  
AWS Batch besoins Kubernetes autorisations pour créer et gérer des pods dans l'espace de noms que vous spécifiez dans `eksConfiguration.kubernetesNamespace`. Créez l'espace de noms, puis configurez ces autorisations à l'aide de l'une des méthodes suivantes en fonction de votre approche d'authentification :  
+ **Association de règles d'accès (obligatoire lors de la saisie de l'accès) `status=ACTIVE`)** — Lorsque vous configurez `desiredState=ENABLED` sur tous les environnements de calcul ciblant un cluster, AWS Batch crée une entrée d'accès au niveau du cluster `AWSBatchClusterPolicy`. Vous devez ensuite associer le namespace-scoped `AWSBatchNamespacePolicy` accorder AWS Batch autorisation de créer et de gérer des pods.

  Une fois l'entrée d'accès atteinte `status=ACTIVE`, associez la politique d'espace de noms à l'aide du 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}}
  ```

  Remplacer {{my-aws-batch-namespace}} avec la valeur que vous avez spécifiée dans `eksConfiguration.kubernetesNamespace`.
**Important**  
Sans l'association de politiques à l'échelle de l'espace de noms, les emplois resteront bloqués `RUNNABLE` statut. La politique au niveau du cluster à elle seule n'accorde pas d'autorisations de gestion des pods.
+ **Kubernetes rôles et liaisons de rôles (lors de l'accès à l'entrée) `status=INACTIVE`)** — Si le AWS Batch-l'entrée d'accès gérée n'est pas active, créez le Kubernetes les rôles et les liaisons de rôles qui accordent ces autorisations, comme décrit dans [Étape 2 : Préparez votre cluster Amazon EKS pour AWS Batch](getting-started-eks-configmap.md#getting-started-eks-configmap-step-1). Vous effectuez cette opération une fois pour chaque cluster.
**Note**  
Quand un AWS Batch-l'entrée d'accès gérée est active (`status=ACTIVE`), le Kubernetes Les rôles RBAC sont contournés. Vous devez plutôt utiliser la méthode d'association de politiques d'accès.
AWS Batch ne crée pas ces ressources pour vous, et un AWS Batch-une entrée d'accès gérée ne les remplace pas. S'ils sont absents, l'environnement informatique peut toujours devenir `VALID` alors que vos tâches ne démarrent pas.

Accès au cluster pour le rôle d'instance de nœud  
Instances qui AWS Batch les lancements rejoignent le cluster à l'aide du profil d'instance que vous spécifiez dans `computeResources.instanceRole`. Ce rôle a besoin de son propre accès au cluster, qui est distinct du AWS Batch-entrée d'accès gérée et qui AWS Batch ne configure pas.  
La méthode de configuration dépend de votre cluster `authenticationMode`:  
+ **Sur les clusters dont `authenticationMode` est `CONFIG_MAP`** — Vous devez utiliser le `aws-auth` ConfigMap. Les entrées d'accès ne sont pas prises en charge sur ces clusters.
+ **Sur les clusters dont `authenticationMode` est `API_AND_CONFIG_MAP`** — Le rôle d'instance de nœud peut s'authentifier à l'aide de `aws-auth` ConfigMap ou une entrée d'accès. Si le rôle d'instance est déjà mappé dans le ConfigMap, les nœuds se joindront avec succès sans créer d'entrée d'accès pour le rôle.
+ **Sur les clusters dont `authenticationMode` est `API`** — Vous devez créer une entrée d'accès pour le rôle d'instance de nœud. Le `aws-auth` ConfigMap n'est pas utilisé pour l'authentification sur ces clusters.
Pour créer une entrée d'accès pour le rôle d'instance de nœud, utilisez 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
```
Pour plus d'informations, voir [Création d'entrées d'accès](https://docs.aws.amazon.com/eks/latest/userguide/creating-access-entries.html) dans le **Guide de l'utilisateur d'Amazon EKS**.  
Sans accès approprié au cluster pour le rôle d'instance de nœud, les instances EC2 ne peuvent pas rejoindre le cluster. Les emplois seront maintenus dans `RUNNABLE` état car aucune capacité n'est enregistrée auprès du cluster.

## Choisir entre les `aws-auth` ConfigMap et accès aux entrées
<a name="eks-access-entries-choosing"></a>

L'authentification des entrées d'accès est le chemin recommandé pour les nouveaux AWS Batch sur les environnements de calcul Amazon EKS, et il offre les avantages suivants :
+ Élimine le besoin de modifier manuellement le `aws-auth` ConfigMap accorder AWS Batch accès au cluster.
+ Fournit un audit, API-driven enregistrement des principaux utilisateurs ayant accès au cluster.
+ Est obligatoire pour les clusters dont `authenticationMode` est `API`, qui ne prennent pas en charge le `aws-auth` ConfigMap.

Si votre cluster est `authenticationMode` est `CONFIG_MAP`, les entrées d'accès ne sont pas disponibles et AWS Batch s'authentifie par le biais du `aws-auth` ConfigMap. Pour obtenir des instructions, consultez [Vérifiez que `aws-auth ConfigMap` est correctement configuré](verify-configmap-config.md).