View a markdown version of this page

亚马逊 EKS 访问入口身份验证 - Amazon Batch
Amazon Web Services 文档中描述的 Amazon Web Services 服务或功能可能因区域而异。要查看适用于中国区域的差异,请参阅 中国的 Amazon Web Services 服务入门 (PDF)。

本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。

亚马逊 EKS 访问入口身份验证

Amazon EKS 支持两种机制来授予 IAM 委托人调用集群的权限 Kubernetes API:遗产 aws-auth ConfigMap 还有较新的 访问入口 API。访问入口授权 Kubernetes 无需您编辑 API 即可访问 IAM 委托人 ConfigMap。 Amazon Batch 可以通过任何一种机制向您的集群进行身份验证。

当你设置时 eksConfiguration.accessEntry.desiredState 到 ENABLED 在计算环境中, Amazon Batch 可以在集群上管理该计算环境的访问入口。您不再需要手动编辑 aws-auth ConfigMap。

是否 Amazon Batch 设置访问条目取决于您的 Amazon Batch 计算环境和您的亚马逊 EKS 集群配置。有关详细信息,请参阅与集群的互动 身份验证模式。

的值 访问Entry.desiredState

这个 desiredState 开启字段 EksAccessEntry 声明计算环境所需的访问入口状态。有效值为:

ENABLED

Amazon Batch 创建一个 Amazon Batch-计算环境集群上的托管访问入口。 Amazon Batch 只会创建一个 Amazon Batch-如果集群上的所有计算环境都已设置,则为管理访问入口 desiredState 到 ENABLED (参见 操作方法 Amazon Batch 和解 所需状态 跨计算环境 详情请见)。

DISABLED

Amazon Batch 删除 Amazon Batch-集群的管理访问入口。 Amazon Batch 只会删除 Amazon Batch-如果集群上的所有计算环境都已设置,则为管理访问入口 desiredState 到 DISABLED (参见 操作方法 Amazon Batch 和解 所需状态 跨计算环境 详情请见)。必须通过配置对群集的访问权限 aws-auth ConfigMap。

INHERIT_FROM_CLUSTER

Amazon Batch 延迟到集群的当前访问条目 status。在身份验证模式为 Amazon EKS 集群上 API, Amazon Batch 创建和管理访问条目,因为集群没有 aws-auth ConfigMap 回到。在身份验证模式为的集群上 CONFIG_MAP 要么 API_AND_CONFIG_MAP, Amazon Batch 既不添加也不删除访问条目。

计算环境还暴露了只读的 accessEntry.status 中的字段 DescribeComputeEnvironments 回应。 ACTIVE 这意味着 Amazon Batch-计算环境的托管访问条目存在于集群上,优先于 aws-auth ConfigMap。 INACTIVE 意味着不是 Amazon Batch-管理访问条目存在。这可能是因为 desiredState 是 DISABLED,因为针对集群的计算环境尚未达成共识 desiredState,或者因为该条目尚未配置。如果 accessEntry.status 是 INACTIVE,批量使用 aws-auth ConfigMap 用于集群访问。

注意

访问入口报告 ACTIVE 只要它存在于集群上,即使 Amazon Batch 尚未完成关联使其可用的访问策略。如果计算环境状态更改为 INVALID 然而 accessEntry.status 是 ACTIVE,参见 亚马逊 EKS 访问条目设置不完整。

注意

如果你省略 accessEntry 字段, Amazon Batch 不录制 desiredState 用于计算环境,以及 DescribeComputeEnvironments 不返回一个。为了配置访问入口, Amazon Batch 表现得如出一辙 INHERIT_FROM_CLUSTER。

与集群的互动 身份验证模式

怎么样 Amazon Batch 在给定条件下表现良好 desiredState 取决于集群的身份验证模式。下表适用于两者 CreateComputeEnvironment 和 UpdateComputeEnvironment。

集群 authenticationMode

计算环境 accessEntry.desiredState=ENABLED

计算环境 accessEntry.desiredState=DISABLED

计算环境 accessEntry.desiredState=INHERIT_FROM_CLUSTER

CONFIG_MAP

集群上没有访问条目,所以 Amazon Batch 不会创建或删除一个。 Amazon Batch 仍会记录您指定的值。更改集群的身份验证模式后,该记录的值将在您的下一次身份验证模式时生效 CreateComputeEnvironment 要么 UpdateComputeEnvironment 指定调用 desiredState。

API_AND_CONFIG_MAP

Amazon Batch 比较共享群集的计算环境中的记录值——请参阅 操作方法 Amazon Batch 和解 所需状态 跨计算环境。

保留现有访问模式。 Amazon Batch 不添加或删除访问条目。

API

访问条目是在集群上创建和维护的。

