控制对集群 API 服务器端点的网络访问权限 - Amazon EKS

帮助改进此页面

想为本用户指南做出贡献? 滚动到页面底部,然后选择在 GitHub 上编辑此页面。您的贡献有助于我们的用户指南为每个人提供更充分的参考。

控制对集群 API 服务器端点的网络访问权限

本主题可帮助您为 Amazon EKS 集群的 Kubernetes API 服务器端点启用私有访问,并限制或完全禁用通过 Internet 进行的公有访问。

在创建新集群时,Amazon EKS 将为您用于与集群进行通信的托管 Kubernetes API 服务器(使用 Kubernetes 管理工具,如 kubectl)创建端点。预设情况下,此 API 服务器端点对于 Internet 是公有的,对 API 服务器的访问将使用 AWS Identity and Access Management(IAM)与本机 Kubernetes 基于角色的访问控制(RBAC)相结合的方式加以保护。

您可以启用对 Kubernetes API 服务器的私有访问,以便节点与 API 服务器之间的所有通信都在 VPC 内。您可以限制从 Internet 访问 API 服务器的 IP 地址,或完全禁用对 API 服务器的 Internet 访问。

注意

由于此端点用于 Kubernetes API 服务器,而不是用于与 AWS API 通信的传统 AWS PrivateLink 端点,所以它不会在 Amazon VPC 控制台中显示为端点。

当您为集群启用端点私有访问时,Amazon EKS 将代表您创建一个 Route 53 私有托管区域,并将它与您的集群的 VPC 关联。这个私有托管区域由 Amazon EKS 管理,它不会出现在您的账户的 Route 53 资源中。为了使私有托管区域正确地将流量路由到您的 API 服务器,您的 VPC 必须将 enableDnsHostnamesenableDnsSupport 设置为 true,而且为 VPC 设置的 DHCP 选项必须在其域名服务器列表中包含 AmazonProvidedDNS。有关更多信息,请参阅 Amazon VPC 用户指南中的更新 VPC 的 DNS 支持

您可以在创建新集群时定义 API 服务器终端节点的访问要求,并且可以随时更新集群的 API 服务器终端节点访问。

修改集群终端节点访问

使用本节中的过程来修改现有集群的终端节点访问。下表显示了受支持的 API 服务器终端节点访问组合及其关联的行为。

终端节点公有访问 终端节点私有访问 行为
已启用 已禁用
  • 这是新 Amazon EKS 集群的默认行为。

  • 源自集群的 VPC 内的 Kubernetes API 请求(如控制面板通信的节点)离开 VPC 但不离开 Amazon 网络。

  • 集群 API 服务器可从 Internet 访问。您可以选择性地限制可访问公有终端节点的 CIDR 块。如果限制对特定 CIDR 块的访问,则建议您还启用私有端点,或者确保指定的 CIDR 块包括节点和 Fargate Pods(如果您使用这些 Pod)用于访问公有端点的地址。

已启用 已启用
  • 集群的 VPC 内的 Kubernetes API 请求(如控制面板通信的节点)使用私有 VPC 端点。

  • 集群 API 服务器可从 Internet 访问。您可以选择性地限制可访问公有终端节点的 CIDR 块。

已禁用 已启用
  • 传输到集群 API 服务器的所有流量都必须来自您的集群的 VPC 或连接的网络中。

  • 没有来自 Internet 的对 API 服务器的公有访问。所有 kubectl 命令都必须来自 VPC 或连接的网络中。对于连接选项,请参阅 访问私有 API 服务器

  • 公有 DNS 服务器将集群的 API 服务器终端节点解析为 VPC 中的私有 IP 地址。过去,终端节点只能在 VPC 内部解析。

    如果您的终端节点未解析为现有集群的 VPC 内的私有 IP 地址,您可以:

    • 启用公有访问,然后重新禁用。您只需为集群执行一次该操作,终端节点就将从该时间点开始解析为私有 IP 地址。

    • 更新您的集群。

