SuperAPI AI 工具集
合作ENAI 行业资讯收藏
Skill 广场kubectl-skill

kubectl-skill

部署与运维

查看项目

更新于 10-16 07:11

技能介绍

用途

kubectl-skill 用于让智能体通过 kubectl 命令行工具执行 Kubernetes 集群管理操作。它覆盖从资源查询、应用部署到故障排查与日常运维的常见任务。

主要能力

  • 查询资源：列出并查看 Pod、Deployment、Service、Node 等资源的详细信息。
  • 部署与更新：创建、apply、patch 和更新 Kubernetes 资源。
  • 调试与排障：查看日志、在容器内执行命令、检查事件。
  • 管理配置：更新 kubeconfig、切换上下文、管理命名空间。
  • 监控健康：检查资源用量、发布状态、事件和 Pod 状况。
  • 执行运维操作：扩缩容 Deployment、排空节点、管理污点与标签。

前置条件

  • 已安装 kubectl 二进制文件并可在 PATH 中访问（v1.20+）。
  • 已配置包含集群凭据的 kubeconfig 文件（默认：~/.kube/config）。
  • 与 Kubernetes 集群保持有效连接。

安装与验证

macOS：

brew install kubernetes-cli

Linux：

apt-get install -y kubectl  # Ubuntu/Debian
yum install -y kubectl      # RHEL/CentOS

验证：

kubectl version --client
kubectl cluster-info  # Test connection

使用方式

查询资源

kubectl get pods                    # List all pods in current namespace
kubectl get pods -A                 # All namespaces
kubectl get pods -o wide            # More columns
kubectl get nodes                   # List nodes
kubectl describe pod POD_NAME        # Detailed info with events

查看日志

kubectl logs POD_NAME                # Get logs
kubectl logs -f POD_NAME             # Follow logs (tail -f)
kubectl logs POD_NAME -c CONTAINER   # Specific container
kubectl logs POD_NAME --previous     # Previous container logs

执行命令

kubectl exec -it POD_NAME -- /bin/bash   # Interactive shell
kubectl exec POD_NAME -- COMMAND         # Run single command

部署应用

kubectl apply -f deployment.yaml         # Apply config
kubectl create -f deployment.yaml        # Create resource
kubectl apply -f deployment.yaml --dry-run=client  # Test

更新应用

kubectl set image deployment/APP IMAGE=IMAGE:TAG  # Update image
kubectl scale deployment/APP --replicas=3          # Scale pods
kubectl rollout status deployment/APP              # Check status
kubectl rollout undo deployment/APP                # Rollback

管理配置

kubectl config view                  # Show kubeconfig
kubectl config get-contexts          # List contexts
kubectl config use-context CONTEXT   # Switch context

常见工作流

调试 Pod

# 1. Identify the issue
kubectl describe pod POD_NAME

# 2. Check logs
kubectl logs POD_NAME
kubectl logs POD_NAME --previous

# 3. Execute debug commands
kubectl exec -it POD_NAME -- /bin/bash

# 4. Check events
kubectl get events --sort-by='.lastTimestamp'

部署新版本

# 1. Update image
kubectl set image deployment/MY_APP my-app=my-app:v2

# 2. Monitor rollout
kubectl rollout status deployment/MY_APP -w

# 3. Verify
kubectl get pods -l app=my-app

# 4. Rollback if needed
kubectl rollout undo deployment/MY_APP

节点维护准备

# 1. Drain node (evicts all pods)
kubectl drain NODE_NAME --ignore-daemonsets

# 2. Do maintenance
# ...

# 3. Bring back online
kubectl uncordon NODE_NAME

输出格式

--output（-o）标志支持多种格式：

  • table — 默认表格格式
  • wide — 带额外列的扩展表格
  • json — JSON 格式（便于配合 jq 使用）
  • yaml — YAML 格式
  • jsonpath — JSONPath 表达式
  • custom-columns — 自定义输出列
  • name — 仅资源名称

示例：

kubectl get pods -o json | jq '.items[0].metadata.name'
kubectl get pods -o jsonpath='{.items[*].metadata.name}'
kubectl get pods -o custom-columns=NAME:.metadata.name,STATUS:.status.phase

全局标志（适用于所有命令）

-n, --namespace=<ns>           # Operate in specific namespace
-A, --all-namespaces           # Operate across all namespaces
--context=<context>            # Use specific kubeconfig context
-o, --output=<format>          # Output format (json, yaml, table, etc.)
--dry-run=<mode>               # Dry-run mode (none, client, server)
-l, --selector=<labels>        # Filter by labels
--field-selector=<selector>    # Filter by fields
-v, --v=<int>                  # Verbosity level (0-9)

Dry-Run 模式

  • --dry-run=client — 快速的客户端校验（安全测试命令）
  • --dry-run=server — 服务端校验（更准确）
  • --dry-run=none — 真实执行（默认）

建议先用 --dry-run=client 测试：

kubectl apply -f manifest.yaml --dry-run=client

进阶主题

更详细的参考资料、逐命令文档、故障排查指南和进阶工作流见：

  • references/REFERENCE.md — 完整的 kubectl 命令参考
  • scripts/ — 常见任务的辅助脚本

实用技巧

使用标签选择器进行批量操作：

kubectl delete pods -l app=myapp
kubectl get pods -l env=prod,tier=backend

实时监视资源：

kubectl get pods -w  # Watch for changes

使用 -A 标志查看所有命名空间：

kubectl get pods -A  # See pods everywhere

保存输出以便后续对比：

kubectl get deployment my-app -o yaml > deployment-backup.yaml

删除前先检查：

kubectl delete pod POD_NAME --dry-run=client

获取帮助

kubectl help                      # General help
kubectl COMMAND --help            # Command help
kubectl explain pods              # Resource documentation
kubectl explain pods.spec         # Field documentation

环境变量

  • KUBECONFIG — kubeconfig 文件路径（可包含多个路径，以 : 分隔）
  • KUBECTL_CONTEXT — 覆盖默认上下文

适用场景与限制

该技能适用于需要通过 kubectl 自动化执行 Kubernetes 集群查询、部署、调试、配置管理与运维操作的场景。使用前提是已安装 kubectl（v1.20+）、配置好 kubeconfig 并保持与集群的有效连接。关于收费、价格、平台支持范围等具体信息，资料中暂未提供。

版本：1.0.0 许可证：MIT 兼容：kubectl v1.20+、Kubernetes v1.20+