1. 初识kubectl你的Kubernetes瑞士军刀第一次接触kubectl时我把它想象成运维人员的多功能瑞士军刀。这个命令行工具是与Kubernetes集群交互的核心入口就像Docker有docker命令一样。但kubectl的功能要强大得多——它不仅能管理容器还能调度整个分布式系统的资源。安装验证是第一步。在终端输入kubectl version --client你会看到类似这样的输出Client Version: v1.28.2 Kubernetes Version: v1.28.2如果显示command not found那就需要先安装kubectl。不同操作系统安装方式不同推荐通过官方文档安装最新稳定版。配置集群连接是关键步骤。kubectl默认会读取~/.kube/config文件来获取集群访问凭证。我刚入门时犯过的典型错误就是忘记配置这个文件导致所有命令都报Unable to connect to the server。你可以通过kubectl config view检查当前配置。一个实用的技巧是使用kubectl cluster-info快速验证集群连通性Kubernetes control plane is running at https://192.168.1.100:6443 CoreDNS is running at https://192.168.1.100:6443/api/v1/namespaces/kube-system/services/kube-dns:dns/proxy看到这样的输出说明你的kubectl已经准备好大显身手了。2. 基础命令四件套增删改查的艺术2.1 资源创建create vs applykubectl create和kubectl apply都能创建资源但实际工作中我发现它们有本质区别。create是命令式操作而apply是声明式操作。举个例子# 命令式创建不推荐长期使用 kubectl create deployment nginx --imagenginx:1.25 # 声明式应用推荐做法 kubectl apply -f nginx-deployment.yamlYAML文件才是Kubernetes的灵魂。一个好的YAML文件应该包含完整的资源定义比如这个nginx-deployment.yamlapiVersion: apps/v1 kind: Deployment metadata: name: nginx spec: replicas: 3 selector: matchLabels: app: nginx template: metadata: labels: app: nginx spec: containers: - name: nginx image: nginx:1.25 ports: - containerPort: 802.2 资源查询get的七十二变kubectl get是最常用的查询命令但很多人只用到皮毛。以下是我总结的实用技巧# 基础查询 kubectl get pods # 显示标签排查服务发现问题时特别有用 kubectl get pods --show-labels # 跨命名空间查询 kubectl get pods -A # 自定义列输出 kubectl get pods -o custom-columnsNAME:.metadata.name,STATUS:.status.phase,NODE:.spec.nodeName # JSON格式输出适合自动化处理 kubectl get pods -o json2.3 资源修改edit与patch修改运行中的资源有两种主要方式# 交互式编辑会打开默认编辑器 kubectl edit deployment/nginx # 非交互式修改适合自动化 kubectl patch deployment/nginx -p {spec:{replicas:5}}重要提示直接edit生产环境资源时要特别小心。我有次不小心改错了一个字段导致服务中断。现在我会先用kubectl get -o yaml backup.yaml备份当前配置。2.4 资源删除delete的注意事项删除操作看似简单但有些细节需要注意# 按名称删除 kubectl delete pod nginx-7cdbd8cd5b-2k4jw # 按标签删除批量操作神器 kubectl delete pods -l appnginx # 删除命名空间连带删除所有资源 kubectl delete ns test特别注意删除Deployment时默认会级联删除关联的Pod。如果只想删除Deployment保留Pod需要加上--cascadeorphan参数。3. 日常运维三板斧排障、调试、监控3.1 排障利器describe和logs当Pod状态不是Running时kubectl describe是你的第一选择kubectl describe pod nginx-7cdbd8cd5b-2k4jw这个命令会显示完整的事件历史Events我经常通过这个找到镜像拉取失败、资源不足等问题的根源。查看日志也有多种姿势# 查看最新日志 kubectl logs nginx-7cdbd8cd5b-2k4jw # 实时跟踪日志相当于tail -f kubectl logs -f nginx-7cdbd8cd5b-2k4jw # 查看崩溃容器的日志 kubectl logs --previous nginx-7cdbd8cd5b-2k4jw3.2 进入容器exec的妙用有时候需要进入容器内部排查问题# 进入容器执行bash容器内必须有bash kubectl exec -it nginx-7cdbd8cd5b-2k4jw -- bash # 直接执行命令无需交互时更方便 kubectl exec nginx-7cdbd8cd5b-2k4jw -- ls /var/log/nginx实用技巧如果Pod有多个容器需要通过-c指定容器名kubectl exec -it nginx-7cdbd8cd5b-2k4jw -c nginx -- bash3.3 资源监控top与metricsKubernetes内置了资源监控功能# 查看节点资源使用情况 kubectl top nodes # 查看Pod资源使用情况 kubectl top pods注意这些命令需要metrics-server组件支持。如果报错Metrics API not available需要先安装metrics-server。4. 高阶技巧命令组合与自动化4.1 命令组合与管道操作kubectl配合其他Linux命令能发挥更大威力# 找出所有运行失败的Pod kubectl get pods -A | grep -v Running # 批量删除Evicted状态的Pod kubectl get pods -A | grep Evicted | awk {print $1,$2} | xargs -n2 kubectl delete pod -n # 统计各命名空间的Pod数量 kubectl get pods -A -o jsonpath{range .items[*]}{.metadata.namespace}{\n}{end} | sort | uniq -c4.2 输出格式化JSONPath的魔力kubectl支持强大的JSONPath查询# 提取所有Pod的IP地址 kubectl get pods -o jsonpath{.items[*].status.podIP} # 提取指定Deployment的镜像版本 kubectl get deployment nginx -o jsonpath{.spec.template.spec.containers[0].image}4.3 实用别名与自动补全在~/.bashrc或~/.zshrc中添加这些配置能极大提升效率# 常用别名 alias kkubectl alias kgkubectl get alias kdkubectl describe alias klkubectl logs # 启用自动补全 source (kubectl completion bash) complete -o default -F __start_kubectl k5. 实战场景从部署到排障全流程5.1 完整部署一个Web应用让我们通过一个实际案例串联前面学到的命令# 1. 创建命名空间 kubectl create ns web-demo # 2. 部署应用 kubectl apply -f - EOF apiVersion: apps/v1 kind: Deployment metadata: name: web namespace: web-demo spec: replicas: 3 selector: matchLabels: app: web template: metadata: labels: app: web spec: containers: - name: web image: nginx:1.25 ports: - containerPort: 80 EOF # 3. 创建Service kubectl expose deployment web -n web-demo --port80 --target-port80 --typeNodePort # 4. 获取访问地址 kubectl get svc -n web-demo5.2 模拟故障并排查现在我们来模拟一个常见故障场景# 1. 故意设置错误的镜像版本 kubectl set image deployment/web webnginx:does-not-exist -n web-demo # 2. 观察Pod状态 kubectl get pods -n web-demo -w # 3. 查看问题详情 kubectl describe pod -n web-demo 出错的pod名称 # 4. 查看日志虽然容器没启动但kubelet会有日志 kubectl logs -n web-demo 出错的pod名称 # 5. 回滚到上一个版本 kubectl rollout undo deployment/web -n web-demo5.3 资源伸缩与更新日常运维中经常需要调整资源# 水平扩展 kubectl scale deployment web --replicas5 -n web-demo # 更新镜像版本触发滚动更新 kubectl set image deployment/web webnginx:1.26 -n web-demo # 观察更新过程 kubectl rollout status deployment/web -n web-demo # 查看更新历史 kubectl rollout history deployment/web -n web-demo6. 安全与权限管理6.1 上下文切换与多集群管理管理多个集群时上下文切换是必备技能# 查看所有上下文 kubectl config get-contexts # 切换上下文 kubectl config use-context prod-cluster # 重命名上下文 kubectl config rename-context old-name new-name6.2 RBAC权限控制kubectl也能管理RBAC权限# 创建ServiceAccount kubectl create sa ci-user -n web-demo # 创建Role kubectl create role deploy-role -n web-demo --verbcreate,get,list,update,delete --resourcedeployments # 绑定Role kubectl create rolebinding ci-binding -n web-demo --roledeploy-role --serviceaccountweb-demo:ci-user6.3 安全最佳实践使用--as参数模拟其他用户测试权限定期检查集群权限kubectl auth can-i --list敏感操作前使用--dry-runclient预演7. 插件生态与工具链7.1 常用kubectl插件kubectx快速切换集群和命名空间kubens简化命名空间切换k9s终端UI管理工具stern多Pod日志聚合查看安装方法以krew为例# 安装krew插件管理器 ( set -x; cd $(mktemp -d) OS$(uname | tr [:upper:] [:lower:]) ARCH$(uname -m | sed -e s/x86_64/amd64/ -e s/\(arm\)\(64\)\?.*/\1\2/ -e s/aarch64$/arm64/) KREWkrew-${OS}_${ARCH} curl -fsSLO https://github.com/kubernetes-sigs/krew/releases/latest/download/${KREW}.tar.gz tar zxvf ${KREW}.tar.gz ./${KREW} install krew ) # 通过krew安装插件 kubectl krew install ctx kubectl krew install ns kubectl krew install stern7.2 与CI/CD工具集成kubectl在自动化流水线中也很常见# 典型GitLab CI Job示例 deploy: stage: deploy image: bitnami/kubectl:latest script: - kubectl apply -f k8s/manifests/ only: - master安全提示永远不要在CI/CD中直接使用高权限的kubeconfig应该为每个环境创建最小权限的ServiceAccount。8. 常见问题与解决方案8.1 连接问题排查当kubectl命令卡住或报连接错误时检查集群状态kubectl get cs验证网络连通性curl -k https://API-SERVER:6443检查证书有效期openssl x509 -noout -dates -in ~/.kube/config8.2 资源状态异常Pod一直处于Pending状态的可能原因资源不足kubectl describe node查看节点资源调度约束检查kubectl get pods -o wide和节点标签PVC未绑定kubectl get pvc检查存储声明8.3 性能优化技巧大型集群中使用--chunk-size500参数分批获取资源减少不必要的watch操作对频繁执行的命令使用--cache参数9. 学习路径与资源推荐9.1 官方文档精要kubectl Cheat Sheetkubectl官方参考文档Kubernetes API文档9.2 实践建议在本地搭建Minikube环境反复练习为每个命令添加--help查看详细用法使用-v6到-v9参数查看详细API请求9.3 进阶方向学习编写kubectl插件深入理解Kubernetes API机制掌握client-go开发自定义控制器10. 真实案例一次线上故障排查去年我们遇到一个生产环境问题某个服务的Pod频繁重启。通过以下命令组合最终定位到问题# 1. 查看异常Pod kubectl get pods -n production | grep -v Running # 2. 检查Pod详情 kubectl describe pod -n production pod-name # 3. 查看日志发现OOMKilled kubectl logs --previous -n production pod-name # 4. 检查资源限制 kubectl get deployment -n production -o jsonpath{.spec.template.spec.containers[*].resources} | jq . # 5. 调整内存限制并滚动更新 kubectl patch deployment -n production my-app -p {spec:{template:{spec:{containers:[{name:app,resources:{limits:{memory:1Gi}}}]}}}}这次经历让我深刻体会到kubectl命令组合的重要性。现在我的工作流程已经形成肌肉记忆get→describe→logs→edit/patch。