eksctl 0.25.0 版本特性详解:IMDSv1 禁用、Kubernetes 1.17 默认化与新区域支持
eksctl 0.25.0 版本特性详解:IMDSv1 禁用、Kubernetes 1.17 默认化与新区域支持
本文以 eksctl 0.25.0 版本的官方发布说明(docs/release_notes/0.25.0.md)为主体,结合当前仓库源码,深入解析该版本引入的 disableIMDSv1 配置项、默认 Kubernetes 版本升级至 1.17、新增 Milan(eu-south-1)与开普敦(af-south-1)两个区域支持,以及 ALB Ingress 资源清理、update-aws-node 行为修正等 9 项功能改进与修复。读者将掌握这些特性的配置方法、底层实现原理与适用的实操场景。
一、新特性总览
eksctl 0.25.0 是 eksctl 发展早期(2020 年 7 月前后)的一个重要版本,其变更集中在安全加固、默认值演进与区域扩展三个方向:
- 功能(Features)
- 新增
disableIMDSv1配置项(对应 GitHub issue #2460) - 默认 Kubernetes 版本从 1.16 提升为 1.17(#2444)
- 新增对米兰
eu-south-1与开普敦af-south-1两个 AWS 区域的支持(#2495)
- 新增
- 改进(Improvements)
- 删除集群时清理由 AWS ALB Ingress Controller 创建的 ALB(#2465)
update-aws-node不再替换已有服务账户(#2459)- 更新 kubelet 保留内存(kubelet reserved memory)的默认计算逻辑,与 amazon-eks-ami 保持一致(#2443)
- 不再为集群 IAM 角色附加不必要的策略(#2451)
- Bug 修复(Bug Fixes)
- 恢复
eksctl upgrade cluster的"auto"版本语义(#2464) - 允许服务角色执行 ELB 所需的必要操作(#2492)
- 恢复
注:作为历史版本发布说明,文中涉及的默认 Kubernetes 版本、区域列表与配置默认值均以该版本当时的状态为准。当前仓库代码(如 pkg/apis/eksctl.io/v1alpha5/types.go)已随项目演进多次迭代,读者在应用到新版 eksctl 时需以实际安装版本的
eksctl version输出与eksctl create cluster --help为准。
二、新特性 1:disableIMDSv1 —— 强制节点使用 IMDSv2
2.1 特性背景与配置方法
实例元数据服务(Instance Metadata Service,IMDS)为 EC2 实例提供自身元数据与临时凭证,是云上应用获取 IAM 凭证的常见途径。IMDSv1 采用简单的 HTTP 请求即可获取数据,存在 SSRF(服务端请求伪造)攻击风险;而 IMDSv2 要求先通过 PUT 请求获取会话令牌、再携带令牌访问元数据,安全性显著提升。
eksctl 0.25.0 在节点组配置中新增了 disableIMDSv1 字段,将其设置为 true 即可强制节点上的元数据请求必须使用 IMDSv2:
# 01-simple-cluster.yaml 的节点组片段
nodeGroups:
- name: ng-1
instanceType: m5.large
desiredCapacity: 2
# 强制该节点组的所有元数据请求使用 IMDSv2 令牌
disableIMDSv1: true
该字段也完整收录在示例配置 examples/05-advanced-nodegroups.yaml 中,可作为高级节点组配置的参考模板。
2.2 源码实现:从配置到 CloudFormation LaunchTemplate
从源码结构看,disableIMDSv1 的完整链路是:API 类型定义 → 默认值注入 → CloudFormation LaunchTemplate 元数据选项生成。
第一步:API 类型定义
字段定义于 pkg/apis/eksctl.io/v1alpha5/types.go:
// DisableIMDSv1 requires requests to the metadata service to use IMDSv2 tokens
// Defaults to `true`
// +optional
DisableIMDSv1 *bool `json:"disableIMDSv1,omitempty"`
注释中明确标注其默认值为 true,即未显式配置时默认已开启 IMDSv2 强制。
第二步:默认值注入
在 pkg/apis/eksctl.io/v1alpha5/defaults.go 中,SetNodeGroupDefaults 会对未显式设置的节点组默认启用该开关:
if ng.DisableIMDSv1 == nil {
ng.DisableIMDSv1 = Enabled()
}
if ng.DisablePodIMDS == nil {
ng.DisablePodIMDS = Disabled()
}
与之配套的 DisablePodIMDS 字段(默认 false)则用于阻断非 host network Pod 的 IMDS 请求,二者可配合使用实现更细粒度的凭证访问控制。
第三步:生成 CloudFormation LaunchTemplate 元数据选项
在 CloudFormation 模板构建器 pkg/cfn/builder/nodegroup.go 中,makeMetadataOptions 函数根据这两个开关组合生成 EC2 LaunchTemplate 的 MetadataOptions:
func makeMetadataOptions(ng *api.NodeGroupBase) *gfnec2.LaunchTemplate_MetadataOptions {
imdsv2TokensRequired := "optional"
if api.IsEnabled(ng.DisableIMDSv1) || api.IsEnabled(ng.DisablePodIMDS) {
imdsv2TokensRequired = "required"
}
hopLimit := 2
if api.IsEnabled(ng.DisablePodIMDS) {
hopLimit = 1
}
return &gfnec2.LaunchTemplate_MetadataOptions{
HttpPutResponseHopLimit: gfnt.NewInteger(hopLimit),
HttpTokens: gfnt.NewString(imdsv2TokensRequired),
}
}
可以看到两个关键参数的取值逻辑:
| 配置组合 | HttpTokens |
HttpPutResponseHopLimit |
效果 |
|---|---|---|---|
disableIMDSv1: false 且 disablePodIMDS: false |
optional |
2 | 允许 IMDSv1,兼容旧应用 |
disableIMDSv1: true |
required |
2 | 强制 IMDSv2,Pod 仍可访问元数据 |
disablePodIMDS: true |
required |
1 | 强制 IMDSv2 且限制 Pod 访问 |
其中 HttpPutResponseHopLimit: 1 结合 disablePodIMDS 可阻止容器内(非 host network)发起的 IMDS 请求,实现纵深防御。节点组的 DisableIMDSv1 与 DisablePodIMDS 字段在类型定义上位于 pkg/apis/eksctl.io/v1alpha5/types.go,生成的 JSON Schema 亦记录在 pkg/apis/eksctl.io/v1alpha5/assets/schema.json。
2.3 验证依据
仓库测试用例覆盖了该配置的解析与生成逻辑,包括 pkg/cfn/builder/nodegroup_test.go、pkg/apis/eksctl.io/v1alpha5/managed_nodegroup_test.go 以及集成测试 integration/tests/dry_run/dry_run_test.go,可据此验证配置解析与模板生成的正确性。
三、新特性 2:默认 Kubernetes 版本升级至 1.17
0.25.0 将 eksctl create cluster 的默认 Kubernetes 版本从 1.16 提升为 1.17。这意味着创建集群时不显式指定 --version,将默认部署 1.17 控制平面与节点组。
在源码 pkg/apis/eksctl.io/v1alpha5/types.go 中定义了版本常量:
Version1_17 = "1.17"
而在创建集群的默认配置构造中(pkg/apis/eksctl.io/v1alpha5/types.go),Metadata 的 Version 会默认填入该常量。需要说明的是,当前仓库已演进到 DefaultVersion = Version1_34(pkg/apis/eksctl.io/v1alpha5/types.go),这正是 eksctl 随 EKS 支持版本滚动更新默认值的体现——0.25.0 的“默认 1.17”与当前版本的“默认 1.34”是同一策略在不同时间点的快照。
实操上,升级默认版本后用户仍可随时用 --version 显式覆盖,例如创建 1.16 集群以保持兼容:
eksctl create cluster --name=my-cluster --version=1.16
四、新特性 3:新增米兰与开普敦区域支持
0.25.0 新增对 AWS 欧洲(米兰)eu-south-1 与非洲(开普敦)af-south-1 两个区域的支持。在 pkg/apis/eksctl.io/v1alpha5/types.go 中定义了区域常量:
// RegionEUSouth1 represents the Eu South Region Milan
RegionEUSouth1 = "eu-south-1"
// RegionAFSouth1 represents the Africa (Cape Town) Region
RegionAFSouth1 = "af-south-1"
区域支持的核心难点在于 EKS 在各区域提供 EKS 优化 AMI 与节点资源的 AWS 账户 ID 各不相同。该版本为此补充了对应区域的资源账户映射(pkg/apis/eksctl.io/v1alpha5/types.go):
// eksResourceAccountAFSouth1 defines the AWS EKS account ID that provides node resources in af-south-1
eksResourceAccountAFSouth1 = "877085696533"
// eksResourceAccountEUSouth1 defines the AWS EKS account ID that provides node resources in eu-south-1
eksResourceAccountEUSouth1 = "590381155156"
新增区域后即可直接在这些区域创建集群:
eksctl create cluster --region=eu-south-1 --name=milan-cluster
eksctl create cluster --region=af-south-1 --name=cape-town-cluster
从源码结构可以推断,这些资源账户 ID 会被用于构造节点 AMI 的引用 ARN(即 EKS 官方在各区域存放节点 AMI 的镜像账户),是新增区域支持的必要基础设施数据。
五、改进详解
5.1 清理 AWS ALB Ingress Controller 创建的 ALB(#2465)
此前的集群删除流程中,由 AWS ALB Ingress Controller 为 Ingress 资源自动创建的 Application Load Balancer(及其安全组)可能残留为“悬空资源”(dangling ALB),导致删除集群后仍产生费用。0.25.0 在 eksctl delete cluster 的清理流程中增加了对这类 ALB 的识别与删除。
当前仓库中该能力已沉淀在 pkg/elb 包内。入口函数定义于 pkg/elb/cleanup.go,其职责注释明确为"查找并删除与 Kubernetes Service、Ingress 或 Gateway 关联的悬空 ELB"。其关键逻辑包括:
- 列出集群内的所有 Ingress(同时兼容
networking.k8s.io/v1与networking.k8s.io/v1beta1两个 API 版本,见 pkg/elb/ingress.go); - 仅处理
ingressClassName/ingress.class为alb的 Ingress(pkg/elb/ingress.go),即由 AWS ALB Ingress Controller 管理的资源; - 通过 Ingress 的
status.loadBalancer.ingress<a href="https://link.gitcode.com/i/cdf024b82f74a6706a48430d57f8afc5" target="_blank">].hostname解析出 ALB 名称([pkg/elb/ingress.go),再查询其安全组并纳入删除范围; - 删除 Ingress 资源后,等待关联的 ELB/NLB/ALB 一并完成释放(pkg/elb/cleanup.go)。
该机制在集群删除时自动触发,确保 ALB 与安全组不会随集群删除而遗留泄漏。
5.2 update-aws-node 不再替换服务账户(#2459)
eksctl 的 update-aws-node 命令用于将集群中的 aws-node DaemonSet 更新到推荐版本,为 VPC CNI 插件提供升级路径。此前流程会一并重建/替换相关服务账户,导致已配置的注解(例如为 aws-node 附加 IAM 角色的 eks.amazonaws.com/role-arn 注解)丢失。0.25.0 修正为只更新 DaemonSet 本身,不再替换服务账户,从而保留用户已有的服务账户配置。
该命令的入口位于 pkg/ctl/utils/update_aws_node.go,实际升级逻辑(含 aws-node 镜像版本解析与 DaemonSet 更新)实现在 pkg/addons/default/aws_node.go,配套的默认清单与更新脚本位于 pkg/addons/default/assets/aws-node.yaml 与 pkg/addons/default/scripts/update_aws_node.sh。调用方式不变:
eksctl utils update-aws-node --cluster=my-cluster
5.3 kubelet 保留内存计算对齐 amazon-eks-ami(#2443)
kubelet 需要为系统进程预留内存(--kubelet-reserved),此前 eksctl 的默认计算与 AWS 官方 EKS 优化 AMI(amazon-eks-ami)采用的公式不一致,可能导致节点可调度内存(allocatable)与预期不符。0.25.0 将默认 kubelet 保留内存计算更新为与 amazon-eks-ami 相同的口径,使 eksctl 创建的节点与 EKS 优化 AMI 的行为保持一致,避免因预留差异引发的 Pod 调度与节点压力问题。
相关默认配置实现在节点引导与节点组默认值模块中(可参考 pkg/nodebootstrap/ 与 pkg/apis/eksctl.io/v1alpha5/defaults.go 中 kubelet 相关配置的注入逻辑)。
5.4 精简集群 IAM 角色的策略(#2451)
此前 eksctl 为集群 IAM 角色附加的策略集合中存在冗余项。0.25.0 精简为仅附加 EKS 正常运行所必需的托管策略。在当前源码 pkg/cfn/builder/iam.go 中可以印证该策略形态:
managedPolicyARNs := []string{iamPolicyAmazonEKSClusterPolicy}
if !api.IsDisabled(c.spec.IAM.VPCResourceControllerPolicy) {
managedPolicyARNs = append(managedPolicyARNs, iamPolicyAmazonEKSVPCResourceController)
}
即默认仅附加 AmazonEKSClusterPolicy(必要时追加 AmazonEKSVPCResourceController),遵循最小权限原则;AmazonEKSClusterPolicy 常量定义于同一文件的 pkg/cfn/builder/iam.go。对应测试 pkg/cfn/builder/cluster_test.go 也断言了"ServiceRole 仅附加 AmazonEKSClusterPolicy"的行为。
六、Bug 修复详解
6.1 恢复 eksctl upgrade cluster 的 "auto" 版本语义(#2464)
eksctl upgrade cluster 支持以 --version=auto 表示"自动递增到下一个可用版本"。该版本修复了此前 "auto" 被破坏、导致升级行为异常的回归问题,恢复了 auto 的语义。
当前源码中该命令的入口位于 pkg/ctl/upgrade/cluster.go,--version 参数通过 cmdutils.AddVersionFlag 注册;注释(pkg/ctl/upgrade/cluster.go)也保留了对 "next"、"latest" 等特殊取值语义的说明,表明版本旗标支持特殊值自动解析:
# 自动升级到下一个可用 Kubernetes 版本
eksctl upgrade cluster --name=my-cluster --version=auto
6.2 允许服务角色执行 ELB 所需的必要操作(#2492)
该修复为集群的服务角色(ServiceRole)补充了 ELB 相关操作权限。EKS 控制平面需要调用弹性负载均衡(ELB/ELBv2)服务来创建和配置 Kubernetes Service 类型为 LoadBalancer 时所需的负载均衡器,若服务角色缺少相应动作会导致负载均衡器创建失败。0.25.0 允许服务角色执行这些 ELB 必要操作,属于权限范围修正类修复。
七、总结:0.25.0 的定位与迁移建议
综合来看,eksctl 0.25.0 是一次兼顾安全加固与体验修正的版本:
- 安全加固:
disableIMDSv1默认开启,配合disablePodIMDS可在节点层面建立 IMDSv2 强制与 Pod 访问隔离; - 默认值演进:默认 Kubernetes 版本升至 1.17,用户在创建新集群时自动获得新版本控制平面;
- 区域扩展:
eu-south-1与af-south-1正式可用,对应资源账户 ID 已内置; - 清理与权限:删除集群时清理 ALB Ingress 遗留资源,精简集群角色策略,并修复
update-aws-node破坏服务账户、upgrade cluster --version=auto失效等问题。
对于从旧版本升级的用户,建议升级后重点验证:节点组的 IMDS 行为是否符合预期(涉及使用 IMDSv1 获取凭证的旧应用)、默认版本变化对现有工作负载的兼容性,以及删除集群时新 ALB 清理逻辑对现有 Ingress 资源的影响。
延伸阅读:想深入了解相关能力的读者可继续阅读仓库中的 examples/05-advanced-nodegroups.yaml(disableIMDSv1 示例)、pkg/cfn/builder/nodegroup.go(元数据选项生成)、pkg/elb/cleanup.go(ALB 清理入口)以及 pkg/ctl/upgrade/cluster.go(集群升级命令)。