kubectl常用命令大全详解

这是我转载的一个博主写的 K8s 常用命令大全，里面详细介绍了 K8s 的命令。如果看了我写的入门基础篇文章，想了解更多命令可以看以下的文章。

说明

Kubernetes kubectl 命令表【中文网址】
Kubernetes kubectl 命令表

要使用和维护Kubernetes集群，最常用且直接的方式，就是使用自带的命令行工具Kubectl。
下面图片是一个总览，熟悉后可以用于勾起记忆。

注：下面命令虽然整理的相对较全，但知道这些命令并不等于知道kucectl的使用了，还是很有必要系统的学习k8s，熟悉整个流程，下面命令更适合当手册使用，你知道你要干什么，记不住命令，ok没问题，来这ctrl+f搜索关键字即可，也可以当复习用，加深命令的作用。

基础命令详解：create、delete、get、run、expose、set、explain、edit

create 命令：根据文件或者输入来创建资源

创建Deployment和Service资源

[root@master ~]# kubectl create -f demo-deployment.yaml
[root@master ~]# kubectl create -f demo-service.yaml

delete 命令：删除资源

根据yaml文件删除对应的资源，但是yaml文件并不会被删除，这样更加高效

[root@master ~]# kubectl delete -f demo-deployment.yaml 
[root@master ~]# kubectl delete -f demo-service.yaml

也可以通过具体的资源名称来进行删除，使用这个删除资源，同时删除deployment和service资源

[root@master ~]# kubectl delete 具体的资源名称

get 命令 ：获得资源信息

查看所有ns空间的pod

kubectl get pod --all-namespaces和kubectl get pods -A一样效果，都是查看所有命名空间的pod【可以加上-owide，查看运行在哪个主机上】。

[root@master ~]# kubectl get all
[root@master ~]# kubectl get pod --all-namespaces
#下面就是详细信息了
[root@master1-163 ~]# kubectl get pods -A -owide
NAMESPACE     NAME                                       READY   STATUS    RESTARTS   AGE   IP               NODE          NOMINATED NODE   READINESS GATES
kube-system   calico-kube-controllers-78d6f96c7b-nwbmt   1/1     Running   0          16h   10.244.139.67    worker-165    <none>           <none>
kube-system   calico-node-nh977                          1/1     Running   0          16h   192.168.59.162   master2-162   <none>           <none>
kube-system   calico-node-s89tx                          1/1     Running   1          16h   192.168.59.163   master1-163   <none>           <none>
kube-system   calico-node-vt5dn                          1/1     Running   0          16h   192.168.59.165   worker-165    <none>           <none>
kube-system   coredns-545d6fc579-6l9xs                   1/1     Running   0          22h   10.244.139.66    worker-165    <none>           <none>
kube-system   coredns-545d6fc579-mrm2w                   1/1     Running   0          22h   10.244.139.65    worker-165    <none>           <none>
kube-system   kube-apiserver-master1-163                 1/1     Running   2          22h   192.168.59.163   master1-163   <none>           <none>
kube-system   kube-apiserver-master2-162                 1/1     Running   1          21h   192.168.59.162   master2-162   <none>           <none>
kube-system   kube-controller-manager-master1-163        1/1     Running   2          22h   192.168.59.163   master1-163   <none>           <none>
kube-system   kube-controller-manager-master2-162        1/1     Running   1          21h   192.168.59.162   master2-162   <none>           <none>
kube-system   kube-proxy-kp8p6                           1/1     Running   1          21h   192.168.59.162   master2-162   <none>           <none>
kube-system   kube-proxy-kqg72                           1/1     Running   2          22h   192.168.59.163   master1-163   <none>           <none>
kube-system   kube-proxy-nftgv                           1/1     Running   0          17h   192.168.59.165   worker-165    <none>           <none>
kube-system   kube-scheduler-master1-163                 1/1     Running   2          22h   192.168.59.163   master1-163   <none>           <none>
kube-system   kube-scheduler-master2-162                 1/1     Running   1          21h   192.168.59.162   master2-162   <none>           <none>
[root@master1-163 ~]# 

查看指定命名空间 pod 列表

查看所有命名空间

[root@master ~]# kubectl get ns
NAME              STATUS   AGE
default           Active   4d6h
kube-node-lease   Active   4d6h
kube-public       Active   4d6h
kube-system       Active   4d6h
[root@master ~]# 

在-n跟上命名空间【如果不知道为什么要指定，接着往下看即可】

[root@master ~]# kubectl get pod -n kube-system 
NAME                                       READY   STATUS    RESTARTS   AGE
...
kube-scheduler-master                      1/1     Running   12         4d6h
metrics-server-bcfb98c76-w87q9             1/1     Running   0          35m
[root@master ~]# 

