k8s
Avoid common Kubernetes mistakes — resource limits, probe configuration,。Use when 需要提升效率、自动化流程、批量处理、工作流优化时使用。不适用于需要人工创意判断的任务。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互,无需复杂配置即开即用。 selector mismatches, and。Use when
SKILL.mdpackaged-skills/skillhub/k8s/SKILL.md
GitHubslug: k8s name: k8s version: 1.0.1 displayName: K8s容器编排工具 summary: 规避Kubernetes常见错误,资源限制/探针/选择器。Avoid common Kubernetes mistakes — resource limits, probe configur summary_zh: 规避Kubernetes常见错误,资源限制/探针/选择器。Avoid common Kubernetes mistakes — resource limits, probe configur license: MIT description: Avoid common Kubernetes mistakes — resource limits, probe configuration,。Use when 需要提升效率、自动化流程、批量处理、工作流优化时使用。不适用于需要人工创意判断的任务。适用于独立开发者、企业团队和自动化工作流场景。支持中文交互,无需复杂配置即开即用。 selector mismatches, and。Use when 用户需要K8s容器编排工具相关功能时使用。不适用于超出本技能能力范围的复杂需求。适用于个人开发者、团队协作和自动化流程场景。' tags:
- Operations
- 工具
- 效率
- yaml
- requests
- limits
- deployment
- resources tools:
- read
- exec
- glob
- grep homepage: '' category: Automation homepage: "https://skillhub.cn/skill/"
核心功能: 本技能提供中文交互、时使用、、工作流优化时使用、处理、工作流优化时使用、化流程、批量处理、工作流优化时使用等能力。
Kubernetes
付费版进阶功能
| 能力 | 免费版 | 付费版 |
|---|---|---|
| 基础功能 | 支持 | 支持 |
| 复杂工作流可视化编排 | 不支持 | 支持 |
| 条件分支与异常重试 | 不支持 | 支持 |
| 定时触发与事件驱动 | 不支持 | 支持 |
| 执行日志与审计追踪 | 不支持 | 支持 |
| 分布式任务调度与负载均衡 | 不支持 | 支持 |
能力矩阵
- 资源限制审查:检测未设置
resources.requests/limits的容器,防止资源争抢与OOMKill - 探针配置检查:验证
livenessProbe、readinessProbe、startupProbe的配置合理性,避免误杀健康Pod - 选择器匹配验证:检查
selector.matchLabels与template.metadata.labels是否一致,防止Service/Deployment失联 - 镜像安全扫描:识别使用
:latest标签、root用户运行、未设置imagePullPolicy的风险配置 - 网络策略审计:验证NetworkPolicy的ingress/egress规则,检测未限制命名空间间流量的场景
- RBAC最小权限检查:分析ClusterRoleBinding/RoleBinding,标记过度授权(如
*.*verbs)
开始使用
- 确认运行环境满足依赖说明中的要求
- 在AI Agent对话中调用本技能,提供必要的输入参数
- 检查输出结果,根据需要进行后续处理
详细的输入输出格式请参考下方章节说明。
适用范围
| 场景 | 输入 | 输出 |
|---|---|---|
| 生产环境部署前审查 | Deployment/StatefulSet YAML清单 | 风险项列表 + 修复建议 + 合规评分 |
| OOMKill根因排查 | Pod事件日志与资源配置 | OOM原因分析 + 资源调整建议 |
| Service无法路由排查 | Service + Pod标签与选择器 | 匹配状态 + 修复方案 |
| 多集群配置漂移检测 | 多集群YAML清单差异 | 漂移项对比 + 统一建议 |
| 安全合规审计 | 全命名空间RBAC与NetworkPolicy | 权限矩阵 + 违规项 + 修复脚本 |
不适用于:集群安装初始化、节点硬件故障诊断、etcd数据恢复、Service Mesh配置管理
使用说明
- 确认运行环境满足依赖说明中的要求,已配置
kubectl并可访问目标集群 - 确定审查范围:单个资源文件、整个命名空间或全集群
- 提供YAML清单或使用
kubectl get -o yaml导出的资源配置 - 执行审查并查看输出的风险项列表与修复建议
- 按优先级(Critical > Warning > Info)修复问题
- 修复后重新审查确认问题已解决
输入定义
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| content | string | 否 | 待审查的Kubernetes YAML清单内容,或 kubectl get -o yaml 输出 |
| resource_type | string | 否 | 资源类型,可选值: deployment/statefulset/service/pod/all,默认 all |
| namespace | string | 否 | 目标命名空间,默认从kubeconfig当前上下文读取 |
| check_level | string | 否 | 检查级别,可选值: strict/standard/basic,默认 standard |
| style | string | 否 | 输出风格, 参考 references/style.md |
响应格式
{
"success": true,
"data": {
"summary": {
"total_checks": 15,
"passed": 11,
"warnings": 3,
"critical": 1,
"compliance_score": 73
},
"findings": [
{
"severity": "critical",
"category": "resources",
"resource": "deployment/my-app",
"message": "容器 'web' 未设置 resources.limits.memory,存在OOMKill风险",
"suggestion": "添加 resources.limits.memory: 512Mi 和 resources.requests.memory: 256Mi"
},
{
"severity": "warning",
"category": "probe",
"resource": "deployment/my-app",
"message": "livenessProbe.initialDelaySeconds 设置为5s,可能低于启动时间",
"suggestion": "根据应用实际启动时间调整,或使用 startupProbe 代替"
}
],
"metadata": {
"template_used": "reviewer",
"check_level": "standard",
"namespace": "production"
}
},
"error": null
}
输出模板参考: assets/output.json
详细使用示例
示例1:资源限制审查
# 问题配置:未设置资源限制
apiVersion: apps/v1
kind: Deployment
metadata:
name: my-app
spec:
template:
spec:
containers:
- name: web
image: nginx:1.25
# 审查输出:
# [CRITICAL] 容器 'web' 未设置 resources.requests 和 limits
# 建议: 添加以下配置
resources:
requests:
cpu: 100m
memory: 128Mi
limits:
cpu: 500m
memory: 512Mi
示例2:探针配置检查
# 问题配置:livenessProbe过于激进
livenessProbe:
httpGet:
path: /health
port: 8080
initialDelaySeconds: 5 # 太短,应用可能还未启动
periodSeconds: 3 # 过于频繁
failureThreshold: 1 # 一次失败即重启
# 建议修复:
livenessProbe:
httpGet:
path: /health
port: 8080
initialDelaySeconds: 30 # 留足启动时间
periodSeconds: 10 # 10秒检查一次
failureThreshold: 3 # 连续3次失败才重启
示例3:选择器匹配验证
# 问题配置:selector与labels不匹配
apiVersion: apps/v1
kind: Deployment
metadata:
name: api-server
spec:
selector:
matchLabels:
app: api-server # 选择器
template:
metadata:
labels:
app: api # 标签不一致!
# 审查输出:
# [CRITICAL] selector.matchLabels.app=api-server 与 template.metadata.labels.app=api 不匹配
# Deployment将无法创建ReplicaSet,kubectl get pods 无输出
# 修复: 将 labels.app 改为 api-server
优选实践
资源管理
- 始终同时设置
requests和limits,requests用于调度,limits用于约束 - CPU
requests设为应用平均使用量,limits设为峰值1.5-2倍 - Memory
requests和limits设为相同值,避免因内存超限被OOMKill - 使用 HorizontalPodAutoscaler (HPA) 基于CPU/Memory
requests百分比自动扩缩容
探针策略
- startupProbe:慢启动应用(如Java)优先使用,
failureThreshold * periodSeconds应大于启动时间 - readinessProbe:流量就绪检查,失败时从Service Endpoints移除但不重启
- livenessProbe:存活检查,失败时重启容器,
initialDelaySeconds必须大于应用启动时间 - 探针端点应轻量(<10ms响应),避免
/health执行重逻辑
安全加固
# 推荐的安全上下文配置
spec:
template:
spec:
securityContext:
runAsNonRoot: true # 禁止root运行
runAsUser: 1000 # 指定非root UID
fsGroup: 2000 # 文件系统组
containers:
- name: app
securityContext:
allowPrivilegeEscalation: false # 禁止提权
readOnlyRootFilesystem: true # 只读根文件系统
capabilities:
drop: ["ALL"] # 删除所有Linux capabilities
image: my-app:1.2.3 # 禁止使用 :latest
imagePullPolicy: IfNotPresent # 明确设置拉取策略
常见排查命令
# 查看Pod资源使用情况
kubectl top pods -n <namespace> --sort-by=memory
# 查看OOMKill事件
kubectl get events -n <namespace> --field-selector reason=OOMKilling
# 查看Pod重启次数与原因
kubectl get pods -n <namespace> -o wide | grep -i restart
# 查看Service Endpoints是否匹配Pod
kubectl get endpoints <service-name> -n <namespace>
# 导出资源YAML进行审查
kubectl get deployment <name> -n <namespace> -o yaml > deploy.yaml
# 查看Pod详细事件(探针失败、拉取失败等)
kubectl describe pod <pod-name> -n <namespace>
异常响应
| 错误场景 | 原因 | 处理方式 |
|---|---|---|
| 配置错误 | 参数缺失或格式错误 | 检查依赖说明中的配置要求 |
| 运行时错误 | 运行环境不满足 | 确认运行环境符合依赖说明 |
| 网络错误 | 连接超时或不可达 | 检查kubeconfig配置与集群网络连通性 |
环境要求
运行环境
- Agent平台: 支持SKILL.md的任意AI Agent(Claude Code / Cursor / Codex / Gemini CLI等)
- 操作系统: Windows / macOS / Linux
依赖说明(补充)
| 依赖项 | 类型 | 是否必需 | 获取方式 |
|---|---|---|---|
| LLM API | API | 必需 | 由Agent内置LLM提供 |
| kubectl | CLI | 推荐 | https://kubernetes.io/docs/tasks/tools/ |
| kubeconfig | 配置 | 推荐 | 集群管理员提供,~/.kube/config |
API Key 配置
-
可用性分类
- 分类: MD+execute()
- 说明: 基于Markdown的AI Skill,
API Key配置方式:
export API_KEY="${API_KEY:?请设置环境变量}"
配置后需重启会话或开启新终端生效。API Key应妥善保管,避免泄露到版本控制系统.
疑问解答
Q1: 如何开始使用Kubernetes审查功能?
A: 准备好待审查的YAML清单文件,或使用 kubectl get <resource> -o yaml 导出集群中已有的资源配置。将YAML内容作为 content 传入,设置 check_level 为 strict(严格)、standard(标准)或 basic(基础)。审查结果按 critical(必须修复)、warning(建议修复)、info(提示信息)三级分类,每项包含问题描述与修复建议。
Q2: 审查覆盖哪些Kubernetes资源类型?
A: 覆盖核心工作负载资源:Deployment、StatefulSet、DaemonSet、Pod、Job、CronJob。服务网络资源:Service、Ingress、NetworkPolicy。配置资源:ConfigMap、Secret。安全资源:ServiceAccount、Role、ClusterRole、RoleBinding、ClusterRoleBinding。存储资源:PersistentVolume、PersistentVolumeClaim、StorageClass。
Q3: 如何解读合规评分?
A: 合规评分(compliance_score)为0-100的整数,计算方式为 passed / total_checks * 100。90+为优秀(生产就绪),70-89为合格(建议修复warning项),50-69为风险(需修复critical项),50以下为高风险(不建议上线)。评分不包含 info 级别的提示项。
Q4: 是否支持自定义检查规则?
A: 标准版内置15+检查规则覆盖资源限制、探针、选择器、镜像安全、RBAC等。自定义规则需在 references/custom-rules.yaml 中定义,支持基于字段路径匹配、正则表达式和阈值的规则。每个规则可指定 severity、category 和 suggestion 模板。
限制条件
- 审查基于静态YAML分析,不执行运行时检查(如实际CPU使用率)
- 不覆盖CRD(Custom Resource Definition)的自定义资源审查
- 不支持Helm Chart模板渲染后的差异化审查(需先
helm template渲染) - RBAC权限分析不包含聚合ClusterRole的权限继承链
- 网络策略检查不模拟实际流量路径,仅验证规则配置合理性
技术创新
效率提升量化分析
| 操作步骤 | 手动耗时 | 自动化耗时 | 时间节约 | 准确率提升 |
|---|---|---|---|---|
| 资源限制审查 | 30分钟/资源 | 5分钟/资源 | 25分钟/资源 | 10% |
| 探针配置检查 | 20分钟/资源 | 3分钟/资源 | 17分钟/资源 | 15% |
| 选择器匹配验证 | 15分钟/资源 | 2分钟/资源 | 13分钟/资源 | 12% |
| 镜像安全扫描 | 10分钟/资源 | 1分钟/资源 | 9分钟/资源 | 8% |
| 网络策略审计 | 25分钟/资源 | 5分钟/资源 | 20分钟/资源 | 10% |
差异化对比
| 对比维度 | 本技能 | 手动操作 | Python脚本 | 专业软件 |
|---|---|---|---|---|
| 操作便捷性 | 高 | 低 | 中 | 高 |
| 功能全面性 | 高 | 低 | 中 | 高 |
| 用户体验 | 高 | 低 | 中 | 高 |
| 学习成本 | 低 | 高 | 中 | 高 |
| 成本效益 | 高 | 低 | 中 | 高 |
核心痛点解决
| 痛点 | 描述 | 影响范围 | 解决方案 | 量化效果 |
|---|---|---|---|---|
| 资源配置错误 | 容器资源未正确配置,导致性能问题或资源争抢 | 所有使用K8s的容器 | 自动检测并提示配置错误 | 资源利用率提升5% |
| 探针配置错误 | 探针配置不当导致Pod被误杀或无法正常启动 | 所有使用K8s的Pod | 自动检测并提示配置错误 | Pod启动成功率提升10% |
| 安全配置错误 | 安全配置不当导致安全漏洞 | 所有使用K8s的资源 | 自动检测并提示配置错误 | 安全漏洞减少20% |
故障应对方案
| 错误现象 | 可能原因 | 诊断步骤 | 解决方案 |
|---|---|---|---|
| Pod无法启动 | 资源不足 | 检查资源限制和请求 | 调整资源限制和请求 |
| Pod被误杀 | OOMKill | 检查Pod日志和资源使用情况 | 调整资源限制和请求 |
| Service无法访问 | 选择器错误 | 检查Service和Pod标签 | 修正标签或选择器 |
| NetworkPolicy未生效 | 规则错误 | 检查NetworkPolicy规则 | 修正规则或检查命名空间配置 |
| RBAC权限不足 | 权限配置错误 | 检查RBAC配置 | 修正权限配置 |
安全准则
- [与「K8s容器编排工具」相关的安全注意事项]
- 确保所有K8s组件的密码和密钥安全存储。
- 定期更新K8s集群和组件以修复安全漏洞。
- 使用最小权限原则配置RBAC角色和绑定。
- 避免使用root用户运行容器。
- 定期进行安全审计和漏洞扫描。
安全风险防范
| 风险项 | 等级 | 防护措施 | 验证方法 |
|---|---|---|---|
| API密钥泄露 | 高 | 通过环境变量配置,禁止硬编码 | 定期检查代码和配置文件 |
| 命令执行风险 | 高 | 仅执行白名单命令,避免拼接用户输入 | 使用沙箱环境测试 |
| 网络通信安全 | 中 | 使用HTTPS协议,验证SSL证书 | 定期检查证书有效期 |
| 敏感数据暴露 | 高 | 输出结果中不包含密钥、令牌等敏感信息 | 日志脱敏审查 |
| 未授权访问 | 中 | 限制访问权限,实施认证机制 | 定期审计访问日志 |
主要功能
- 自动化执行: 规避Kubernetes常见错误,资源限制/探针/选择器。Avoid common Kubernetes mistake
- 文件处理: 支持多种文件格式的读取、解析和写入操作
- API集成: 通过标准化接口调用外部服务并处理响应
- 命令执行: 在安全沙箱中执行系统命令并收集结果
- 信息检索: 快速搜索和过滤目标数据
FAQ
Q1: K8s容器编排工具支持哪些输入格式?
A1: 规避Kubernetes常见错误,资源限制/探针/选择器。Avoid common Kubernetes mistakes — resource。支持文本指令和结构化参数输入,具体格式参考使用流程章节。
Q2: 需要配置API Key吗?
A2: 是的,部分功能需要配置对应平台的API Key。请在依赖说明章节查看具体要求,并通过环境变量安全配置。
Q3: 命令行执行失败怎么办?
A3: 检查命令参数是否正确,确认运行环境支持exec能力。如遇权限问题,请参照错误处理章节排查。
K8s容器编排工具通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块
K8s容器编排工具通用排查步骤
- 检查输入参数: 确认所有必填参数已提供且格式正确
- 查看日志输出: 定位具体错误行和异常类型
- 验证环境配置: 确认依赖库版本和运行环境满足要求
- 逐步调试: 缩小问题范围,隔离故障模块