Kubernetes

kubectl是K8s官方附带的命令行工具,可以方便的操作K8s集群。

打印当前使用的API

  1. # kubectl 的主要作用就是与ApiServer进行交互, 而交互的过程, 可以通过下面的方式来打印,
  2. # 这个命令尤其适合调试自己的api接口时使用.
  3. kubectl get ns -v=9

kubectl的多样用法 - 图1

按状态筛选容器以及删除

  1. kubectl get pods --all-namespaces --field-selector status.phase=Pending -o json | \
  2. jq '.items[] | "kubectl delete pods \(.metadata.name) -n \(.metadata.namespace)"' | \
  3. xargs -n 1 bash -c
  4. # 这个命令要拆开来看
  5. # 首先, 获取所有ns中状态为Pending的pods, 并以json形式输出
  6. # 这个语句其实由很多变体, 比如,想查找Failed的状态, 或是某个deployment
  7. kubectl get pods --all-namespaces --field-selector status.phase=Pending -o json
  8. # 针对json变量进行处理, 生成可用的脚本
  9. # 这里是想介绍的重点, 利用jq以及kubectl的输出, 构建出可用的命令
  10. jq '.items[] | "kubectl delete pods \(.metadata.name) -n \(.metadata.namespace)"'
  11. # 执行每一条命令
  12. # 注意, 这种命令一定要好好调试, 删掉预期之外的pod就不好了.
  13. xargs -n 1 bash -c
  14. # 例如, 下面的语句可以找到所有的Pods并打印可以执行的语句
  15. kubectl get pods --all-namespaces --field-selector status.phase=Running -o json | \
  16. jq '.items[] | "kubectl get pods \(.metadata.name) -o wide -n \(.metadata.namespace)"'
  17. "kubectl get pods metrics-server-6d684c7b5-gtd6q -o wide -n kube-system"
  18. "kubectl get pods local-path-provisioner-58fb86bdfd-98frc -o wide -n kube-system"
  19. "kubectl get pods nginx-deployment-574b87c764-xppmx -o wide -n default"
  20. # 当然, 如果只是删除单个NS下面的一些pods, 会选择下面的方法, 但是它操作多个NS就很不方便了.
  21. kubectl -n default get pods | grep Completed | awk '{print $1}' | xargs kubectl -n default delete pods

统计具体某台机器上运行的所有pod

kubectl可以使用两种选择器,一种是label,一种是field,可以看官网的介绍:LabelsandSelectorsFieldSelectors

  1. # 它是一种选择器, 可以与上面的awk或者xargs配合使用.
  2. # 个人平时都不喜欢用这个, 直接get全部pods, 然后grep查找感觉更快
  3. kubectl get pods --all-namespaces -o wide --field-selector spec.nodeName=pve-node1

统计Pod在不同机器的具体数量分布

基于kubernetes的PaaS平台中细力度控制pods方案的实现。均衡分布的工作前提是得知pod在各个机器的分布情况。最好的办法就是得到pod信息之后进行简单的统计,这个工作可以使用awk实现。

  1. kubectl -n default get pods -o wide -l app="nginx" | awk '{print $7}'|\
  2. awk '{ count[$0]++ }
  3. END {
  4. printf("%-35s: %s\n","Word","Count");
  5. for(ind in count){
  6. printf("%-35s: %d\n",ind,count[ind]);
  7. }
  8. }'
  9. # 执行结果如下
  10. Word : Count
  11. NODE : 1
  12. pve-node1 : 1
  13. pve-node2 : 1

<font style="color:rgb(0, 0, 0);">kubectl proxy</font>的使用

可以理解为这个命令为K8s的ApiServer做了一层代理,使用该代理,可以直接调用API而不需要经过鉴权。启动之后,甚至可以实现kubectl套娃,下面是一个例子:

  1. # 当没有设置kubeconfig而直接调用kubectl时
  2. kubectl get ns -v=9
  3. # 可以打印出下面类似的错误
  4. curl -k -v -XGET -H "Accept: application/json, */*" -H "User-Agent: kubectl/v1.21.3 (linux/amd64) kubernetes/ca643a4" 'http://localhost:8080/api?timeout=32s'
  5. skipped caching discovery info due to Get "http://localhost:8080/api?timeout=32s": dial tcp 127.0.0.1:8080: connect: connection refused
  6. # 也就是说当不指定kubeconfig文件时, kubectl会默认访问本机的8080端口
  7. # 那么先启动一个kubectl proxy, 然后指定监听8080, 再使用kubectl直接访问, 是不是就可行了呢,
  8. # 事实证明, 安全与预想一致.
  9. KUBECONFIG=~/.kube/config-symv3 kubectl proxy -p 8080
  10. kubectl get ns
  11. NAME STATUS AGE
  12. default Active 127d
默认启动的proxy是屏蔽了某些api的,并且有一些限制,例如无法使用exec进入pod之中,可以使用<font style="color:black;">kubectl proxy --help</font>来看,例如
  1. # 仅允许本机访问
  2. --accept-hosts='^localhost$,^127\.0\.0\.1$,^\[::1\]$': Regular expression for hosts that the proxy should accept.
  3. # 不允许访问下面的api, 也就是说默认没法exec进入容器
  4. --reject-paths='^/api/.*/pods/.*/exec,^/api/.*/pods/.*/attach': Regular expression for paths that the proxy should reject. Paths specified here will be rejected even accepted by --accept-paths.
  5. # 想跳过exec的限制也很简单, 把reject-paths去掉就可以了
  6. kubectl proxy -p 8080 --keepalive 3600s --reject-paths='' -v=9

有人说这个kubectl proxy可能没什么作用,那可能仅仅是还没有实际的应用场景。例如当想要调试K8s dashboard代码的时候。如果直接使用kubeconfig文件,没法看到具体的请求过程,如果加上一层proxy转发,并且设置-v=9的时候,就自动获得了一个日志记录工具,在调试时相当有用。

总结

kubectl是一个强大的命令行工具,上面只是介绍了工作中对其用法的一点探索,也并不鼓励大家非要记住这些命令,只是希望当需要的时候,能够想起来kubectl可以有类似的功能,就不需要针对几个临时需求去研读client-api了。