请求被拒绝。此模式下的集群不支持 aws-auth ConfigMap,以及 ConfigMap 创建集群后无法启用方法,所以 DISABLED 将使计算环境无法进行身份验证。

访问条目是在集群上创建和维护的。当集群是 API-ony,继承等同于 ENABLED。

操作方法 Amazon Batch 和解 所需状态 跨计算环境

因为单个 Amazon EKS 集群可以支持多个集群 Amazon Batch 计算环境,集群的访问配置是共享资源。 Amazon Batch 因此,协调或比较并解决 desiredState 在这些计算环境中记录的值。

当集群是 authenticationMode 是 API_AND_CONFIG_MAP, Amazon Batch 比较 desiredState 为同一个计算环境记录在同一个计算环境中 Amazon 账户和 Amazon 以集群为目标的区域。 Amazon Batch 使用此比较来确定是添加还是删除每个访问条目 CreateComputeEnvironment 要么 UpdateComputeEnvironment 指定 desiredState。

每个计算环境都有 desiredState=ENABLED

Amazon Batch 在集群上创建访问条目。

每个计算环境都有 desiredState=DISABLED

Amazon Batch 如果存在访问条目,则从集群中删除访问条目。

录制的 desiredState 值并不都匹配

Amazon Batch 保留现有的访问模式。既未添加也未删除访问条目。这包括以下任意组合 ENABLED, DISABLED,以及 INHERIT_FROM_CLUSTER,它还包括任何没有计算环境的计算环境 desiredState 记录。

注意

过渡身份验证模式为的集群 API_AND_CONFIG_MAP 从 aws-auth ConfigMap 要访问入口身份验证,请设置 desiredState=ENABLED 在每个 Amazon Batch 以集群为目标的计算环境。要向后过渡,请设置 desiredState=DISABLED 在他们每一个上。

内容 Amazon Batch 在您的集群上创建

Amazon Batch 为满足上述条件的每个集群创建一个访问条目,然后关联 AWSBatchClusterPolicy 使用该访问条目的 Amazon EKS 访问政策。访问条目是每个集群而不是每个计算环境的,所以所有 Amazon Batch 以同一集群为目标的计算环境共享该集群。

注意

删除计算环境不会删除访问条目,即使它是最后一个访问条目 Amazon Batch 集群上的计算环境。要移除 Amazon Batch-管理访问入口,致电 UpdateComputeEnvironment 和 desiredState=DISABLED 在每个 Amazon Batch 在删除群集之前以群集为目标的计算环境。

访问条目本身不足以在集群上运行作业。对于 Kubernetes 权限和节点访问权限必须自己配置,请参阅 您仍必须提供的集群配置。

所需的权限

Amazon Batch 使用调用 IAM 身份的证书管理访问条目 CreateComputeEnvironment 要么 UpdateComputeEnvironment 操作。必须允许该身份执行以下亚马逊 EKS 操作:

  • eks:DescribeCluster

  • eks:DescribeAccessEntry

  • eks:CreateAccessEntry

  • eks:AssociateAccessPolicy

  • eks:DeleteAccessEntry

配置访问条目

您可以通过在计算环境中配置访问条目 eksConfiguration.accessEntry 的领域 CreateComputeEnvironment 要么 UpdateComputeEnvironment API。

Amazon CLI

启用 Amazon Batch-创建计算环境时的管理访问入口

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

启用 Amazon Batch-现有计算环境上的托管访问入口

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

检查状态

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

该回应包括两者 desiredState 你指定的和观察到的 status:

{ "desiredState": "ENABLED", "status": "ACTIVE" }
注意

Amazon Batch 回报 accessEntry.status 适用于所有 Amazon EKS 计算环境和退货 desiredState 前提是你已经设置好了。你从未指定过的计算环境 accessEntry 回报 status 独自一人。

停下来 Amazon Batch 从管理访问条目开始,设置 desiredState 到 DISABLED 取而代之。在你做之前,请先查看 与集群的互动 身份验证模式: DISABLED 在身份验证模式为的集群上被拒绝 API,并在身份验证模式为的集群上 API_AND_CONFIG_MAP 只有在每次之后才会删除访问条目 Amazon Batch 目标群集的计算环境设置为 DISABLED。

API

使用 eksConfiguration.accessEntry 你里面的对象 CreateComputeEnvironment 要么 UpdateComputeEnvironment 请求。

使用创建计算环境 Amazon Batch-管理访问入口

包括 accessEntry 在请求正文中:

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

更新现有计算环境的访问条目

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

有关更多信息,请参阅 EksAccessEntry, CreateComputeEnvironment,以及 UpdateComputeEnvironment 在 Amazon Batch API 参考。

您仍必须提供的集群配置

