用途:评估现网 EKS 集群升级到下一 Kubernetes 版本是否安全,回答“能否升级该集群”。仅做只读检查,禁止执行任何变更命令,整改片段只作为文本展示,不代为运行。
主要能力:覆盖 8 个评估领域——版本校验(升级路径、版本偏差策略、支持状态)、破坏性变更、废弃/移除 API 扫描、插件兼容性(核心插件、OSS 插件矩阵、Karpenter)、节点就绪(版本偏差、AL2→AL2023、AMI)、工作负载风险(单副本、缺少 PDB、健康探针、资源请求)、AWS Upgrade Insights、升级计划(预填 CLI 命令与步骤)。按权重计算就绪评分:破坏性变更 25、废弃 API 20、节点就绪 20、不支持版本 15、插件兼容 15、Karpenter 10、工作负载风险 10、AWS Insights 10、AL2/行为 10。存在硬阻断(如 Karpenter 不兼容、关键插件 DEGRADED、子网无法放置控制面 ENI、集群非 ACTIVE)时评分上限为 59%。分数区间:90-100 READY、80-89 GOOD、70-79 FAIR、60-69 RISKY、0-59 NOT READY。
使用方式:需已配置 AWS 凭证并具备目标集群 kubectl 访问权限,涉及只读权限包括 eks:DescribeCluster / ListClusters / ListNodegroups / DescribeNodegroup、eks:ListAddons / DescribeAddon / DescribeAddonVersions / ListInsights / DescribeInsight、ec2:DescribeSubnets。可调用 /eks-upgrade-check,或直接请求运行 EKS 升级就绪评估。流程为先列出集群(注意 aws eks list-clusters 按区域限定且只返回名称)、描述选中集群、校验状态与权限、确认目标版本,再依次执行 8 个阶段并生成报告。可用 export AWS_PROFILE=your-profile-name 与 export AWS_REGION=your-region 指定配置与区域。无 MCP 时回退到 AWS CLI 与 kubectl;启用 EKS MCP 后优先使用 MCP 工具。
输出:Markdown 报告 EKS-Upgrade-Assessment-<cluster>-<current>-to-<target>-<YYYY-MM-DD>-<HHMM>.md,需转 HTML 时运行 python3 ${CLAUDE_SKILL_DIR}/tools/md_to_html.py <report>.md,不要手工生成 HTML。
限制:集群状态非 ACTIVE 时停止评估;失败命令不重试超过一次;不得硬编码集群名;权限被拒的读取项报告为 UNKNOWN 不计分,部分评估不能给出无保留的 READY;OSS 插件注册表不含兼容数据,兼容性须实时核验,无法核验则报 UNKNOWN;账户 ID 属敏感信息,外部分享前应遮蔽。