eksctl 0.25.0 版本特性详解:IMDSv1 禁用、Kubernetes 1.17 默认化与新区域支持

原创2026-10-14 21:51:141,925 阅读
文章标签:云原生容器编排DevOps

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 是一次兼顾安全加固与体验修正的版本:

  1. 安全加固:disableIMDSv1 默认开启,配合 disablePodIMDS 可在节点层面建立 IMDSv2 强制与 Pod 访问隔离;
  2. 默认值演进:默认 Kubernetes 版本升至 1.17,用户在创建新集群时自动获得新版本控制平面;
  3. 区域扩展:eu-south-1 与 af-south-1 正式可用,对应资源账户 ID 已内置;
  4. 清理与权限:删除集群时清理 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(集群升级命令)。

登录后查看全文
eksctl