访问条目仅控制方式 Amazon Batch 对您的集群进行身份验证。它不授予 Amazon Batch 这 Kubernetes 它运行你的任务所需的权限,它不允许这些实例 Amazon Batch 启动加入集群。无论使用哪种身份验证机制,仍必须配置以下两项。

重要

曾经 Amazon Batch-管理访问条目是为创建的 Amazon Batch 集群上的服务相关角色 (accessEntry.status=ACTIVE),它优先于 aws-auth ConfigMap 角色的配置。这个 ConfigMap 的参赛作品 Amazon Batch 服务相关角色未使用,并且 Amazon Batch 改用访问条目进行身份验证。返回 ConfigMap 身份验证,设置 desiredState=DISABLED 在所有以群集为目标的计算环境上。这会移除 Amazon Batch-管理访问入口。

Kubernetes 的权限 Amazon Batch 命名空间

Amazon Batch 需求 Kubernetes 在你指定的命名空间中创建和管理 pod 的权限 eksConfiguration.kubernetesNamespace。创建命名空间,然后根据您的身份验证方法使用以下方法之一配置这些权限:

  • 访问策略关联(访问权限进入时必填) status=ACTIVE) — 当你设置时 desiredState=ENABLED 在所有针对集群的计算环境中, Amazon Batch 创建集群级别的访问条目 AWSBatchClusterPolicy。然后,你必须关联命名空间作用域 AWSBatchNamespacePolicy 授予 Amazon Batch 创建和管理 pod 的权限。

    访问入口到达后 status=ACTIVE,使用关联命名空间策略 Amazon 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

    替换 my-aws-batch-namespace 使用您在中指定的值 eksConfiguration.kubernetesNamespace。

    重要

    如果没有命名空间范围的策略关联,工作将继续停滞不前 RUNNABLE 状态。单独的集群级策略并不能授予 Pod 管理权限。

  • Kubernetes 角色和角色绑定(访问进入时) status=INACTIVE) — 如果 Amazon Batch-managed 访问权限条目未激活,请创建 Kubernetes 角色和授予这些权限的角色绑定,如中所述 第 2 步:为 Amazon EKS 集群做好准备 Amazon Batch。您可以为每个集群执行一次此操作。

    注意

    当一个 Amazon Batch-管理访问条目处于活动状态 (status=ACTIVE), Kubernetes RBAC 角色被绕过。您必须改用访问策略关联方法。

Amazon Batch 不会为你创建这些资源,而且 Amazon Batch-管理访问权限条目不能取代它们。如果它们不见了,计算环境仍然可以变成 VALID 而你的工作无法启动。

节点实例角色的集群访问权限

这样的实例 Amazon Batch 启动使用您在中指定的实例配置文件加入集群 computeResources.instanceRole。该角色需要自己的集群访问权限,这与 Amazon Batch-管理访问权限条目以及哪个 Amazon Batch 未配置。

配置方法取决于您的集群的 authenticationMode:

  • 在谁的集群上 authenticationMode 是 CONFIG_MAP — 你必须使用 aws-auth ConfigMap。这些集群不支持访问条目。

  • 在谁的集群上 authenticationMode 是 API_AND_CONFIG_MAP — 节点实例角色可以使用以下任一方式进行身份验证 aws-auth ConfigMap 或访问入口。如果实例角色已经映射到 ConfigMap,节点无需为角色创建访问条目即可成功加入。

  • 在集群上 authenticationMode 是 API — 必须为节点实例角色创建访问条目。这个 aws-auth ConfigMap 不用于这些集群的身份验证。

要为节点实例角色创建访问条目,请使用 Amazon CLI:

$ aws eks create-access-entry \ --cluster-name my-cluster \ --principal-arn arn:aws:iam::123456789012:role/my-node-instance-role \ --type EC2_LINUX

有关更多信息,请参阅 创建访问条目 在 亚马逊 EKS 用户指南。

重要

如果节点实例角色没有适当的集群访问权限,EC2 实例将无法加入集群。就业机会将留在 RUNNABLE 状态,因为没有容量注册到集群。

在两者之间进行选择 aws-auth ConfigMap 和访问条目

访问入口身份验证是新手的推荐路径 Amazon Batch 在亚马逊 EKS 计算环境上,它具有以下优点:

  • 无需手动编辑 aws-auth ConfigMap 授予 Amazon Batch 访问集群。

  • 提供可审计的, API-driven 有权访问集群的委托人的记录。

  • 对于具有以下条件的集群是必需的 authenticationMode 是 API,它们不支持 aws-auth ConfigMap。

如果你的集群是 authenticationMode 是 CONFIG_MAP,访问条目不可用而且 Amazon Batch 通过身份验证 aws-auth ConfigMap。有关说明,请参阅确认 aws-auth ConfigMap 配置正确。