SuperAPI AI 工具集

gitops-cluster-debug

测试与质量

查看项目

更新于 10-15 21:43

技能介绍

用途:在实时 Kubernetes 集群上调试 Flux CD GitOps 流水线,通过 flux-operator-mcp 的 MCP 工具连接集群、获取 Flux 与 Kubernetes 资源、分析状态条件、查看日志并定位根因。

主要能力:覆盖 Flux 安装检查、HelmRelease、Kustomization、ResourceSet、Source(GitRepository/OCIRepository/HelmRepository/HelmChart/Bucket)、镜像自动化、通知以及 Kubernetes 日志分析等调试流程;可切换 kubeconfig 上下文、按需加载 flux-crds.md 与 troubleshooting.md 参考文件,并输出含摘要、资源分析、依赖链、根因与建议的 Markdown 报告。

使用方式:先调用 get_kubeconfig_contexts 列出上下文,用 set_kubeconfig_context 切换,再调用 get_flux_instance 确认 Flux Operator 状态与版本;用 get_kubernetes_api_versions 确认 apiVersion,用 get_kubernetes_resources 获取资源,用 get_kubernetes_logs 读取日志。创建或更新资源时生成 YAML 并调用 apply_kubernetes_manifest,目标资源受 Flux 管理时需 overwrite 为 true,且仅在用户明确要求时才应用。生成 YAML 前应依据 assets/schemas/ 下的字段索引核对字段名与嵌套。

限制:无法读取 Kubernetes Secret 的值,MCP 仅返回键名而值为空;若集群未安装 Flux 或 MCP 服务不可用,需提示用户并给出安装命令;被 suspend 的资源不会调和,Ready: Unknown 且 Progressing 表示正在调和,应等待完成;带 fluxcd 标签的资源由 Flux 管理,手动修改会在下次调和时被还原。具体安装命令与更多细节资料中暂未提供。