SuperAPI AI 工具集

k8s-tool

部署与运维

查看项目

更新于 10-15 17:27

技能介绍

用途:k8s-tool 是 Kubernetes 工具,作为 kubectl 的封装,提供配置驱动的上下文解析和结构化命令,属于 @blogic-cz/agent-tools。

主要能力:可查看 pods、日志、describe、exec 及资源用量(top)。命令示例:bun k8s-tool kubectl --env test --cmd "get pods -n test-ns";bun k8s-tool pods --env test;bun k8s-tool logs --pod <pod> --env test --tail 50;bun k8s-tool describe --resource pod --name <pod> --env test;bun k8s-tool exec --pod <pod> --exec-cmd "ls -la" --env test;bun k8s-tool top --env test。

使用方式:通过 bun k8s-tool 运行,需将 @blogic-cz/agent-tools 作为开发依赖。禁止运行裸 kubectl,凭据守卫会阻止。认证使用现有 kubectl 上下文(kubeconfig);配置中的 Cluster ID 自动解析上下文。环境可为任意字符串(如 test、prod),在 agent-tools.json5 中设置 defaultEnvironment 可省略 --env;隐式生产访问被安全阻止。

安全边界:通用 kubectl 命令被解析为参数执行,不使用用户控制的 shell;不得使用管道、链式、替换或 shell 解释器。配置的上下文、kubeconfig、服务器、认证、TLS 和模拟设置不能在 --cmd 中覆盖。仅允许只读 config 与 auth 子命令,cluster-info dump 被阻止。Secret 读取、原始 kubeconfig 输出、文件名/kustomize 读取及 kubectl diff 被阻止。Pod exec 仅接受直接的 redis-cli PING/INFO 和 ls 诊断,通用 exec 不能读取文件内容。受限远程日志文件访问与过滤请使用 logs-tool。

提示:输出默认 TOON(节省 token),仅在机器解析时加 --format json。错误响应含 hint、nextCommand、retryable,失败时务必检查。优先使用 CLI 工具而非 MCP 工具。

限制:资料未提供收费、价格、平台与效果等细节。