3. API 弃用检测工具概览：kubectl-convert、kubent、pluto、fairwinds-metrics、开源工具对比
在 Kubernetes 集群升级过程中，准确识别并处理已弃用或已移除的 API 版本是保障业务连续性的关键环节。社区与商业生态中涌现了多款工具，分别从不同维度解决 API 兼容性问题。本节将系统梳理五类主流工具的核心能力、适用场景与局限性，帮助团队在升级节点池前做出合理的技术选型。
3.1 工具全景与定位
根据检测机制与集成深度的不同，当前主流工具可分为三类：静态清单转换器、集群内运行时扫描器、CI/CD 策略引擎。下表从检测方式、输出格式、安装复杂度三个维度进行横向对比：
| 工具名称 | 检测方式 | 输出格式 | 安装复杂度 | 核心定位 |
|---|---|---|---|---|
| kubectl-convert | 本地静态清单转换 | YAML/JSON | 低（kubectl 插件） | 单文件版本迁移 |
| kubent | 集群内运行时扫描 | 表格/JSON/CSV | 中（需 RBAC 权限） | 集群级弃用审计 |
| pluto | 静态文件 + 集群扫描 | 表格/JSON/自定义 | 低（二进制/容器） | 多版本兼容性检查 |
| fairwinds-metrics | Prometheus 指标暴露 | Metrics + 告警 | 高（需 Helm 部署） | 持续监控与告警 |
3.2 工具详解与使用场景
3.2.1 kubectl-convert：轻量级清单迁移助手
kubectl-convert 是 Kubernetes 官方提供的 kubectl 插件，专用于将旧版 API 资源清单转换为目标版本格式。其核心优势在于零依赖与离线可用，适合在 CI 流水线或本地开发环境中快速修复单个 YAML 文件。
# 安装 kubectl-convert 插件
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert"
chmod +x kubectl-convert
sudo mv kubectl-convert /usr/local/bin/
# 将旧版 Deployment 转换为 apps/v1
kubectl-convert -f old-deployment.yaml --output-version apps/v13.2.2 kubent：集群级弃用审计利器
kubent（Kubernetes Namespace Entropy）通过直接查询集群 API Server，扫描所有命名空间下正在使用的已弃用 API 版本。它支持按命名空间过滤、按严重级别排序，并输出可读性极高的表格报告。
# 使用 kubent 扫描整个集群
kubent --output table
# 仅扫描 production 命名空间，输出 JSON 格式
kubent --namespace production --output json典型输出包含以下字段：
- KIND：资源类型（如 Deployment、Ingress）
- API_VERSION：当前使用的旧版本（如 extensions/v1beta1）
- REPLACEMENT：目标版本（如 networking.k8s.io/v1）
- NAMESPACE：资源所在命名空间
- SEVERITY：弃用严重级别（deprecated / removed）
3.2.3 pluto：双模式兼容性检查器
pluto 由 Fairwinds 开源，同时支持静态文件扫描与集群实时检测两种模式。其内置的版本兼容性数据库覆盖了从 v1.16 到最新版本的完整弃用规则，并允许用户自定义检查策略。
# 扫描本地清单目录
pluto detect-files -d ./manifests/
# 扫描当前 kubeconfig 指向的集群
pluto detect-api-resources --target-version 1.25--output wide 模式，额外显示资源创建时间与最后更新时间，便于追溯历史遗留资源。
3.2.4 fairwinds-metrics：Prometheus 原生监控方案
fairwinds-metrics 以 DaemonSet 形式部署在集群中，持续采集 API 资源的使用情况，并通过 Prometheus 指标暴露弃用信息。它适合已经建立 Prometheus + Grafana 监控体系的团队，可实现弃用资源的自动告警与趋势分析。
# 通过 Helm 安装 fairwinds-metrics
helm repo add fairwinds-stable https://charts.fairwinds.com/stable
helm install fairwinds-metrics fairwinds-stable/fairwinds-metrics \
--namespace monitoring \
--set metrics.enabled=true暴露的核心指标示例：
fairwinds_metrics_deprecated_resource_count：当前集群中弃用资源总数fairwinds_metrics_deprecated_resource_by_kind：按资源类型聚合的弃用数量fairwinds_metrics_deprecated_resource_by_namespace：按命名空间聚合的弃用数量
3.3 工具选型决策流程
以下 SVG 流程图展示了在升级节点池前，如何根据团队现状与需求选择最合适的弃用检测工具：
3.4 工具对比总结
综合检测能力、部署复杂度与运维成本，下表从六个关键维度对四款工具进行评分（1-5 分，5 分为最优）：
| 评估维度 | kubectl-convert | kubent | pluto | fairwinds-metrics |
|---|---|---|---|---|
| 检测覆盖率 | 2 | 5 | 4 | 5 |
| 部署复杂度 | 5 | 3 | 4 | 2 |
| CI/CD 集成 | 4 | 3 | 5 | 3 |
| 实时监控能力 | 1 | 2 | 2 | 5 |
| 报告可读性 | 3 | 5 | 4 | 3 |
| 社区活跃度 | 3 | 4 | 5 | 4 |