K8S常用命令

1. 创建资源

一般创建资源会有两种方式：通过文件或者命令创建。

  1. # 通过文件创建一个Deployment
  2. kubectl create -f /path/to/deployment.yaml
  3. cat /path/to/deployment.yaml | kubectl create -f -
  4. # 不过一般可能更常用下面的命令来创建资源
  5. kubectl apply -f /path/to/deployment.yaml
  7. # 通过kubectl命令直接创建
  8. kubectl run nginx_app --image=nginx:1.9.1 --replicas=3

kubectl还提供了一些更新资源的命令，比如kubectl edit、kubectl patch和kubectl replace等。

  1. # kubectl edit：相当于先用get去获取资源，然后进行更新，最后对更新后的资源进行apply
  2. kubectl edit deployment/nginx_app
  4. # kubectl patch：使用补丁修改、更新某个资源的字段，比如更新某个node
  5. kubectl patch node/node-0 -p '{"spec":{"unschedulable":true}}'
  6. kubectl patch -f node-0.json -p '{"spec": {"unschedulable": "true"}}'
  8. # kubectl replace：使用配置文件来替换资源
  9. kubectl replace -f /path/to/new_nginx_app.yaml

2. 查看资源

获取不同种类资源的信息。

  1. # 一般命令的格式会如下：
  2. kubectl get <resource_type>
  3. # 比如获取K8s集群下pod的信息
  4. kubectl get pod
  5. # 更加详细的信息
  6. kubectl get pod -o wide
  7. # 指定资源的信息，格式：kubectl get <resource_type>/<resource_name>，比如获取deployment nginx_app的信息
  8. kubectl get deployment/nginx_app -o wide
  9. # 也可以对指定的资源进行格式化输出，比如输出格式为json、yaml等
  10. kubectl get deployment/nginx_app -o json
  11. # 还可以对输出结果进行自定义，比如对pod只输出容器名称和镜像名称
  12. kubectl get pod httpd-app-5bc589d9f7-rnhj7 -o custom-columns=CONTAINER:.spec.containers[0].name,IMAGE:.spec.containers[0].image
  13. # 获取某个特定key的值还可以输入如下命令得到，此目录参照go template的用法，且命令结尾'\n'是为了输出结果换行
  14. kubectl get pod httpd-app-5bc589d9f7-rnhj7 -o template --template='{{(index spec.containers 0).name}}{{"\n"}}'
  15. # 还有一些可选项可以对结果进行过滤，这儿就不一一列举了，如有兴趣，可参照kubectl get --help说明

3. 部署命令集

部署命令包括资源的运行管理命令、扩容和缩容命令和自动扩缩容命令。

3.1 rollout命令

管理资源的运行，比如deployment、Daemonet、StatefulSet等资源。

  • 查看部署状态：比如更新deployment/nginx_app中容器的镜像后查看其更新的状态。
  1. kubectl set image deployment/nginx_app nginx=nginx:1.9.1
  2. kubectl rollout status deployment/nginx_app
  • 资源的暂停及恢复：发出一次或多次更新前暂停一个 Deployment，然后再恢复它，这样就能在Deployment暂停期间进行多次修复工作，而不会发出不必要的 rollout。
  1. # 暂停
  2. kubectl rollout pause deployment/nginx_app
  3. # 完成所有的更新操作命令后进行恢复
  4. kubectl rollout resume deployment/nginx_app
  • 回滚：如上对一个Deployment的image做了更新，但是如果遇到更新失败或误更新等情况时可以对其进行回滚。
  1. # 回滚之前先查看历史版本信息
  2. kubectl rollout history deployment/nginx_app
  3. # 回滚
  4. kubectl rollout undo deployment/nginx_app
  5. # 当然也可以指定版本号回滚至指定版本
  6. kubectl rollout undo deployment/nginx_app --to-revision=<version_index>

3.2 scale命令

对一个Deployment、RS、StatefulSet进行扩/缩容。

  1. # 扩容
  2. kubectl scale deployment/nginx_app --replicas=5
  3. # 如果是缩容，把对应的副本数设置的比当前的副本数小即可
  4. # 另外，还可以针对当前的副本数目做条件限制，比如当前副本数是5则进行缩容至副本数目为3
  5. kubectl scale --current-replicas=5 --replicas=3 deployment/nginx_app

3.3 autoscale命令

