基本命令

create

根据文件或标准输入(stdin)创建资源。

创建资源

kubectl create -f ./nginx.yaml

创建当前目录下的所有yaml资源

kubectl create -f .

使用多个文件创建资源

kubectl create -f ./nginx1.yaml -f ./mysql2.yaml

使用目录下的所有清单文件来创建资源

kubectl create -f ./dir

使用 url 来创建资源

kubectl create -f xxx.git.io/vxxzso.yaml

run

在集群中运行特定镜像。

创建带有终端的pod

kubectl run -i --tty busybox --image=busybox

启动一个 nginx 实例

kubectl run nginx --image=nginx

启动多个pod实例

kubectl run mybusybox --image=busybox --replicas=5

explain

获取资源的文档。

获取 pod 和 svc 的文档

kubectl explain pods,svc

get

获取所有的resources,包括nodepodnamespaceservicedeployment等,可以展示一个或者多个资源。

查看nodes节点

kubectl get nodes

通过yaml文件查询资源

kubectl get -f xxx.yaml

查询资源

kubectl get resourcequota

查询endpoints

kubectl get endpoints

查看pods

查看指定空间kube-system的pods

kubectl get po -n kube-system

查看所有空间的pods的详细信息

kubectl get pods -o wide --all-namespaces

查看指定空间kube-system的pods的详细信息

kubectl get pod -o wide --namespace=kube-system

获取指定namespace信息
kubectl get namespaces

# 获取指定namespace的yaml格式和json格式信息
kubectl get namespaces kube-system -o yaml 
kubectl get namespaces kube-system -o json
获取service(svc)

查看所有命令空间的service

kubectl get svc --all-namespaces

查看所有命令空间的service的其他写法

kubectl get services --all-namespaces

# 通过 yaml 方式导出所有 service
kubectl get service -o yaml > backup.yaml

# 通过 yaml 方式导出单个 service
kubectl get service serviceName -o yaml > backup.yaml
查询事件(Event)

kubectl get events --all-namespaces

查看某个命名空间下的事件

kubectl get events -n kube-system

查看某个命名空间下的事件,并根据关键字过滤

kubectl get events -n kube-system | grep “name”

通过lable查询

kubectl get pods -l app=nginx -o yaml|grep podIP

# 查看所有pod对于指定标签的key是否有value,有则显示,没有则空白
kubectl get pods -L apps,run

# 获取含有指定标签key的pod
kubectl get pods -l apps --show-labels

# 获取含有指定标签key=value的pod
kubectl get pods -l release=stable --show-labels

edit

在服务端编辑资源。

编辑名为 docker-registry 的 service

kubectl edit svc/docker-registry

delete

根据文件、标准输入(stdin)、资源名或者资源标签删除资源。

删除 pod.json 文件中定义的类型和名称的pod

kubectl delete -f ./pod.json

删除名为“baz”的 pod 和名为“foo”的 service

kubectl delete pod,service baz foo

删除具有 name=myLabel 标签的 pod 和 serivce

kubectl delete pods,services -l name=myLabel

删除具有 name=myLabel 标签的 pod 和 service,包括尚未初始化的

kubectl delete pods,services -l name=myLabel --include-uninitialized

删除 my-ns 命名空间下的所有 pod 和 serivce,包括尚未初始化的

kubectl -n my-ns delete po,svc --all

强制删除pod(如,prometheus-7fcfcb9f89-qkkf7)

kubectl delete pods prometheus-7fcfcb9f89-qkkf7 --grace-period=0 --force

cp

容器内与宿主机之间进行文件拷贝

# 拷贝容器内的文件或目录到本地
kubectl cp default/venus-registry-web-8cd94fc99-fws4b:demo.txt demo.txt
kubectl cp default/venus-registry-web-8cd94fc99-fws4b:/home/xxx /home/yyy

# 拷贝本地文件或目录到容器内
kubectl cp demo.txt default/venus-registry-web-8cd94fc99-fws4b:demo.txt
kubectl cp /home/yyy default/venus-registry-web-8cd94fc99-fws4b:/home/xxx

部署命令

rollout

查看修订版本(revison)的历史记录

kubectl rollout history deployment nginx-deployment

回退到指定的某个版本

如果不加–to-revision=版本号,默认情况下,回退到上一个版本。

kubectl rollout undo deployment nginx-deployment --to-revision=1

scale

程序在负载加重或缩小时副本进行扩容或缩小。

扩展副本数到4

kubectl scale rc rc-nginx-3 —replicas=4

重新缩减副本数到2

kubectl scale rc rc-nginx-3 —replicas=2

autoscale

scale虽然能够很方便的对副本数进行扩展或缩小,但是仍然需要人工介入,不能实时自动的根据系统负载对副本数进行扩、缩容。

