SuperAPI AI 工具集

eks-upgrade-check

通用与其它

查看项目

更新于 10-15 19:58

技能介绍

用途:判断当前 EKS 集群升级到下一版本是否安全,回答“现在能否升级”的问题,并给出优先级修复建议与预填 AWS CLI 命令。

主要能力:覆盖 8 个评估域——版本校验(升级路径、版本偏离策略、支持状态)、破坏性变更(API 移除与行为变化)、废弃 API 实时扫描、附加组件与 Karpenter 兼容性、节点就绪(版本偏离、AL2→AL2023 迁移、AMI 兼容)、工作负载风险(单副本、缺失 PDB、健康探针、资源请求)、AWS Upgrade Insights、升级计划。计算加权就绪分数:破坏性变更最多扣 25 分,废弃 API 20 分,节点就绪 20 分,不受支持版本 15 分,附加组件 15 分,Karpenter 10 分,工作负载风险 10 分,AWS Insights 10 分;若检测到硬阻塞(如 Karpenter 不兼容、关键附加组件 DEGRADED、子网 IP 少于 5、集群非 ACTIVE),分数上限压至 59%。分数解读:90-100 可升级,80-89 可谨慎进行,70-79 需先处理若干问题,60-69 风险较高不建议,0-59 存在关键阻塞。

使用方式:需先配置 AWS 凭证并具备 kubectl 访问权限,以及 eks:DescribeCluster、eks:ListClusters、eks:ListNodegroups、eks:DescribeNodegroup、eks:ListAddons、eks:DescribeAddon、eks:ListInsights、eks:DescribeInsight、ec2:DescribeSubnets、iam:GetRole 等权限。在 Claude Code 中以 /eks-upgrade-check 调用或直接请求“运行 EKS 升级就绪评估”。技能会先探测集群、确认目标版本(按一次一个次版本升级,若跨多版本会展示升级路径并评估第一跳),再依次执行各检查段。可通过环境变量指定配置与区域:export AWS_PROFILE=your-profile-name 与 export AWS_REGION=your-region。工具使用规则包括先列出集群而非猜测名称、失败命令不重复超过一次、执行某节检查前先读取对应 steering 文件。

数据与输出:OSS 附加组件注册表只提供标识与上游地址,兼容性需通过 compatibility_url、releases_url 实时核验,无法核实则报告 UNKNOWN。报告输出为 Markdown 文件,命名形如 EKS-Upgrade-Assessment-<cluster>-<version>-<YYYY-MM-DD>-<HHMM>.md,转 HTML 使用 python3 ${CLAUDE_SKILL_DIR}/tools/md_to_html.py <report>.md,不要手动生成 HTML。

限制:技能依赖两个 MCP 服务器(awslabs.eks-mcp-server 与 awslabs.aws-documentation-mcp-server),不可用时回退到 AWS CLI 与 kubectl;集群非 ACTIVE 即硬阻塞、必须停止评估。其余收费、价格、平台支持等信息暂未提供。