您可以使用 AWS Management Console或 AWS CLI 修改集群 API 服务器终端节点访问。

AWS Management Console
使用 AWS Management Console 修改集群 API 服务器端点访问
  1. 访问 https://console.aws.amazon.com/eks/home#/clusters 打开 Amazon EKS 控制台。

  2. 选择集群的名称可以显示集群信息。

  3. 选择 Networking(联网)选项卡,然后选择 Update(更新)。

  4. 对于 Private access(私有访问),选择是启用还是禁用集群的 Kubernetes API 服务器端点的私有访问。如果启用私有访问,源自集群的 VPC 内的 Kubernetes API 请求将使用私有 VPC 端点。您必须启用私有访问以禁用公有访问。

  5. 对于 Public access(公有访问),选择是启用还是禁用集群的 Kubernetes API 服务器端点的公有访问。如果禁用公有访问,集群的 Kubernetes API 服务器只能接收来自集群 VPC 内的请求。

  6. (可选)如果您已启用 Public access (公有访问),则可以指定 Internet 中的哪些地址可以与公有端点通信。选择 Advanced Settings (高级设置)。输入 CIDR 区块,例如 203.0.113.5/32。该块不能包含预留地址。您可以通过选择 Add Source (添加源) 来输入其他块。您可以指定的 CIDR 块存在最大数量限制。有关更多信息,请参阅 查看和管理 Amazon EKS 和 Fargate 服务配额。如果未指定任何块,则公有 API 服务器端点将接收来自所有(0.0.0.0/0)IP 地址的请求。如果您使用 CIDR 块限制对公有端点的访问,建议您还启用私有端点访问,以便节点和 Fargate Pods(如果您使用这些 Pod)可以与集群进行通信。在未启用私有终端节点的情况下,您的公有访问终端节点 CIDR 源必须包含来自 VPC 的出口源。例如,如果您在私有子网中有一个节点,该节点通过 NAT 网关与 Internet 通信,则您需要将 NAT 网关的出站 IP 地址添加作为公有端点上的容许 CIDR 块的一部分。

  7. 选择 Update (更新) 完成操作。

AWS CLI
使用 AWS CLI 修改集群 API 服务器端点访问

使用 AWS CLI 版本 1.27.160 或更高版本完成以下步骤。您可以使用 aws --version 检查您的当前版本。要安装或升级 AWS CLI,请参阅安装 AWS CLI

  1. 使用下面的 AWS CLI 命令更新集群 API 服务器终端节点访问。替换您的集群名称和所需的终端节点访问值。如果设置了 endpointPublicAccess=true,则可以(可选)输入单个 CIDR 块,或者输入 publicAccessCidrs 的用逗号分隔的 CIDR 块列表。块不能包含预留地址。如果您指定 CIDR 块,则公有 API 服务器终端节点将只接收来自列出的块的请求。您可以指定的 CIDR 块存在最大数量限制。有关更多信息,请参阅 查看和管理 Amazon EKS 和 Fargate 服务配额。如果您使用 CIDR 块限制对公有端点的访问,建议您还启用私有端点访问,以便节点和 Fargate Pods(如果您使用这些 Pod)可以与集群进行通信。在未启用私有终端节点的情况下,您的公有访问终端节点 CIDR 源必须包含来自 VPC 的出口源。例如,如果您在私有子网中有一个节点,该节点通过 NAT 网关与 Internet 通信,则您需要将 NAT 网关的出站 IP 地址添加作为公有端点上的容许 CIDR 块的一部分。如果未指定任何 CIDR 块,则公有 API 服务器终端节点将接收来自所有 (0.0.0.0/0) IP 地址的请求。

    注意

    以下命令为 API 服务器终端节点启用来自单个 IP 地址的私有访问和公有访问。将 203.0.113.5/32 替换为要限制网络访问的单个 CIDR 块或用逗号分隔的 CIDR 块列表。

    aws eks update-cluster-config \ --region region-code \ --name my-cluster \ --resources-vpc-config endpointPublicAccess=true,publicAccessCidrs="203.0.113.5/32",endpointPrivateAccess=true

    示例输出如下。

    { "update": { "id": "e6f0905f-a5d4-4a2a-8c49-EXAMPLE00000", "status": "InProgress", "type": "EndpointAccessUpdate", "params": [ { "type": "EndpointPublicAccess", "value": "true" }, { "type": "EndpointPrivateAccess", "value": "true" }, { "type": "publicAccessCidrs", "value": "[\203.0.113.5/32\"]" } ], "createdAt": 1576874258.137, "errors": [] } }
  2. 使用以下命令通过上一命令返回的集群名称和更新 ID 监控您的终端节点访问更新的状态。当状态显示为 Successful 时,您的更新将完成。

    aws eks describe-update \ --region region-code \ --name my-cluster \ --update-id e6f0905f-a5d4-4a2a-8c49-EXAMPLE00000

    示例输出如下。

    { "update": { "id": "e6f0905f-a5d4-4a2a-8c49-EXAMPLE00000", "status": "Successful", "type": "EndpointAccessUpdate", "params": [ { "type": "EndpointPublicAccess", "value": "true" }, { "type": "EndpointPrivateAccess", "value": "true" }, { "type": "publicAccessCidrs", "value": "[\203.0.113.5/32\"]" } ], "createdAt": 1576874258.137, "errors": [] } }

