

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

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

Amazon EKS 支持两种机制来授予 IAM 委托人调用集群的权限 Kubernetes API：遗产 `aws-auth` ConfigMap 还有较新的 [访问入口 API](https://docs.amazonaws.cn/eks/latest/userguide/access-entries.html)。访问入口授权 Kubernetes 无需您编辑 API 即可访问 IAM 委托人 ConfigMap。 Amazon Batch 可以通过任何一种机制向您的集群进行身份验证。

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

是否 Amazon Batch 设置访问条目取决于您的 Amazon Batch 计算环境和您的亚马逊 EKS 集群配置。有关详细信息，请参阅[与集群的互动 `身份验证模式`](#eks-access-entries-matrix)。

## 的值 `访问Entry.desiredState`
<a name="eks-access-entries-desired-state"></a>

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

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

`DISABLED`  
Amazon Batch 删除 Amazon Batch-集群的管理访问入口。 Amazon Batch 只会删除 Amazon Batch-如果集群上的所有计算环境都已设置，则为管理访问入口 `desiredState` 到 `DISABLED` （参见 [操作方法 Amazon Batch 和解 `所需状态` 跨计算环境](#eks-access-entries-reconciliation) 详情请见）。必须通过配置对群集的访问权限 `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](https://docs.amazonaws.cn/batch/latest/APIReference/API_DescribeComputeEnvironments.html) 回应。 `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 访问条目设置不完整](batch_eks_invalid_compute_environment.md#batch_eks_access_entry_incomplete)。

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

## 与集群的互动 `身份验证模式`
<a name="eks-access-entries-matrix"></a>

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


<table>
<thead>
  <tr><th>集群 <code>authenticationMode</code></th><th>计算环境 <code>accessEntry.desiredState=ENABLED</code></th><th>计算环境 <code>accessEntry.desiredState=DISABLED</code></th><th>计算环境 <code>accessEntry.desiredState=INHERIT_FROM_CLUSTER</code></th></tr>
</thead>
<tbody>
  <tr><td><code>CONFIG_MAP</code></td><td colspan="3">集群上没有访问条目，所以 Amazon Batch 不会创建或删除一个。 Amazon Batch 仍会记录您指定的值。更改集群的身份验证模式后，该记录的值将在您的下一次身份验证模式时生效 <code>CreateComputeEnvironment</code> 要么 <code>UpdateComputeEnvironment</code> 指定调用 <code>desiredState</code>。</td></tr>
  <tr><td><code>API_AND_CONFIG_MAP</code></td><td colspan="2">Amazon Batch 比较共享群集的计算环境中的记录值——请参阅 <a href="#eks-access-entries-reconciliation">操作方法 Amazon Batch 和解 `所需状态` 跨计算环境</a>。</td><td>保留现有访问模式。 Amazon Batch 不添加或删除访问条目。</td></tr>
  <tr><td><code>API</code></td><td>访问条目是在集群上创建和维护的。</td><td>请求被拒绝。此模式下的集群不支持 <code>aws-auth</code> ConfigMap，以及 ConfigMap 创建集群后无法启用方法，所以 <code>DISABLED</code> 将使计算环境无法进行身份验证。</td><td>访问条目是在集群上创建和维护的。当集群是 <code>API</code>-ony，继承等同于 <code>ENABLED</code>。</td></tr>
</tbody>
</table>


## 操作方法 Amazon Batch 和解 `所需状态` 跨计算环境
<a name="eks-access-entries-reconciliation"></a>

因为单个 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 在您的集群上创建
<a name="eks-access-entries-what-batch-creates"></a>

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

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

访问条目本身不足以在集群上运行作业。对于 Kubernetes 权限和节点访问权限必须自己配置，请参阅 [您仍必须提供的集群配置](#eks-access-entries-additional-configuration)。

## 所需的权限
<a name="eks-access-entries-permissions"></a>

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

## 配置访问条目
<a name="eks-access-entries-configure"></a>

您可以通过在计算环境中配置访问条目 `eksConfiguration.accessEntry` 的领域 [CreateComputeEnvironment](https://docs.amazonaws.cn/batch/latest/APIReference/API_CreateComputeEnvironment.html) 要么 [UpdateComputeEnvironment](https://docs.amazonaws.cn/batch/latest/APIReference/API_UpdateComputeEnvironment.html) API。

------
#### [ Amazon CLI ]

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

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

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

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

**检查状态**

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

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

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

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

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

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

使用 `eksConfiguration.accessEntry` 你里面的对象 [CreateComputeEnvironment](https://docs.amazonaws.cn/batch/latest/APIReference/API_CreateComputeEnvironment.html) 要么 [UpdateComputeEnvironment](https://docs.amazonaws.cn/batch/latest/APIReference/API_UpdateComputeEnvironment.html) 请求。

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

包括 `accessEntry` 在请求正文中：

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

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

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

有关更多信息，请参阅 [`EksAccessEntry`](https://docs.amazonaws.cn/batch/latest/APIReference/API_EksAccessEntry.html)， [CreateComputeEnvironment](https://docs.amazonaws.cn/batch/latest/APIReference/API_CreateComputeEnvironment.html)，以及 [UpdateComputeEnvironment](https://docs.amazonaws.cn/batch/latest/APIReference/API_UpdateComputeEnvironment.html) 在 *Amazon Batch API 参考*。

------

## 您仍必须提供的集群配置
<a name="eks-access-entries-additional-configuration"></a>

访问条目仅控制方式 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:

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

  替换 {{my-aws-batch-namespace}} 使用您在中指定的值 `eksConfiguration.kubernetesNamespace`。
**重要**  
如果没有命名空间范围的策略关联，工作将继续停滞不前 `RUNNABLE` 状态。单独的集群级策略并不能授予 Pod 管理权限。
+ **Kubernetes 角色和角色绑定（访问进入时） `status=INACTIVE`)** — 如果 Amazon Batch-managed 访问权限条目未激活，请创建 Kubernetes 角色和授予这些权限的角色绑定，如中所述 [第 2 步：为 Amazon EKS 集群做好准备 Amazon Batch](getting-started-eks-configmap.md#getting-started-eks-configmap-step-1)。您可以为每个集群执行一次此操作。
**注意**  
当一个 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:  

```sh
$ aws eks create-access-entry \
    --cluster-name {{my-cluster}} \
    --principal-arn {{arn:aws:iam::123456789012:role/my-node-instance-role}} \
    --type EC2_LINUX
```
有关更多信息，请参阅 [创建访问条目](https://docs.amazonaws.cn/eks/latest/userguide/creating-access-entries.html) 在 **亚马逊 EKS 用户指南**。  
如果节点实例角色没有适当的集群访问权限，EC2 实例将无法加入集群。就业机会将留在 `RUNNABLE` 状态，因为没有容量注册到集群。

## 在两者之间进行选择 `aws-auth` ConfigMap 和访问条目
<a name="eks-access-entries-choosing"></a>

访问入口身份验证是新手的推荐路径 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` 配置正确](verify-configmap-config.md)。