查看pod列表

这个命令查看的默认名称是：kube-public

[root@master ~]# kubectl get pod 

但如果pod不是运行在kube-public上，就需要指定名称才能查看了，否则报错。

查看pod报错：No resources found in kube-public namespace.

先说一下查看pod运行在哪个命名空间上的命令：kubectl get pod --all-namespaces -o wide【不加 --all-namespaces就是仅查看当前所在命名空间的pod了】
结果中NAMESPACE就是了。

[root@master ~]# kubectl get pod  --all-namespaces -o wide
NAMESPACE     NAME                                       READY   STATUS    RESTARTS   AGE    IP               NODE     NOMINATED NODE   READINESS GATES
kube-system   calico-kube-controllers-78d6f96c7b-p4svs   1/1     Running   0          4d5h   10.244.219.67    master   <none>           <none>
...

上面说过，如果pod运行的空间不是kube-public，直接执行 kubectl get pod就会报错，这时候需要加上-n并跟上命名名称【这个名称就是上面看到的NAMESPACE】

[root@master ~]# kubectl get ns # 这个命令是查看所有命名空间
NAME              STATUS   AGE
default           Active   4d6h
kube-node-lease   Active   4d6h
kube-public       Active   4d6h
kube-system       Active   4d6h
[root@master ~]# 
[root@master ~]# kubectl get pod
No resources found in default namespace.
[root@master ~]# 
[root@master ~]# kubectl get pod -n kube-system 
NAME                                       READY   STATUS    RESTARTS   AGE
calico-kube-controllers-78d6f96c7b-p4svs   1/1     Running   0          4d5h
calico-node-cc4fc                          1/1     Running   18         4d4h
calico-node-stdfj                          1/1     Running   20         4d5h
calico-node-zhhz7                          1/1     Running   1          4d5h
coredns-545d6fc579-6kb9x                   1/1     Running   0          4d6h
coredns-545d6fc579-v74hg                   1/1     Running   0          4d6h
etcd-master                                1/1     Running   1          4d6h
kube-apiserver-master                      1/1     Running   1          4d6h
kube-controller-manager-master             1/1     Running   11         4d6h
kube-proxy-45qgd                           1/1     Running   1          4d4h
kube-proxy-fdhpw                           1/1     Running   1          4d6h
kube-proxy-zf6nt                           1/1     Running   1          4d6h
kube-scheduler-master                      1/1     Running   12         4d6h
metrics-server-bcfb98c76-w87q9             1/1     Running   0          25m
[root@master ~]# 

显示pod节点的标签信息

[root@master ~]# kubectl get pod --show-labels

根据指定标签匹配到具体的pod

[root@master ~]# kubectl get pods -l app=example

查看node节点列表

[root@master ~]# kubectl get node
[root@master ~]# kubectl get nodes

显示node节点的标签信息

[root@master ~]# kubectl get node --show-labels

查看pod详细信息，也就是可以查看pod具体运行在哪个节点上（ip地址信息）

[root@master ~]# kubectl get pod -o wide

查看服务的详细信息，显示了服务名称，类型，集群ip，端口，时间等信息

[root@master ~]# kubectl get svc
[root@master ~]# kubectl get svc -n kube-system

查看所有命名空间

[root@master ~]# kubectl get ns
[root@master ~]# kubectl get namespaces

查看所有pod所属的命名空间

[root@master ~]# kubectl get pod --all-namespaces

查看所有pod所属的命名空间并且查看都在哪些节点上运行

[root@master ~]# kubectl get pod --all-namespaces  -o wide

查看目前所有的replica set，显示了所有的pod的副本数，以及他们的可用数量以及状态等信息

[root@master ~]# kubectl get rs

查看已经部署了的所有应用，可以看到容器，以及容器所用的镜像，标签等信息

[root@master ~]# kubectl get deploy -o wide
[root@master ~]# kubectl get deployments -o wide

查看事件【get ev】

具体使用场景未知，我是在做【Kubernetes】k8s的健康性检查详细说明中readiness probe时候使用到这个命令了，记录一下。

[root@master probe]# kubectl get ev | tail -n 10
15m         Normal    Scheduled   pod/pod6            Successfully assigned probe/pod6 to node2
15m         Normal    Pulled      pod/pod6            Container image "nginx" already present on machine
15m         Normal    Created     pod/pod6            Created container liveness
15m         Normal    Started     pod/pod6            Started container liveness
13m         Normal    Killing     pod/pod6            Stopping container liveness
12m         Normal    Scheduled   pod/pod6            Successfully assigned probe/pod6 to node2
12m         Normal    Pulled      pod/pod6            Container image "nginx" already present on machine
12m         Normal    Created     pod/pod6            Created container liveness
12m         Normal    Started     pod/pod6            Started container liveness
1s          Warning   Unhealthy   pod/pod6            Readiness probe failed: cat: /tmp/healthy: No such file or directory
[root@master probe]# 

