本文属于机器翻译版本。若本译文内容与英语原文存在差异,则一律以英文原文为准。
亚马逊 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-authConfigMap。 INHERIT_FROM_CLUSTER-
Amazon Batch 延迟到集群的当前访问条目
status。在身份验证模式为 Amazon EKS 集群上API, Amazon Batch 创建和管理访问条目,因为集群没有aws-authConfigMap 回到。在身份验证模式为的集群上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。
集群 |
计算环境 |
计算环境 |
计算环境 |
|---|---|---|---|
|
集群上没有访问条目,所以 Amazon Batch 不会创建或删除一个。 Amazon Batch 仍会记录您指定的值。更改集群的身份验证模式后,该记录的值将在您的下一次身份验证模式时生效 |
||
|
Amazon Batch 比较共享群集的计算环境中的记录值——请参阅 操作方法 Amazon Batch 和解 所需状态 跨计算环境。 |
保留现有访问模式。 Amazon Batch 不添加或删除访问条目。 |
|
|
访问条目是在集群上创建和维护的。 |
请求被拒绝。此模式下的集群不支持 |
访问条目是在集群上创建和维护的。当集群是 |
操作方法 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 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-namemy-cluster\ --principal-arnarn: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-authConfigMap。这些集群不支持访问条目。 -
在谁的集群上
authenticationMode是API_AND_CONFIG_MAP— 节点实例角色可以使用以下任一方式进行身份验证aws-authConfigMap 或访问入口。如果实例角色已经映射到 ConfigMap,节点无需为角色创建访问条目即可成功加入。 -
在集群上
authenticationMode是API— 必须为节点实例角色创建访问条目。这个aws-authConfigMap 不用于这些集群的身份验证。
要为节点实例角色创建访问条目,请使用 Amazon CLI:
$aws eks create-access-entry \ --cluster-namemy-cluster\ --principal-arnarn:aws:iam::123456789012:role/my-node-instance-role\ --type EC2_LINUX有关更多信息,请参阅 创建访问条目 在 亚马逊 EKS 用户指南。
重要如果节点实例角色没有适当的集群访问权限,EC2 实例将无法加入集群。就业机会将留在
RUNNABLE状态,因为没有容量注册到集群。 -
在两者之间进行选择 aws-auth ConfigMap 和访问条目
访问入口身份验证是新手的推荐路径 Amazon Batch 在亚马逊 EKS 计算环境上,它具有以下优点:
-
无需手动编辑
aws-authConfigMap 授予 Amazon Batch 访问集群。 -
提供可审计的, API-driven 有权访问集群的委托人的记录。
-
对于具有以下条件的集群是必需的
authenticationMode是API,它们不支持aws-authConfigMap。
如果你的集群是 authenticationMode 是 CONFIG_MAP,访问条目不可用而且 Amazon Batch 通过身份验证 aws-auth ConfigMap。有关说明,请参阅确认 aws-auth ConfigMap 配置正确。