View a markdown version of this page

Authentification des entrées d'accès Amazon EKS - AWS Batch

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. 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 pour plus de détails.

Valeurs pour accèsEntry.desiredState

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

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

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.

Cluster authenticationMode

Environnement informatique accessEntry.desiredState=ENABLED

Environnement informatique accessEntry.desiredState=DISABLED

Environnement informatique accessEntry.desiredState=INHERIT_FROM_CLUSTER

CONFIG_MAP

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 CreateComputeEnvironment ou UpdateComputeEnvironment appel qui spécifie desiredState.

API_AND_CONFIG_MAP

AWS Batch compare les valeurs enregistrées dans les environnements informatiques qui partagent le cluster — voir Comment ? AWS Batch réconcilie État souhaité dans tous les environnements informatiques.

Le mode d'accès existant est conservé. AWS Batch n'ajoute ni ne supprime aucune entrée d'accès.

API

L'entrée d'accès est créée et gérée sur le cluster.

La demande est rejetée. Dans ce mode, un cluster ne prend pas en charge le aws-auth ConfigMap, et le ConfigMap la méthode ne peut pas être activée après la création du cluster, donc DISABLED laisserait l'environnement informatique sans aucun moyen de s'authentifier.

L'entrée d'accès est créée et gérée sur le cluster. Lorsque le cluster est API-uniquement, hériter est équivalent à ENABLED.

Comment ? AWS Batch réconcilie État souhaité dans tous les environnements informatiques

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

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.

Autorisations requises

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

Vous pouvez configurer l'entrée d'accès dans un environnement informatique via eksConfiguration.accessEntry domaine du CreateComputeEnvironment ou UpdateComputeEnvironment API.

AWS CLI

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

$ 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

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

Vérifiez le statut

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

{ "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: 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 ou UpdateComputeEnvironment 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 :

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

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

Pour plus d'informations, voir EksAccessEntry, CreateComputeEnvironment, et UpdateComputeEnvironment dans le AWS Batch Référence de l'API.

Configuration de cluster que vous devez toujours fournir

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:

    $ 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. 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:

$ 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 dans le Guide de l'utilisateur d'Amazon EKS.

Important

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

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