AgentSkillsCN

kubectl-cli

Kubernetes CLI在AKS与ARO集群管理中的应用

SKILL.md
--- frontmatter
name: kubectl-cli
description: Kubernetes CLI operations for AKS and ARO cluster management
version: "1.0.0"
license: MIT
tools_required: ["kubectl", "kubelogin"]
min_versions:
  kubectl: "1.28.0"

When to Use

  • •Cluster health verification
  • •Resource deployment and management
  • •Troubleshooting pod issues
  • •Viewing logs and events

Prerequisites

  • •kubectl installed and configured
  • •KUBECONFIG set to valid config
  • •kubelogin for Azure AD authentication
  • •Appropriate RBAC permissions

Commands

Cluster Health

bash
# Cluster info
kubectl cluster-info

# Node status
kubectl get nodes -o wide

# System pods
kubectl get pods -n kube-system

# Unhealthy pods across all namespaces
kubectl get pods -A --field-selector=status.phase!=Running,status.phase!=Succeeded

Resource Management

bash
# Dry-run before apply
kubectl apply -f manifest.yaml --dry-run=client -o yaml

# Diff changes
kubectl diff -f manifest.yaml

# Apply with recording
kubectl apply -f manifest.yaml --record

# Delete with grace
kubectl delete -f manifest.yaml --grace-period=30

Troubleshooting

bash
# Describe pod
kubectl describe pod <pod-name> -n <namespace>

# Pod logs (current)
kubectl logs -f <pod-name> -n <namespace>

# Pod logs (previous crash)
kubectl logs <pod-name> -n <namespace> --previous

# Events by time
kubectl get events -n <namespace> --sort-by='.lastTimestamp'

# Exec into pod
kubectl exec -it <pod-name> -n <namespace> -- /bin/sh

Resource Queries

bash
# Get all resources in namespace
kubectl get all -n <namespace> -o wide

# Get resource as YAML
kubectl get deployment <name> -n <namespace> -o yaml

# Resource usage
kubectl top pods -n <namespace>
kubectl top nodes

Best Practices

  1. •ALWAYS use --dry-run=client before apply
  2. •ALWAYS specify namespace with -n
  3. •Use labels for selection: -l app=myapp
  4. •Check events when pods fail
  5. •Use kubectl diff for change preview
  6. •NEVER delete without explicit namespace

Output Format

  1. •Command executed
  2. •Resource status summary
  3. •Any warnings or errors
  4. •Recommended actions

Integration with Agents

Used by: @platform, @devops, @sre, @validation