eksctl创建EKS集群时出现"Attribute 'Arn' does not exist"错误分析与解决方案

问题现象

在使用eksctl工具创建Amazon EKS集群时，用户遇到了一个常见的错误："Attribute 'Arn' does not exist"。该错误发生在CloudFormation堆栈创建过程中，具体表现为控制平面(ControlPlane)资源创建失败。错误信息显示AWS::EKS::Cluster/ControlPlane在创建时无法获取ARN属性。

错误背景

多位用户报告了类似问题，使用不同版本的eksctl（包括0.179.0、0.188.0和0.191.0）都会出现此错误。错误发生时，CloudFormation堆栈会进入ROLLBACK_IN_PROGRESS状态，导致集群创建失败。

根本原因分析

经过深入分析，这个问题主要与IAM权限设置和资源创建时序有关：

1. IAM角色信任关系不完整：创建EKS集群所需的IAM角色缺少必要的信任关系设置，特别是对eks.amazonaws.com服务的信任关系。

2. 资源创建时序问题：在CloudFormation堆栈创建过程中，IAM角色可能尚未完全准备好就被EKS集群资源尝试引用，导致ARN属性不可用。

3. 权限不足：虽然用户设置了基本的EKS相关策略，但可能缺少某些关键权限或信任关系设置不完整。

解决方案

临时解决方案

在创建集群时添加--cfn-disable-rollback标志可以防止堆栈在失败时自动回滚，然后手动重试堆栈创建操作：

eksctl create cluster --cfn-disable-rollback [其他参数]

永久解决方案

1. 完善IAM角色信任关系： 确保用于创建集群的IAM角色具有正确的信任关系，特别是包含对eks.amazonaws.com服务的信任。示例信任策略如下：

{
    "Version": "2012-10-17",
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "AWS": "arn:aws:iam::账户ID:role/角色名称",
                "Service": [
                    "ec2.amazonaws.com",
                    "eks-fargate-pods.amazonaws.com",
                    "eks.amazonaws.com"
                ]
            },
            "Action": "sts:AssumeRole"
        }
    ]
}

2. 确保完整权限： 除了基本的EKS策略外，创建集群的IAM角色还需要以下权限：

   • eks:*
   • cloudformation:*
   • 相关的IAM权限（CreateRole、AttachRolePolicy、PassRole等）

3. 检查子网设置： 确保指定的VPC子网ID正确无误，并且有足够的可用IP地址。

最佳实践建议

1. 使用最新版本：始终使用最新版本的eksctl工具，因为新版本可能已经修复了类似的问题。

2. 详细日志：在创建集群时添加--verbose 4参数获取更详细的日志输出，有助于诊断问题。

3. 分步验证：

   • 先创建IAM角色并验证其权限
   • 然后创建EKS集群
   • 最后添加节点组和工作负载

4. 监控CloudFormation事件：在AWS控制台中实时监控CloudFormation堆栈事件，可以更早发现问题。

总结

"Attribute 'Arn' does not exist"错误通常与IAM设置问题相关，特别是角色信任关系和权限不足。通过完善IAM角色的信任关系设置，确保所有必要的服务主体都被包含，并验证所有权限设置正确，可以有效解决这个问题。对于时间敏感的场景，使用--cfn-disable-rollback标志可以防止自动回滚，为诊断和修复问题提供更多灵活性。