通过创建一个autoscaler，可以自动选择和设置在K8s集群中Pod的数量。

  1. # 基于CPU的使用率创建3-10个pod
  2. kubectl autoscale deployment/nginx_app --min=3 --max=10 --cpu_percent=80

4. 集群管理命令

4.1 cordon & uncordon命令

设置是否能够将pod调度到该节点上。

  1. # 不可调度
  2. kubectl cordon node-0
  4. # 当某个节点需要维护时，可以驱逐该节点上的所有pods(会删除节点上的pod，并且自动通过上面命令设置
  5. # 该节点不可调度，然后在其他可用节点重新启动pods)
  6. kubectl drain node-0
  7. # 待其维护完成后，可再设置该节点为可调度
  8. kubectl uncordon node-0

4.2 taint命令

目前仅能作用于节点资源，一般这个命令通常会结合pod的tolerations字段结合使用，对于没有设置对应toleration的pod是不会调度到有该taint的节点上的，这样就可以避免pod被调度到不合适的节点上。一个节点的taint一般会包括key、value和effect(effect只能在NoSchedule, PreferNoSchedule, NoExecute中取值)。

  1. # 设置taint
  2. kubecl taint nodes node-0 key1=value1:NoSchedule
  3. # 移除taint
  4. kubecl taint nodes node-0 key1:NoSchedule-

如果pod想要被调度到上述设置了taint的节点node-0上，则需要在该pod的spec的tolerations字段设置：

  1. tolerations:
  2. - key: "key1"
  3.   operator: "Equal"
  4.   value: "value1"
  5.   effect: "NoSchedule"
  7. # 或者
  8. tolerations:
  9. - key: "key1"
  10.   operator: "Exists"
  11.   effect: "NoSchedule"

5. 其它

  1. # 映射端口允许外部访问
  2. kubectl expose deployment/nginx_app --type='NodePort' --port=80
  3. # 然后通过kubectl get services -o wide来查看被随机映射的端口
  4. # 如此就可以通过node的外部IP和端口来访问nginx服务了
  6. # 转发本地端口访问Pod的应用服务程序
  7. kubectl port-forward nginx_app_pod_0 8090:80
  8. # 如此，本地可以访问：curl -i localhost:8090
  10. # 在创建或启动某些资源的时候没有达到预期结果，可以使用如下命令先简单进行故障定位
  11. kubectl describe deployment/nginx_app
  12. kubectl logs nginx_pods
  13. kubectl exec nginx_pod -c nginx-app <command>
  15. # 集群内部调用接口(比如用curl命令)，可以采用代理的方式，根据返回的ip及端口作为baseurl
  16. kubectl proxy &
  18. # 查看K8s支持的完整资源列表
  19. kubectl api-resources
  21. # 查看K8s支持的api版本
  22. kubectl api-versions