访问私有 API 服务器

如果您已禁用集群的 Kubernetes API 服务器端点的公有访问,则只能从 VPC 或连接的网络内访问 API 服务器。以下是访问 Kubernetes API 服务器端点的部分可行方法:

连接的网络

使用 AWSTransit Gateway 或其他连接选项将您的网络连接到 VPC,然后使用连接的网络中的计算机。必须确保您的 Amazon EKS 控制层面安全组规则允许来自您的连接网络的端口 443 上的入口流量。

Amazon EC2 堡垒主机

您可以在集群的 VPC 中将 Amazon EC2 实例启动到公有子网中,然后通过 SSH 登录到该实例来运行 kubectl 命令。有关更多信息,请参阅 AWS 上的 Linux 堡垒机主机。必须确保您的 Amazon EKS 控制层面安全组规则允许来自您的堡垒主机的端口 443 上的入口流量。有关更多信息,请参阅 查看集群的 Amazon EKS 安全组要求

在为堡垒主机配置 kubectl 时,请确保使用已映射到集群的 RBAC 配置的 AWS 凭证,或在移除端点公有访问之前添加您的堡垒机将用于 RBAC 配置的 IAM 主体。有关更多信息,请参阅向 IAM 用户和角色授予对 Kubernetes APIs 的访问权限未经授权或访问被拒绝 (kubectl)

AWS Cloud9 IDE

AWS Cloud9 是一种基于云的集成式开发环境(IDE),您只需要一个浏览器,即可编写、运行和调试代码。您可以在集群的 VPC 中创建 AWS Cloud9 IDE,然后使用 IDE 来与集群进行通信。有关更多信息,请参阅在 AWS Cloud9 中创建环境。您必须确保 Amazon EKS 控制层面安全组包含允许来自 IDE 安全组的端口 443 上的入口流量的规则。有关更多信息,请参阅 查看集群的 Amazon EKS 安全组要求

在为 AWS Cloud9 IDE 配置 kubectl 时,请确保使用已映射到集群的 RBAC 配置的 AWS 凭证,或在移除端点公有访问之前添加您的 IDE 将用于 RBAC 配置的 IAM 主体。有关更多信息,请参阅向 IAM 用户和角色授予对 Kubernetes APIs 的访问权限未经授权或访问被拒绝 (kubectl)