帮助改进此页面
想为本用户指南做出贡献? 选择位于每个页面右侧窗格中的在 GitHub 上编辑此页面链接。您的贡献有助于我们的用户指南为每个人提供更充分的参考。
控制对集群 API 服务器端点的网络访问权限
本主题可帮助您为 Amazon EKS 集群的 Kubernetes API 服务器端点启用私有访问,并限制或完全禁用通过互联网进行的公共访问。
在创建新集群时,Amazon EKS 将为您用于与集群进行通信的托管 Kubernetes API 服务器(使用 Kubernetes 管理工具,如 kubectl
)创建端点。默认情况下,此 API 服务器端点对于互联网是公有的,对 API 服务器的访问将使用 AWSIdentity and Access Management(IAM)与本机 Kubernetes 基于角色的访问控制
IPv6
集群端点格式
EKS 按以下格式为 2024 年 10 月之后创建的新 IPv6
集群创建唯一的双堆栈端点。IPv6 集群是您在群集的 IP 系列 (ipFamily
) 设置中选择了 IPv6
的集群。
注意
双堆栈集群端点已于 2024 年 10 月推出。有关 IPv6
的更多信息,请参阅 了解如何将 IPv6 地址分配给集群、Pods 和服务。在 2024 年 10 月之前创建的集群,请改用以下端点格式。
IPv4
集群端点格式
EKS 采用以下格式为在集群的 IP 系列(ipFamily)设置中选择了 IPv4
的每个集群创建一个唯一的端点:
注意
在 2024 年 10 月之前,IPv6
集群也使用此端点格式。对于这些集群,公共端点和私有端点都只有从此端点解析的 IPv4
地址。
集群私有端点
您可以启用对 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 必须将 enableDnsHostnames
和 enableDnsSupport
设置为 true
,而且为 VPC 设置的 DHCP 选项必须在其域名服务器列表中包含 AmazonProvidedDNS
。有关更多信息,请参阅 Amazon VPC 用户指南中的更新 VPC 的 DNS 支持。
您可以在创建新集群时定义 API 服务器终端节点的访问要求,并且可以随时更新集群的 API 服务器终端节点访问。
修改集群终端节点访问
使用本节中的过程来修改现有集群的终端节点访问。下表显示了受支持的 API 服务器终端节点访问组合及其关联的行为。
终端节点公有访问 | 终端节点私有访问 | 行为 |
---|---|---|
已启用 |
已禁用 |
|
已启用 |
已启用 |
|
已禁用 |
已启用 |
|
您可以使用 AWS Management Console或 AWS CLI 修改集群 API 服务器端点访问。
配置端点访问 – AWS 控制台
-
选择集群的名称可以显示集群信息。
-
选择 Networking(联网)选项卡,然后选择 Update(更新)。
-
对于私有访问,选择是启用还是禁用集群的 Kubernetes API 服务器端点的私有访问。如果启用私有访问,源自集群的 VPC 内的 Kubernetes API 请求将使用私有 VPC 端点。您必须启用私有访问以禁用公有访问。
-
对于公有访问,选择是启用还是禁用集群的 Kubernetes API 服务器端点的公有访问。如果禁用公有访问,集群的 Kubernetes API 服务器只能接收来自集群 VPC 内的请求。
-
(可选)如果您已启用公有访问,则可以指定互联网中的哪些地址可以与公共端点通信。选择 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 块的一部分。 -
选择 Update (更新) 完成操作。
配置端点访问 – AWS CLI
使用 AWS CLI 版本 1.27.160
或更高版本完成以下步骤。您可以使用 aws --version
检查您的当前版本。要安装或升级 AWS CLI,请参阅安装 AWS CLI。
-
使用下面的 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": [] } }
-
使用以下命令通过上一命令返回的集群名称和更新 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 服务器端点的部分可行方法:
- 连接的网络
-
使用 AWS Transit 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)。