run 命令：在集群中创建并运行一个或多个容器镜像。

语法：

run NAME --image=image [--env="key=value"] [--port=port] [--replicas=replicas] [--dry-run=bool] [--overrides=inline-json] [--command] -- [COMMAND] [args...]
# 示例，运行一个名称为nginx，副本数为3，标签为app=example，镜像为nginx:1.10，端口为80的容器实例

[root@master ~]# kubectl run nginx --replicas=3 --labels="app=example" --image=nginx:1.10 --port=80

# 示例，运行一个名称为nginx，副本数为3，标签为app=example，镜像为nginx:1.10，端口为80的容器实例，并绑定到k8s-node1上
[root@master ~]# kubectl run nginx --image=nginx:1.10 --replicas=3 --labels="app=example" --port=80 --overrides='{"apiVersion":"apps/v1","spec":{"template":{"spec":{"nodeSelector":{"kubernetes.io/hostname":"k8s-node1"}}}}}'

更详细用法参见：http://docs.kubernetes.org.cn/468.html

expose 命令：创建一个service服务，并且暴露端口让外部可以访问

创建一个nginx服务并且暴露端口让外界可以访问

[root@master ~]# kubectl expose deployment nginx --port=88 --type=NodePort --target-port=80 --name=nginx-service

更多expose详细用法参见：http://docs.kubernetes.org.cn/475.html

set 命令：配置应用的一些特定资源，也可以修改应用已有的资源

语法

[root@master ~]# set SUBCOMMAND

使用 kubectl set --help查看

它的子命令

• env
• image
• resources
• selector
• serviceaccount
• subject。

set 命令详情参见：http://docs.kubernetes.org.cn/669.html

kubectl set resources 命令

语法：