autoscale命令提供了自动根据pod负载对其副本进行扩缩的功能。

autoscale命令会给一个rc指定一个副本数的范围,在实际运行中根据pod中运行的程序的负载自动在指定的范围内对pod进行扩容或缩容。

如前面创建的nginx,可以用如下命令指定副本范围在1~4。

kubectl autoscale rc rc-nginx-3 —min=1 —max=4

集群管理命令

cluster-info

查看集群信息

kubectl cluster-info

查看更详细的集群信息。

kubectl cluster-info dump

top

显示CPU、内存、存储资源的使用情况。

显示节点(k8s-node)资源的使用情况

kubectl top node k8s-node

显示集群所有节点的资源的使用情况

kubectl top node

显示指定命名空间(如,logging)的pod的资源的使用情况

kubectl top pod -n logging

cordon

标记节点不可调度。

标记k8s-node节点不可调度

kubectl cordon k8s-node

uncordon

标记节点可调度。

标记k8s-node节点可调度

kubectl uncordon k8s-node

drain

排除某节点,准备进行维护

排除k8s-node节点,准备进行维护

kubectl drain k8s-node

故障排查和诊断命令

describe

显示特定资源或资源组的详细信息。

当我们发现一个pod迟迟无法创建时,展示一个pod的描述

kubectl describe pod xxx

显示集群节点资源(CPU/GPU/内存)的使用情况。

kubectl describe nodes

显示集群具体某个节点(如,node-work-2)资源的使用情况。

kubectl describe node node-work-2

logs

打印Pod中一个容器的日志。

查看指定Pod的日志

kubectl logs -f kube-dns-699984412-vz1q6 -n kube-system

查看指定pod的最后10行日志

kubectl logs --tail=10 nginx

指定Pod的其中一个容器查看日志

kubectl logs kube-dns-699984412-n5zkz -c kubedns --namespace=kube-system

查看指定Pod指定容器的最后10行的滚动日志

kubectl logs -f --tail=10 kube-dns-699984412-vz1q6 -c manager -n kube-system

exec

exec命令同样类似于docker的exec命令,为在一个已经运行的容器中执行一条shell命令,如果一个pod容器中,有多个容器,需要使用-c选项指定容器。

进入容器

kubectl exec -it codeleak-github-cron-1567581840-zsqpc /bin/bash

在指定命名空间(如,ns)已存在的容器中执行命令(只有一个容器的情况下)

kubectl exec nginx-pod -n ns – ls /

在已存在的容器中执行命令(pod 中有多个容器的情况下,需要指定具体那个容器)

kubectl exec nginx-pod -c my-container – ls /

注意: shell命令前,要加--号,不然shell命令中的参数,不能识别

高级命令

apply

按文件名或标准输入(stdin)将配置应用于资源

更新资源

kubectl apply -f rc-nginx.yaml

将控制台输入的JSON配置应用到Pod

cat pod.json | kubectl apply -f -

设置命令

label

更新(增加、修改或删除)资源上的标签。

如果–overwrite 为 true,则可以覆盖已有的 label,否则尝试覆盖 label 将会报错。

如果指定了–resource-version,则更新将使用此资源版本,否则将使用现有的资源版本。

Label命名规范:

label 必须以字母或数字开头,可以使用字母、数字、连字符、点和下划线,最长63个字符。

操作节点标签:

# 查看所有节点和lable
kubectl get nodes --show-labels

# 为某个节点增加lable
kubectl label nodes 10.126.72.31 points=test

# 给节点node01添加disk标签
kubectl label nodes node01 disk=ssd      

# 修改节点node01的标签
kubectl label nodes node01 disk=sss –overwrite   

# 删除节点node01的disk标签
kubectl label nodes node01 disk-

操作pod标签:

# 给名为 tomcat 的 Pod 添加 label app=tomcat。
kubectl label pods tomca app=tomcat

# 把名为 tomcat 的Pod修改label 为 app=tomcat1,且覆盖现有的value
kubectl label --overwrite pods tomcat app=tomcat1

# 把 namespace 中的所有 pod 添加 label
kubectl label pods --all test=test

# 删除名为“app”的 label 。(使用“ - ”减号相连)
kubectl label pods tomcat app-

annotate

更新资源的Annotations信息。

更新pod(如,foo),设置其注解’description’的值为’my frontend’。

kubectl annotate pods foo description=‘my frontend’

注:如果同一个注解被赋值了多次,只保存最后一次设置的值。

其他命令

version

查看客户端和服务端的版本信息。

kubectl version

api-versions

以“组/版本”的格式输出服务端支持的API版本。

kubectl api-versions

api-resources

输出服务端API支持的资源类型。

kubectl api-resources