kubectl

核心用法

kubectl-skill 是 Kubernetes 官方命令行工具 kubectl 的 AI 代理封装技能，提供对 K8s 集群的完整管理能力。核心功能涵盖五大维度：

1. 资源查询与监控

• 获取 Pod、Deployment、Service、Node 等资源状态
• 支持多命名空间（-A）、标签筛选（-l）、多种输出格式（JSON/YAML/JSONPath）
• 实时 Watch 模式与事件追踪

2. 应用生命周期管理

• apply/create 部署资源，支持 --dry-run 安全验证
• set image 滚动更新镜像，scale 弹性扩缩容
• rollout status/undo/pause/resume 完整发布控制

3. 调试与排障

• logs 查看容器日志（支持 -f 实时跟随、--previous 崩溃前日志）
• exec 进入容器执行命令，获取交互式 Shell
• describe 查看资源详情与事件溯源

4. 配置管理

• 多集群上下文切换（config use-context）
• kubeconfig 环境变量与路径管理
• 命名空间隔离与资源配额操作

5. 运维操作

• drain/uncordon/cordon 节点维护与调度控制
• 标签、污点、亲和性等高级调度配置

显著优点

• 权威性极高：Kubernetes 官方维护，云原生事实标准，生态兼容性 100%
• 功能完备：覆盖 K8s 全部 API 操作，单工具完成从开发到生产全流程
• Dry-run 安全机制：client/server 双模式预检，降低误操作风险
• 输出灵活：JSONPath/自定义列/JQ 管道，便于自动化脚本集成
• 跨平台：原生支持 macOS、Linux、Windows（WSL）

潜在局限性与风险

• 权限敏感：直接操作生产集群需严格 RBAC 控制，误删/误改可能导致服务中断
• 版本兼容性：kubectl 与集群版本差异可能引发 API 行为不一致（建议保持 ±1 版本内）
• 无内置审计：命令执行记录依赖外部日志系统，关键操作建议配合审计策略
• 学习曲线陡峭：200+ 子命令与复杂资源模型，新手易混淆类似命令（如 apply vs create）
• 网络依赖：需稳定连接至集群 API Server，离线场景受限

适合人群

• DevOps/SRE 工程师：日常集群运维与故障响应
• 平台工程师：构建 GitOps 工作流与自动化流水线
• 后端开发者：本地调试微服务、查看日志与执行容器内命令
• 云架构师：多集群管理与配置标准化

常规风险提示

| 风险等级 | 场景 | 建议措施 |

|---------|------|---------|

| 🔴 高危 | `delete -f` 生产命名空间、`drain` 未设 PDB 的节点 | 强制 `--dry-run=server` 预检、配置 PodDisruptionBudget |

| 🟡 中危 | `apply` 覆盖他人配置、`scale` 至 0 导致服务中断 | 配合 `kubectl diff` 对比变更、设置 HPA 最小副本 |

| 🟢 低危 | 日志查看、describe 等只读操作 | 绑定只读 RBAC Role 即可 |

最佳实践：生产环境操作前，务必执行 kubectl config current-context 确认目标集群，并优先使用 --dry-run=client 验证 YAML 有效性。

核心用法

kubectl-skill 是一款面向 Kubernetes 集群管理的纯文档型参考工具，旨在帮助用户高效执行容器编排与集群运维任务。其核心功能覆盖六大领域：资源查询（pods、nodes、services 等）、应用部署（apply、create、set image）、调试排障（logs、exec、describe）、配置管理（context、namespace 切换）、健康监控（rollout status、events）以及运维操作（scale、drain、uncordon）。

该 skill 采用模块化设计，通过丰富的命令示例与场景化工作流（如 Debug Pod、Deploy New Version、Node Maintenance）降低 kubectl 学习曲线。支持多种输出格式（json/yaml/wide/custom-columns）和 dry-run 模式，便于安全验证操作。附带 4 个辅助脚本实现常见任务的自动化处理。

显著优点

1. 安全纯文档架构：100% Markdown 文档，无动态代码执行，杜绝 eval/exec 等危险函数，静态分析得分 90+
2. 权威标准对齐：严格遵循 kubectl v1.20+ 官方规范，命令示例经 CNCF Kubernetes 项目验证
3. 实用场景覆盖：涵盖日常运维 90% 以上高频操作，从日志追踪到滚动更新均有标准化流程
4. 防御性设计：强制推荐 --dry-run=client 预演机制，节点维护脚本含交互式确认，降低误操作风险
5. 零依赖负担：仅依赖系统预装的 kubectl 二进制，无第三方库引入，依赖审计得分 95

潜在局限

1. 功能边界限制：仅为命令参考与辅助脚本，不具备可视化界面或自动故障恢复能力
2. 权限依赖外部：实际集群操作受 kubeconfig 权限约束，skill 本身无法突破 RBAC 限制
3. T3 来源可信度：由个人开发者维护，非企业级背书，长期更新保障弱于 CNCF 官方项目
4. 脚本错误处理待完善：当前辅助脚本缺乏严格的参数校验与完善的错误捕获机制

适合人群

• DevOps/SRE 工程师：日常集群巡检、发布部署、故障排查
• 云原生开发者：容器化应用开发阶段的资源调试与配置验证
• K8s 学习者：通过结构化示例快速掌握 kubectl 核心命令体系
• 平台运维团队：制定标准化运维脚本与操作规范的参考基准

常规风险

• 误操作风险：kubectl 命令直接作用于生产集群，错误配置可能导致服务中断（已 mitigated by dry-run 推荐）
• 凭证泄露风险：kubeconfig 文件权限管理不当可能导致集群访问凭证暴露（skill 本身无此问题，属使用环境风险）
• 节点维护风险：drain/uncordon 操作若未遵循规范流程，可能引发服务可用性下降