resources (-f FILENAME | TYPE NAME) ([--limits=LIMITS & --requests=REQUESTS]

• 这个命令用于设置资源的一些范围限制。
• 资源对象中的Pod可以指定计算资源需求（CPU-单位m、内存-单位Mi），即使用的最小资源请求（Requests），限制（Limits）的最大资源需求，Pod将保证使用在设置的资源数量范围。
• 对于每个Pod资源，如果指定了Limits（限制）值，并省略了Requests（请求），则Requests默认为Limits的值。
• 可用资源对象包括(支持大小写)：replicationcontroller、deployment、daemonset、job、replicaset。

例如：

# 将deployment的nginx容器cpu限制为“200m”，将内存设置为“512Mi”
[root@master ~]# kubectl set resources deployment nginx -c=nginx --limits=cpu=200m,memory=512Mi

# 设置所有nginx容器中 Requests和Limits
[root@master ~]# kubectl set resources deployment nginx --limits=cpu=200m,memory=512Mi --requests=cpu=100m,memory=256Mi

# 删除nginx中容器的计算资源值
[root@master ~]# kubectl set resources deployment nginx --limits=cpu=0,memory=0 --requests=cpu=0,memory=0

kubectl set selector 命令

• 设置资源的 selector（选择器）。如果在调用"set selector"命令之前已经存在选择器，则新创建的选择器将覆盖原来的选择器。
• selector必须以字母或数字开头，最多包含63个字符，可使用：字母、数字、连字符" - " 、点".“和下划线” _ "。如果指定了–resource-version，则更新将使用此资源版本，否则将使用现有的资源版本。
• 注意：目前selector命令只能用于Service对象。

语法：

selector (-f FILENAME | TYPE NAME) EXPRESSIONS [--resource-version=version]

kubectl set image 命令

• ​用于更新现有资源的容器镜像。
• 可用资源对象包括：pod (po)、replicationcontroller (rc)、deployment (deploy)、daemonset (ds)、job、replicaset (rs)。

语法： ```c image (-f FILENAME | TYPE NAME) CONTAINER_NAME_1=CONTAINER_IMAGE_1 ... CONTAINER_NAME_N=CONTAINER_IMAGE_N ```

# 将deployment中的nginx容器镜像设置为“nginx：1.9.1”
[root@master ~]# kubectl set image deployment/nginx busybox=busybox nginx=nginx:1.9.1

# 所有deployment和rc的nginx容器镜像更新为“nginx：1.9.1”
[root@master ~]# kubectl set image deployments,rc nginx=nginx:1.9.1 --all

# 将daemonset abc的所有容器镜像更新为“nginx：1.9.1”
[root@master ~]# kubectl set image daemonset abc *=nginx:1.9.1

# 从本地文件中更新nginx容器镜像
[root@master ~]# kubectl set image -f path/to/file.yaml nginx=nginx:1.9.1 --local -o yaml

explain 命令：用于显示资源文档信息

[root@master ~]# kubectl explain rs

edit 命令: 用于编辑资源信息

编辑Deployment nginx的一些信息

[root@master ~]# kubectl edit deployment nginx

编辑service类型的nginx的一些信息

[root@master ~]# kubectl edit service/nginx

设置命令说明label，annotate，completion

label命令: 用于更新（增加、修改或删除）资源上的 label（标签）

• label 必须以字母或数字开头，可以使用字母、数字、连字符、点和下划线，最长63个字符。
• 如果 --overwrite 为 true，则可以覆盖已有的label，否则尝试覆盖label将会报错。
• 如果指定了--resource-version，则更新将使用此资源版本，否则将使用现有的资源版本。

语法：

label [--overwrite] (-f FILENAME | TYPE NAME) KEY_1=VAL_1 ... KEY_N=VAL_N [--resource-version=version]

给名为foo的Pod添加label unhealthy=true

[root@master ~]# kubectl label pods foo unhealthy=true

给名为foo的Pod修改label 为 ‘status’ / value ‘unhealthy’，且覆盖现有的value

[root@master ~]# kubectl label --overwrite pods foo status=unhealthy

给 namespace 中的所有 pod 添加 label

[root@master ~]# kubectl label  pods --all status=unhealthy

仅当resource-version=1时才更新 名为foo的Pod上的label

[root@master ~]# kubectl label pods foo status=unhealthy --resource-version=1

删除名为“bar”的label 。（使用“ - ”减号相连）

[root@master ~]# kubectl label pods foo bar-

annotate命令：更新一个或多个资源的Annotations信息。也就是注解信息，可以方便的查看做了哪些操作。

• Annotations由key/value组成。
• Annotations的目的是存储辅助数据，特别是通过工具和系统扩展操作的数据，更多介绍在这里。
• 如果–overwrite为true，现有的annotations可以被覆盖，否则试图覆盖annotations将会报错。
• 如果设置了–resource-version，则更新将使用此resource version，否则将使用原有的resource version。

语法：

annotate [--overwrite] (-f FILENAME | TYPE NAME) KEY_1=VAL_1 ... KEY_N=VAL_N [--resource-version=version]

更新Pod“foo”，设置annotation “description”的value “my frontend”，如果同一个annotation多次设置，则只使用最后设置的value值

[root@master ~]# kubectl annotate pods foo description=‘my frontend’

根据“pod.json”中的type和name更新pod的annotation

[root@master ~]# kubectl annotate -f pod.json description='my frontend'

更新Pod"foo"，设置annotation“description”的value“my frontend running nginx”，覆盖现有的值

[root@master ~]# kubectl annotate --overwrite pods foo description='my frontend running nginx'

更新 namespace中的所有pod

[root@master ~]# kubectl annotate pods --all description='my frontend running nginx'

只有当resource-version为1时，才更新pod ‘foo’

[root@master ~]# kubectl annotate pods foo description='my frontend running nginx' --resource-version=1

通过删除名为“description”的annotations来更新pod ‘foo’。 不需要 -overwrite flag。

[root@master ~]# kubectl annotate pods foo description-

completion命令：用于设置 kubectl 命令自动补全

BASH

# 在 bash 中设置当前 shell 的自动补全，要先安装 bash-completion 包
[root@master ~]# source <(kubectl completion bash)

# 在您的 bash shell 中永久的添加自动补全
[root@master ~]# echo "source <(kubectl completion bash)" >> ~/.bashrc 

ZSH

# 在 zsh 中设置当前 shell 的自动补全
[root@master ~]# source <(kubectl completion zsh)  

# 在您的 zsh shell 中永久的添加自动补全
[root@master ~]# echo "if [ [root@master ~]#commands[kubectl] ]; then source <(kubectl completion zsh); fi" >> ~/.zshrc 

kubectl 部署命令：rollout，rolling-update，scale，autoscale

rollout 命令: 用于对资源进行管理

• 可用资源包括：deployments，daemonsets。
• 子命令：
  • history（查看历史版本）
  • pause（暂停资源）
  • resume（恢复暂停资源）
  • status（查看资源状态）
  • undo（回滚版本）

语法

[root@master ~]# kubectl rollout SUBCOMMAND

回滚到之前的deployment

[root@master ~]# kubectl rollout undo deployment/abc

查看daemonet的状态

[root@master ~]# kubectl rollout status daemonset/foo

rolling-update命令: 执行指定ReplicationController的滚动更新。

该命令创建了一个新的RC， 然后一次更新一个pod方式逐步使用新的PodTemplate，最终实现Pod滚动更新，new-controller.json需要与之前RC在相同的namespace下。

语法：

rolling-update OLD_CONTROLLER_NAME ([NEW_CONTROLLER_NAME] --image=NEW_CONTAINER_IMAGE | -f NEW_CONTROLLER_SPEC)

使用frontend-v2.json中的新RC数据更新frontend-v1的pod

[root@master ~]# kubectl rolling-update frontend-v1 -f frontend-v2.json

使用JSON数据更新frontend-v1的pod

[root@master ~]# cat frontend-v2.json | kubectl rolling-update frontend-v1 -f -

其他的一些滚动更新

[root@master ~]# kubectl rolling-update frontend-v1 frontend-v2 --image=image:v2

[root@master ~]# kubectl rolling-update frontend --image=image:v2

[root@master ~]# kubectl rolling-update frontend-v1 frontend-v2 --rollback

scale命令：扩容或缩容 Deployment、ReplicaSet、Replication Controller或 Job 中Pod数量

scale也可以指定多个前提条件，如：当前副本数量或 --resource-version ，进行伸缩比例设置前，系统会先验证前提条件是否成立。这个就是弹性伸缩策略。

语法：

kubectl scale [--resource-version=version] [--current-replicas=count] --replicas=COUNT (-f FILENAME | TYPE NAME)

将名为foo中的pod副本数设置为3。

[root@master ~]# kubectl scale --replicas=3 rs/foo
kubectl scale deploy/nginx --replicas=30

将由“foo.yaml”配置文件中指定的资源对象和名称标识的Pod资源副本设为3

[root@master ~]# kubectl scale --replicas=3 -f foo.yaml

如果当前副本数为2，则将其扩展至3。

[root@master ~]# kubectl scale --current-replicas=2 --replicas=3 deployment/mysql

设置多个RC中Pod副本数量

[root@master ~]# kubectl scale --replicas=5 rc/foo rc/bar rc/baz

autoscale命令：这个比scale更加强大，也是弹性伸缩策略 ，它是根据流量的多少来自动进行扩展或者缩容。

指定Deployment、ReplicaSet或ReplicationController，并创建已经定义好资源的自动伸缩器。使用自动伸缩器可以根据需要自动增加或减少系统中部署的pod数量。

语法：

kubectl autoscale (-f FILENAME | TYPE NAME | TYPE/NAME) [--min=MINPODS] --max=MAXPODS [--cpu-percent=CPU] [flags]

使用 Deployment “foo”设定，使用默认的自动伸缩策略，指定目标CPU使用率，使其Pod数量在2到10之间

[root@master ~]# kubectl autoscale deployment foo --min=2 --max=10

使用RC“foo”设定，使其Pod的数量介于1和5之间，CPU使用率维持在80％

[root@master ~]# kubectl autoscale rc foo --max=5 --cpu-percent=80

集群管理命令：certificate，cluster-info，top，cordon，uncordon，drain，taint

查看集群的初始化信息【pod使用镜像和网段等】

[root@master ~]# kubeadm config view

certificate命令：用于证书资源管理，授权等

例如，当有node节点要向master请求，那么是需要master节点授权的

[root@master ~]# kubectl certificate approve node-csr-81F5uBehyEyLWco5qavBsxc1GzFcZk3aFM3XW5rT3mw node-csr-Ed0kbFhc_q7qx14H3QpqLIUs0uKo036O2SnFpIheM18

cluster-info 命令：显示集群信息

[root@master ~]# kubectl cluster-info

top 命令：用于查看资源的cpu，内存磁盘等资源的使用率

以前需要heapster，后替换为metrics-server 【如果不装这个服务，会有error报错】

安装metrics以后，error报错就成使用率展示了
我博客分类中有一篇是：k8s安装metric server和了解ns，想了解的可以自己去看看学习学习。

查看pod的使用情况

查看所有

[root@master ~]# kubectl top pod --all-namespaces

查看指定pod

[root@master ~]# kubectl top pod -n 命名名称 【命名名称查看：kubectl get ns】

查看node的使用情况

[root@master ~]# kubectl top nodes

cordon命令：用于标记某个节点不可调度

标记 my-node 为 unschedulable,禁止pod被调度过来。注意这时现有的pod还会继续运行，不会被驱逐。

[root@master ~]# kubectl cordon my-node

uncordon命令：用于标签节点可以调度

与cordon相反，标记 my-node 为 允许调度。

[root@master ~]# kubectl uncordon my-node

drain命令： 用于在维护期间排除节点。

drain字面意思为排水，实际就是把my-node的pod平滑切换到其他node，同时标记pod为unschedulable，也就是包含了cordon命令。

[root@master ~]# kubectl drain my-node

但是直接使用命令一般不会成功，建议在要维护节点时，加上以下参数：

kubectl drain my-node --ignore-daemonsets --force --delete-local-data

• --ignore-daemonsets 忽略daemonset部署的pod
• --force 直接删除不由workload对象（Deployment、Job等）管理的pod
• --delete-local-data 直接删除挂载有本地目录(empty-dir方式）的pod

taint命令：用于给某个Node节点设置污点

1、污点 ( Taint ) 的组成

• 使用kubectl taint命令可以给某个Node节点设置污点，Node被设置上污点之后就和Pod之间存在了一种相斥的关系，可以让Node拒绝Pod的调度执行，甚至将Node已经存在的Pod驱逐出去
• 每个污点的组成如下： key=value:effect 每个污点有一个 key 和 value 作为污点的标签，其中 value 可以为空，effect 描述污点的作用。
• 当前 taint effect 支持如下三个选项：
  • NoSchedule ：表示k8s将不会将Pod调度到具有该污点的Node上
  • NoExecute ：表示k8s将不会将Pod调度到具有该污点的Node上，同时会将Node上已经存在的Pod驱逐出去
  • PreferNoSchedule ：表示k8s将尽量避免将Pod调度到具有该污点的Node上

2、污点的设置、查看和去除

设置污点

kubectl taint nodes k8s-node2 check=yuanzhang:NoExecute

节点说明中，查找Taints字段

kubectl describe nodes k8s-node2

去除污点

kubectl taint nodes k8s-node2 check:NoExecute-

集群故障排查和调试命令：describe，logs，exec，attach，port-foward，proxy，cp，auth

describe命令：显示特定pod资源的详细信息

要先知道所有的命名空间，你的pod可能不是在默认default中

[root@master ~]# kubectl get ns
NAME              STATUS   AGE
ccx               Active   15h
ccxhero           Active   15h
default           Active   5d
kube-node-lease   Active   5d
kube-public       Active   5d
kube-system       Active   5d
ns1               Active   16h
[root@master ~]#

这时需要获取指定命名空间中的pod名称，如我获取ccx下的pod

[root@master ~]# kubectl get pods -n ccx
NAME                          READY   STATUS             RESTARTS   AGE
nginx-test-795d659f45-j9m9b   0/1     ImagePullBackOff   0          26m
nginx-test-795d659f45-txf8l   0/1     ImagePullBackOff   0          26m
[root@master ~]# 

查看某个 pod的详细状态

得到上面的pod名称后，加上-n 后面跟上命名空间，如果不加-n，则是使用默认的命名空间，会报错。
语法：kubectl describe pod -n pod所属ns podNAME
如下

[root@master ~]# kubectl describe pod -n ccx nginx-test-795d659f45-j9m9b
...

logs命令：用于在一个pod中打印一个容器的日志，如果pod中只有一个容器，可以省略容器名

语法：

kubectl logs [-f] [-p] POD [-c CONTAINER]

返回仅包含一个容器的pod nginx的日志快照

[root@master ~]# kubectl logs nginx

返回pod ruby中已经停止的容器web-1的日志快照

[root@master ~]# kubectl logs -p -c ruby web-1

持续输出pod ruby中的容器web-1的日志

[root@master ~]# kubectl logs -f -c ruby web-1

仅输出pod nginx中最近的20条日志

[root@master ~]# kubectl logs --tail=20 nginx

输出pod nginx中最近一小时内产生的所有日志

[root@master ~]# kubectl logs --since=1h nginx

参数选项：

• -c, --container="": 容器名。
• -f, --follow[=false]: 指定是否持续输出日志（实时日志）。
• --interactive[=true]: 如果为true，当需要时提示用户进行输入。默认为true。
• --limit-bytes=0: 输出日志的最大字节数。默认无限制。
• -p, --previous[=false]: 如果为true，输出pod中曾经运行过，但目前已终止的容器的日志。
• --since=0: 仅返回相对时间范围，如5s、2m或3h，之内的日志。默认返回所有日志。只能同时使用since和since-time中的一种。
• --since-time="": 仅返回指定时间（RFC3339格式）之后的日志。默认返回所有日志。只能同时使用since和since-time中的一种。
• --tail=-1: 要显示的最新的日志条数。默认为-1，显示所有的日志。
• --timestamps[=false]: 在日志中包含时间戳。

### exec命令：进入容器进行交互，在容器中执行命令 语法：

kubectl exec POD [-c CONTAINER] -- COMMAND [args...]

命令选项：

• -c, --container="": 容器名。如果未指定，使用pod中的一个容器。
• -p, --pod="": Pod名。
• -i, --stdin[=false]: 将控制台输入发送到容器。
• -t, --tty[=false]: 将标准输入控制台作为容器的控制台输入。
• 进入nginx容器，执行一些命令操作

[root@master ~]# kubectl exec -it nginx-deployment-58d6d6ccb8-lc5fp bash

attach命令：连接到一个正在运行的容器。

语法：

kubectl attach POD -c CONTAINER

参数选项：

• - `-c, --container=""`: 容器名。如果省略，则默认选择第一个 pod。
• - `-i, --stdin[=false]`: 将控制台输入发送到容器。
• - `-t, --tty[=false]`: 将标准输入控制台作为容器的控制台输入。

获取正在运行中的pod 123456-7890的输出，默认连接到第一个容器

[root@master ~]# kubectl attach 123456-7890

获取pod 123456-7890中ruby-container的输出

[root@master ~]# kubectl attach 123456-7890 -c ruby-container

切换到终端模式，将控制台输入发送到pod 123456-7890的ruby-container的“bash”命令，并将其结果输出到控制台

错误控制台的信息发送回客户端。

[root@master ~]# kubectl attach 123456-7890 -c ruby-container -i -t

cp命令：拷贝文件或者目录到pod容器中

用于pod和外部的文件交换,类似于docker 的cp，就是将容器中的内容和外部的内容进行交换。

语法：

kubectl cp <file-spec-src> <file-spec-dest> [options]

拷贝宿主机本地文件夹到pod

[root@master ~]# kubectl cp /tmp/foo_dir <some-pod>:/tmp/bar_dir

指定namespace的拷贝pod文件到宿主机本地目录

[root@master ~]# kubectl cp <some-namespace>/<some-pod>:/tmp/foo /tmp/bar

对于多容器pod，用-c指定容器名

[root@master ~]# kubectl cp /tmp/foo <some-pod>:/tmp/bar -c <specific-container>

其他命令：api-servions，config，help，plugin，version

api-servions命令：打印受支持的api版本信息

打印当前集群支持的api版本

[root@master ~]# kubectl api-versions

help命令：用于查看命令帮助

显示全部的命令帮助提示

[root@master ~]# kubectl --help

具体的子命令帮助，例如

[root@master ~]# kubectl create --help

config 命令: 用于修改kubeconfig配置文件（用于访问api，例如配置认证信息）

设置 kubectl 与哪个 Kubernetes 集群进行通信并修改配置信息。查看 使用 kubeconfig 跨集群授权访问 文档获取详情配置文件信息。

显示合并的 kubeconfig 配置信息

为啥要加个合并呢，是因为如果配置了多集群，那么这里面的配置信息是很多的，如下，我配置了2个集群的config文件内容就如下【我博客中有一篇是：【Kubernetes】k8s多集群切换【含上下文作用详解】，这里面说了如何配置多集群，感兴趣的可以去看看。

[root@master ~]# kubectl config view

[root@master ~]# kubectl config view
apiVersion: v1
clusters:
- cluster:
    certificate-authority-data: DATA+OMITTED
    server: https://192.168.59.142:6443
  name: master
- cluster:
    certificate-authority-data: DATA+OMITTED
    server: https://192.168.59.151:6443
  name: master1
contexts:
- context:
    cluster: master
    namespace: default
    user: ccx
  name: context
- context:
    cluster: master1
    namespace: default
    user: ccx1
  name: context1
current-context: context
kind: Config
preferences: {}
users:
- name: ccx
  user:
    client-certificate-data: REDACTED
    client-key-data: REDACTED
- name: ccx1
  user:
    client-certificate-data: REDACTED
    client-key-data: REDACTED
[root@master ~]# 

同时使用多个 kubeconfig 文件并查看合并的配置

[root@master ~]# KUBECONFIG=~/.kube/config:~/.kube/kubconfig2 kubectl config view

获取 e2e 用户的密码

[root@master ~]# kubectl config view -o jsonpath='{.users[?(@.name == "e2e")].user.password}'

查看当前所处的上下文

[root@master ~]# kubectl config current-context

查看多集群上下文等信息

CURRENT是当前所处集群

[root@master ~]# kubectl config get-contexts 
CURRENT   NAME       CLUSTER   AUTHINFO   NAMESPACE
*         context    master    ccx        default
          context1   master1   ccx1       default
[root@master ~]# 

设置默认的上下文【多集群切换】

使用：kubectl config get-contexts查看现在有的上下文【一般多集群才需要切换】
语法

kubectl config use-context 上下文名称【NAME】

如，我现在在context上，我切换到context1这个上下文上【也就切换到另一个集群了】

[root@master ~]# kubectl config get-contexts 
CURRENT   NAME       CLUSTER   AUTHINFO   NAMESPACE
*         context    master    ccx        default
          context1   master1   ccx1       default
[root@master ~]# 
[root@master ~]# kubectl config use-context context1
Switched to context "context1".
[root@master ~]# 
[root@master ~]# kubectl config get-contexts 
CURRENT   NAME       CLUSTER   AUTHINFO   NAMESPACE
          context    master    ccx        default
*         context1   master1   ccx1       default
[root@master ~]# 

添加新的集群配置到 kubeconf 中，使用 basic auth 进行鉴权

[root@master ~]# kubectl config set-credentials kubeuser/foo.kubernetes.com --username=kubeuser --password=kubepassword

使用特定的用户名和命名空间设置上下文。

[root@master ~]# kubectl config set-context gce --user=cluster-admin --namespace=foo \
  && kubectl config use-context gce

version 命令：打印客户端和服务端版本信息

打印客户端和服务端版本信息【详细版】

[root@master ~]# kubectl version

精简版【仅显示版本号】

[root@master ~]# kubectl version --short

plugin 命令：运行一个命令行插件

docker plugin命令用于管理插件。
用法

docker plugin COMMAND

Shell
编号 命令 描述

IP	操作系统
docker plugin create	从rootfs和配置创建一个插件。插件数据目录必须包含config.json和rootfs目录。
192.168.2.125	centos7.9
docker plugin enable	启用插件
docker plugin inspect	显示一个或多个插件的详细信息
docker plugin install	安装一个插件
docker plugin ls	列出所有插件
docker plugin push	将插件推送到注册表
docker plugin rm	删除一个或多个插件
docker plugin set	更改插件的设置
docker plugin upgrade	升级现有插件

高级命令：apply，patch，replace，convert

apply命令：通过文件名或者标准输入对资源应用配置

通过文件名或控制台输入，对资源进行配置。 如果资源不存在，将会新建一个。可以使用 JSON 或者 YAML 格式。

语法：

kubectl apply -f FILENAME

将pod.json中的配置应用到pod

[root@master ~]# kubectl apply -f ./pod.json

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

[root@master ~]# cat pod.json | kubectl apply -f -

参数选项：

语法：

kubectl patch (-f FILENAME | TYPE NAME) -p PATCH

• -f, --filename=[]: 包含配置信息的文件名，目录名或者URL。
• --include-extended-apis[=true]: If true, include definitions of new APIs via calls to the API server. [default true]
• -o, --output="": 输出模式。"-o name"为快捷输出(资源/name).
• --record[=false]: 在资源注释中记录当前 kubectl 命令。
• -R, --recursive[=false]: Process the directory used in -f, --filename recursively. Useful when you want to manage related manifests organized within the same directory.
• --schema-cache-dir="~/.kube/schema": 非空则将API schema缓存为指定文件，默认缓存到’[root@master ~]#HOME/.kube/schema’
• --validate[=true]: 如果为true，在发送到服务端前先使用schema来验证输入。

patch命令：使用补丁修改，更新资源的字段，也就是修改资源的部分内容

Partially update a node using strategic merge patch

[root@master ~]# kubectl patch node k8s-node-1 -p '{"spec":{"unschedulable":true}}'

Update a container’s image; spec.containers[*].name is required because it’s a merge key

[root@master ~]# kubectl patch pod valid-pod -p '{"spec":{"containers":[{"name":"kubernetes-serve-hostname","image":"new image"}]}}'

replace命令： 通过文件或者标准输入替换原有资源

语法：

kubectl replace -f FILENAME

Replace a pod using the data in pod.json.

[root@master ~]# kubectl replace -f ./pod.json

Replace a pod based on the JSON passed into stdin.

[root@master ~]# cat pod.json | kubectl replace -f -

Update a single-container pod’s image version (tag) to v4

[root@master ~]# kubectl get pod mypod -o yaml | sed 's/\(image: myimage\):.*[root@master ~]#/\1:v4/' | kubectl replace -f -

Force replace, delete and then re-create the resource

[root@master ~]# kubectl replace --force -f ./pod.json

convert命令：不同的版本之间转换配置文件

语法：

kubectl convert -f FILENAME

Convert ‘pod.yaml’ to latest version and print to stdout.

[root@master ~]# kubectl convert -f pod.yaml

Convert the live state of the resource specified by ‘pod.yaml’ to the latest version and print to stdout in json format.

[root@master ~]# kubectl convert -f pod.yaml --local -o json

Convert all files under current directory to latest version and create them all.

[root@master ~]# kubectl convert -f . | kubectl create -f -

格式化输出

要以特定格式将详细信息输出到终端窗口，可以将-o或–output 参数添加到支持的 kubectl 命令。

Kubectl 日志输出详细程度和调试

Kubectl 日志输出详细程度是通过 -v 或者 --v 来控制的，参数后跟了一个数字表示日志的级别。
Kubernetes 通用的日志习惯和相关的日志级别在 这里 有相应的描述。