6.命令大全

  1. #查看所有namespace的pods运行情况
  2. kubectl get pods --all-namespaces 
  3. #查看具体pods，记得后边跟namespace名字哦
  4. kubectl get pods  kubernetes-dashboard-76479d66bb-nj8wr --namespace=kube-system
  5. # 查看pods具体信息
  6. kubectl get pods -o wide kubernetes-dashboard-76479d66bb-nj8wr --namespace=kube-system
  7. # 查看集群健康状态
  8. kubectl get cs
  9. # 获取所有deployment
  10. kubectl get deployment --all-namespaces
  11. # 查看kube-system namespace下面的pod/svc/deployment 等等（-o wide 选项可以查看存在哪个对应的节点）
  12. kubectl get pod /svc/deployment -n kube-system
  13. # 列出该 namespace 中的所有 pod 包括未初始化的
  14. kubectl get pods --include-uninitialized
  15. # 查看deployment()
  16. kubectl get deployment nginx-app
  17. # 查看rc和servers
  18. kubectl get rc,services
  19. # 查看pods结构信息（重点，通过这个看日志分析错误）
  20. # 对控制器和服务，node同样有效
  21. kubectl describe pods xxxxpodsname --namespace=xxxnamespace
  22. # 其他控制器类似吧，就是kubectl get 控制器 控制器具体名称
  23. # 查看pod日志
  24. kubectl logs $POD_NAME
  25. # 查看pod变量
  26. kubectl exec my-nginx-5j8ok -- printenv | grep SERVICE
  27. # 集群
  28. kubectl get cs           # 集群健康情况
  29. kubectl cluster-info     # 集群核心组件运行情况
  30. kubectl get namespaces    # 表空间名
  31. kubectl version           # 版本
  32. kubectl api-versions      # API
  33. kubectl get events       # 查看事件
  34. kubectl get nodes      //获取全部节点
  35. kubectl delete node k8s2  //删除节点
  36. kubectl rollout status deploy nginx-test
  37. kubectl get deployment --all-namespaces
  38. kubectl get svc --all-namespaces
  40. # 创建
  41. kubectl create -f ./nginx.yaml           # 创建资源
  42. kubectl apply -f xxx.yaml （创建+更新，可以重复使用）
  43. kubectl create -f .                            # 创建当前目录下的所有yaml资源
  44. kubectl create -f ./nginx1.yaml -f ./mysql2.yaml     # 使用多个文件创建资源
  45. kubectl create -f ./dir                        # 使用目录下的所有清单文件来创建资源
  46. kubectl create -f https://git.io/vPieo         # 使用 url 来创建资源
  47. kubectl run -i --tty busybox --image=busybox    ----创建带有终端的pod
  48. kubectl run nginx --image=nginx                # 启动一个 nginx 实例
  49. kubectl run mybusybox --image=busybox --replicas=5    ----启动多个pod
  50. kubectl explain pods,svc                       # 获取 pod 和 svc 的文档
  52. # 更新
  53. kubectl rolling-update python-v1 -f python-v2.json           # 滚动更新 pod frontend-v1
  54. kubectl rolling-update python-v1 python-v2 --image=image:v2  # 更新资源名称并更新镜像
  55. kubectl rolling-update python --image=image:v2                 # 更新 frontend pod 中的镜像
  56. kubectl rolling-update python-v1 python-v2 --rollback        # 退出已存在的进行中的滚动更新
  57. cat pod.json | kubectl replace -f -                              # 基于 stdin 输入的 JSON 替换 pod
  58. # 为 nginx RC 创建服务，启用本地 80 端口连接到容器上的 8000 端口
  59. kubectl expose rc nginx --port=80 --target-port=8000
  61. # 更新单容器 pod 的镜像版本（tag）到 v4
  62. kubectl get pod nginx-pod -o yaml | sed 's/(image: myimage):.*$/1:v4/' | kubectl replace -f -
  63. kubectl label pods nginx-pod new-label=awesome                      # 添加标签
  64. kubectl annotate pods nginx-pod icon-url=http://goo.gl/XXBTWq       # 添加注解
  65. kubectl autoscale deployment foo --min=2 --max=10                # 自动扩展 deployment “foo”
  67. # 编辑资源
  68. kubectl edit svc/docker-registry                      # 编辑名为 docker-registry 的 service
  69. KUBE_EDITOR="nano" kubectl edit svc/docker-registry   # 使用其它编辑器
  70. vim /etc/systemd/system/kubelet.service.d/10-kubeadm.conf #修改启动参数
  72. # 动态伸缩pod
  73. kubectl scale --replicas=3 rs/foo                                 # 将foo副本集变成3个
  74. kubectl scale --replicas=3 -f foo.yaml                            # 缩放“foo”中指定的资源。
  75. kubectl scale --current-replicas=2 --replicas=3 deployment/mysql  # 将deployment/mysql从2个变成3个
  76. kubectl scale --replicas=5 rc/foo rc/bar rc/baz                   # 变更多个控制器的数量
  77. kubectl rollout status deploy deployment/mysql                         # 查看变更进度
  79. #label 操作
  80. kubectl label：添加label值 kubectl label nodes node1 zone=north #增加节点lable值 spec.nodeSelector: zone: north #指定pod在哪个节点
  81. kubectl label pod redis-master-1033017107-q47hh role=master #增加lable值 [key]=[value]
  82. kubectl label pod redis-master-1033017107-q47hh role- #删除lable值
  83. kubectl label pod redis-master-1033017107-q47hh role=backend --overwrite #修改lable值
  85. # 滚动升级
  86. kubectl rolling-update：滚动升级 kubectl rolling-update redis-master -f redis-master-controller-v2.yaml #配置文件滚动升级
  87. kubectl rolling-update redis-master --image=redis-master:2.0 #命令升级
  88. kubectl rolling-update redis-master --image=redis-master:1.0 --rollback #pod版本回滚
  90. # etcdctl 常用操作
  91. etcdctl cluster-health #检查网络集群健康状态
  92. etcdctl --endpoints=https://192.168.71.221:2379 cluster-health #带有安全认证检查网络集群健康状态
  93. etcdctl member list
  94. etcdctl set /k8s/network/config ‘{ “Network”: “10.1.0.0/16” }’
  95. etcdctl get /k8s/network/config
  97. # 删除
  98. kubectl delete pod -l app=flannel -n kube-system   # 根据label删除：
  99. kubectl delete -f ./pod.json                                              # 删除 pod.json 文件中定义的类型和名称的 pod
  100. kubectl delete pod,service baz foo                                        # 删除名为“baz”的 pod 和名为“foo”的 service
  101. kubectl delete pods,services -l name=myLabel                              # 删除具有 name=myLabel 标签的 pod 和 serivce
  102. kubectl delete pods,services -l name=myLabel --include-uninitialized      # 删除具有 name=myLabel 标签的 pod 和 service，包括尚未初始化的
  103. kubectl -n my-ns delete po,svc --all      # 删除 my-ns namespace下的所有 pod 和 serivce，包括尚未初始化的
  104. kubectl delete pods prometheus-7fcfcb9f89-qkkf7 --grace-period=0 --force 强制删除
  105. kubectl delete deployment kubernetes-dashboard --namespace=kube-system
  106. kubectl delete svc kubernetes-dashboard --namespace=kube-system
  107. kubectl delete -f kubernetes-dashboard.yaml
  108. kubectl replace --force -f ./pod.json # 强制替换，删除后重新创建资源。会导致服务中断。
  110. # 交互
  111. kubectl logs nginx-pod                                 # dump 输出 pod 的日志（stdout）
  112. kubectl logs nginx-pod -c my-container                 # dump 输出 pod 中容器的日志（stdout，pod 中有多个容器的情况下使用）
  113. kubectl logs -f nginx-pod                              # 流式输出 pod 的日志（stdout）
  114. kubectl logs -f nginx-pod -c my-container              # 流式输出 pod 中容器的日志（stdout，pod 中有多个容器的情况下使用）
  115. kubectl run -i --tty busybox --image=busybox -- sh  # 交互式 shell 的方式运行 pod
  116. kubectl attach nginx-pod -i                            # 连接到运行中的容器
  117. kubectl port-forward nginx-pod 5000:6000               # 转发 pod 中的 6000 端口到本地的 5000 端口
  118. kubectl exec nginx-pod -- ls /                         # 在已存在的容器中执行命令（只有一个容器的情况下）
  119. kubectl exec nginx-pod -c my-container -- ls /         # 在已存在的容器中执行命令（pod 中有多个容器的情况下）
  120. kubectl top pod POD_NAME --containers               # 显示指定 pod和容器的指标度量
  121. kubectl exec -ti podName /bin/bash     # 进入pod
  123. # 调度配置
  124. kubectl cordon k8s-node                                                # 标记 my-node 不可调度
  125. kubectl drain k8s-node                                                 # 清空 my-node 以待维护
  126. kubectl uncordon k8s-node                                              # 标记 my-node 可调度
  127. kubectl top node k8s-node                                              # 显示 my-node 的指标度量
  128. kubectl cluster-info dump                                             # 将当前集群状态输出到 stdout                                    
  129. kubectl cluster-info dump --output-directory=/path/to/cluster-state   # 将当前集群状态输出到 /path/to/cluster-state
  130. #如果该键和影响的污点（taint）已存在，则使用指定的值替换
  131. kubectl taint nodes foo dedicated=special-user:NoSchedule
  132. #查看kubelet进程启动参数
  133. ps -ef | grep kubelet
  134. # 查看日志:
  135. journalctl -u kubelet -f
  137. 导出配置文件：
  138. 　　导出proxy
  139. 　　kubectl get ds -n kube-system -l k8s-app=kube-proxy -o yaml>kube-proxy-ds.yaml
  140. 　　导出kube-dns
  141. 　　kubectl get deployment -n kube-system -l k8s-app=kube-dns -o yaml >kube-dns-dp.yaml
  142. 　　kubectl get services -n kube-system -l k8s-app=kube-dns -o yaml >kube-dns-services.yaml
  143. 　　导出所有 configmap
  144. 　　kubectl get configmap -n kube-system -o wide -o yaml > configmap.yaml
  146. 复杂操作命令：
  147. 　删除kube-system 下Evicted状态的所有pod：
  148. kubectl get pods -n kube-system |grep Evicted| awk ‘{print $1}’|xargs kubectl delete pod -n kube-system
  149. 以下为维护环境相关命令：
  150. 重启kubelet服务
  151. systemctl daemon-reload
  152. systemctl restart kubelet