写在最前：本章介绍的是kubectl一些工作中常见基本命令整理，更多请查看kubernetes官方文档，或者查看kubernetes的帮助文档。通篇下来比较长，建议收藏以便后续查阅。

PS：请勿拿生产环境做测试。

基础命令：create，delete，get，run，expose，set，explain，edit。

使用以下语法 kubectl 从终端窗口运行命令：

kubectl [command] [TYPE] [NAME] [flags]

其中command TYPE NAME和flags

分别是：

command：指定要对一个或多个资源执行的操作，例如 create、get、describe、delete。TYPE：指定资源类型。资源类型不区分大小写， 可以指定单数、复数或缩写形式。例如，以下命令输出相同的结果:1、create命令：根据文件或者输入来创建资源

# 创建Deployment和Service资源kubectl create -f test-deployment.yamlkubectl create -f test-service.yaml

2、kubectl get 列出一个或多个资源。

## 查看所有的资源信息root@k8s-master:~# kubectl  get allNAME            READY   STATUS    RESTARTS   AGEpod/net-test1   1/1     Running   0          4h44mpod/net-test2   1/1     Running   0          4h44mpod/net-test3   1/1     Running   0          4h44mNAME                 TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGEservice/kubernetes   ClusterIP   10.100.0.1   <none>        443/TCP   5h2m# 以纯文本输出格式列出所有 pod。kubectl get pods# 以纯文本输出格式列出所有 pod，并包含附加信息(如在节点IP)。root@k8s-master:~# kubectl  get pods -owideNAME        READY   STATUS    RESTARTS   AGE     IP               NODE           NOMINATED NODE   READINESS GATESnet-test1   1/1     Running   0          4h49m   10.200.228.129   172.31.7.111   <none>           <none>net-test2   1/1     Running   0          4h49m   10.200.35.129    172.31.7.112   <none>           <none>net-test3   1/1     Running   0          4h49m   10.200.228.130   172.31.7.111   <none>           <none># 显示pod节点的标签信息kubectl get pod --show-labels# 根据指定标签匹配到具体的podkubectl get pods -l app=exampl# 查看node节点列表kubectl get node # 显示node节点的标签信息kubectl get node --show-labels# 查看服务的详细信息，显示了服务名称，类型，集群ip，端口，时间等信息root@k8s-master:~# kubectl get svcNAME         TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)   AGEkubernetes   ClusterIP   10.100.0.1   <none>        443/TCP   5h9m 查看命名空间kubectl get ns# 查看所有pod所属的命名空间kubectl get pod --all-namespaces# 查看所有pod所属的命名空间并且查看都在哪些节点上运行kubectl get pod --all-namespaces  -o wide# 查看目前所有的replica set，显示了所有的pod的副本数，以及他们的可用数量以及状态等信息root@k8s-master:~# kubectl get rs --all-namespacesNAMESPACE              NAME                                   DESIRED   CURRENT   READY   AGEkube-system            calico-kube-controllers-754966f84c     1         1         1       5h6mkube-system            coredns-79688b6cb4                     1         1         1       117mkubernetes-dashboard   dashboard-metrics-scraper-799d786dbf   1         1         1       46mkubernetes-dashboard   dashboard-metrics-scraper-c766885cc    0         0         0       50mkubernetes-dashboard   kubernetes-dashboard-5cf689bbcc        0         0         0       50mkubernetes-dashboard   kubernetes-dashboard-fb8648fd9         1         1         1       46m#查看所有deploymentroot@k8s-master:~# kubectl get deployment -ANAMESPACE              NAME                        READY   UP-TO-DATE   AVAILABLE   AGEkube-system            calico-kube-controllers     1/1     1            1           5h7mkube-system            coredns                     1/1     1            1           118mkubernetes-dashboard   dashboard-metrics-scraper   1/1     1            1           52mkubernetes-dashboard   kubernetes-dashboard        1/1     1            1           52m# 查看已经部署了的所有应用，可以看到容器，以及容器所用的镜像，标签等信息 root@k8s-master:~# kubectl get deploy -o wide -ANAMESPACE              NAME                        READY   UP-TO-DATE   AVAILABLE   AGE     CONTAINERS                  IMAGES                                      SELECTORkube-system            calico-kube-controllers     1/1     1            1           5h10m   calico-kube-controllers     docker.io/calico/kube-controllers:v3.19.3   k8s-app=calico-kube-controllerskube-system            coredns                     1/1     1            1           120m    coredns                     harbor.host.com/base/coredns:1.8.7          k8s-app=kube-dnskubernetes-dashboard   dashboard-metrics-scraper   1/1     1            1           54m     dashboard-metrics-scraper   kubernetesui/metrics-scraper:v1.0.7         k8s-app=dashboard-metrics-scraperkubernetes-dashboard   kubernetes-dashboard        1/1     1            1           54m     kubernetes-dashboard        kubernetesui/dashboard:v2.5.1               k8s-app=kubernetes-dashboard

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

root@k8s-master:~# kubectl explain dsKIND:     DaemonSetVERSION:  apps/v1DESCRIPTION:     DaemonSet represents the configuration of a daemon set.FIELDS:   apiVersion   <string>     APIVersion defines the versioned schema of this representation of an     object. Servers should convert recognized schemas to the latest internal     value, and may reject unrecognized values. More info:        kind <string>     Kind is a string value representing the REST resource this object     represents. Servers may infer this from the endpoint the client submits     requests to. Cannot be updated. In CamelCase. More info:        metadata     <Object>     Standard object's metadata. More info:        spec <Object>     The desired behavior of this daemon set. More info:        status       <Object>     The current status of this daemon set. This data may be out of date by some     window of time. Populated by the system. Read-only. More info:     

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

使用命令行工具获取的任何资源都可以使用edit命令编辑。edit命令会打开使用KUBE_EDITOR，GIT_EDITOR 或者EDITOR环境变量定义的编辑器，可以同时编辑多个资源，但所编辑过的资源只会一次性提交。edit除命令参数外还接受文件名形式。

# 编辑Deployment nginx的一些信息kubectl edit deployment nginx# 编辑service类型的nginx的一些信息kubectl edit service/nginx

5、设置命令：label、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=truekubectl label pods foo unhealthy=true# 给名为foo的Pod修改label 为 'status' / value 'unhealthy'，且覆盖现有的valuekubectl label --overwrite pods foo status=unhealthy# 给 namespace 中的所有 pod 添加 labelkubectl label  pods --all status=unhealthy# 仅当resource-version=1时才更新 名为foo的Pod上的labelkubectl label pods foo status=unhealthy --resource-version=1# 删除名为“bar”的label 。（使用“ - ”减号相连）kubectl label pods foo bar-

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

$ source <(kubectl completion bash) # setup autocomplete in bash, bash-completion package should be installed first.$ source <(kubectl completion zsh)  # setup autocomplete in zsh

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

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

可用资源包括：deployments，daemonsets。

子命令：

history（查看历史版本）pause（暂停资源）resume（恢复暂停资源）status（查看资源状态）undo（回滚版本）

# 语法kubectl rollout SUBCOMMAND# 回滚到之前的deploymentkubectl rollout undo deployment/abc# 查看daemonet的状态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的podkubectl rolling-update frontend-v1 -f frontend-v2.json# 使用JSON数据更新frontend-v1的podcat frontend-v2.json | kubectl rolling-update frontend-v1 -f -# 其他的一些滚动更新kubectl rolling-update frontend-v1 frontend-v2 --image=image:v2kubectl rolling-update frontend --image=image:v2kubectl 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。kubectl scale --replicas=3 rs/fookubectl scale deploy/nginx --replicas=30# 将由“foo.yaml”配置文件中指定的资源对象和名称标识的Pod资源副本设为3kubectl scale --replicas=3 -f foo.yaml# 如果当前副本数为2，则将其扩展至3。kubectl scale --current-replicas=2 --replicas=3 deployment/mysql# 设置多个RC中Pod副本数量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之间kubectl autoscale deployment foo --min=2 --max=10# 使用RC“foo”设定，使其Pod的数量介于1和5之间，CPU使用率维持在80％kubectl autoscale rc foo --max=5 --cpu-percent=80

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

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

root@k8s-master:~# kubectl certificate --helpModify certificate resources.Available Commands:  approve     Approve a certificate signing request  deny        Deny a certificate signing requestUsage:  kubectl certificate SUBCOMMAND [options]Use "kubectl <command> --help" for more information about a given command.Use "kubectl options" for a list of global command-line options (applies to all commands).# 例如，当有node节点要向master请求，那么是需要master节点授权的kubectl  certificate approve node-csr-81F5uBehyEyLWco5qavBsxc1GzFcZk3aFM3XW5rT3mw node-csr-Ed0kbFhc_q7qx14H3QpqLIUs0uKo036O2SnFpIheM18

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

root@k8s-master:~# kubectl cluster-infoKubernetes control plane is running at  is running at  further debug and diagnose cluster problems, use 'kubectl cluster-info dump'.

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

kubectl top pod --all-namespaces它需要heapster运行才行

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

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

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

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

8、集群故障排查和调试命令：describe、logs、exec、cp

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

# 语法kubectl describe TYPE NAME_PREFIX（首先检查是否有精确匹配TYPE和NAME_PREFIX的资源，如果没有，将会输出所有名称以NAME_PREFIX开头的资源详细信息）支持的资源包括但不限于（大小写不限）：pods (po)、services (svc)、 replicationcontrollers (rc)、nodes (no)、events (ev)、componentstatuses (cs)、 limitranges (limits)、persistentvolumes (pv)、persistentvolumeclaims (pvc)、 resourcequotas (quota)和secrets。#查看my-nginx pod的详细状态kubectl describe po my-nginx

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

# 语法kubectl logs [-f] [-p] POD [-c CONTAINER]# 返回仅包含一个容器的pod nginx的日志快照$ kubectl logs nginx# 返回pod ruby中已经停止的容器web-1的日志快照$ kubectl logs -p -c ruby web-1# 持续输出pod ruby中的容器web-1的日志$ kubectl logs -f -c ruby web-1# 仅输出pod nginx中最近的20条日志$ kubectl logs --tail=20 nginx# 输出pod nginx中最近一小时内产生的所有日志$ 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容器，执行一些命令操作kubectl exec -it nginx-deployment-66666666-lc5fp bash

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

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

root@k8s-master:~# kubectl cp --helpCopy files and directories to and from containers.Examples:  # !!!Important Note!!!  # Requires that the 'tar' binary is present in your container  # image.  If 'tar' is not present, 'kubectl cp' will fail.  #  # For advanced use cases, such as symlinks, wildcard expansion or  # file mode preservation, consider using 'kubectl exec'.  # Copy /tmp/foo local file to /tmp/bar in a remote pod in namespace <some-namespace>  tar cf - /tmp/foo | kubectl exec -i -n <some-namespace> <some-pod> -- tar xf - -C /tmp/bar  # Copy /tmp/foo from a remote pod to /tmp/bar locally  kubectl exec -n <some-namespace> <some-pod> -- tar cf - /tmp/foo | tar xf - -C /tmp/bar  # Copy /tmp/foo_dir local directory to /tmp/bar_dir in a remote pod in the default namespace  kubectl cp /tmp/foo_dir <some-pod>:/tmp/bar_dir  # Copy /tmp/foo local file to /tmp/bar in a remote pod in a specific container  kubectl cp /tmp/foo <some-pod>:/tmp/bar -c <specific-container>  # Copy /tmp/foo local file to /tmp/bar in a remote pod in namespace <some-namespace>  kubectl cp /tmp/foo <some-namespace>/<some-pod>:/tmp/bar  # Copy /tmp/foo from a remote pod to /tmp/bar locally  kubectl cp <some-namespace>/<some-pod>:/tmp/foo /tmp/barOptions:  -c, --container='': Container name. If omitted, use the kubectl.kubernetes.io/default-container annotation forselecting the container to be attached or the first container in the pod will be chosen      --no-preserve=false: The copied file/directory's ownership and permissions will not be preserved in the container      --retries=0: Set number of retries to complete a copy operation from a container. Specify 0 to disable or anynegative value for infinite retrying. The default is 0 (no retry).Usage:  kubectl cp <file-spec-src> <file-spec-dest> [options]

9、其他命令：api-servions、apply

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

root@k8s-master:~# kubectl api-versionsadmissionregistration.k8s.io/v1apiextensions.k8s.io/v1apiregistration.k8s.io/v1apps/v1authentication.k8s.io/v1authorization.k8s.io/v1autoscaling/v1autoscaling/v2autoscaling/v2beta1autoscaling/v2beta2batch/v1batch/v1beta1certificates.k8s.io/v1coordination.k8s.io/v1discovery.k8s.io/v1discovery.k8s.io/v1beta1events.k8s.io/v1events.k8s.io/v1beta1flowcontrol.apiserver.k8s.io/v1beta1flowcontrol.apiserver.k8s.io/v1beta2networking.k8s.io/v1node.k8s.io/v1node.k8s.io/v1beta1policy/v1policy/v1beta1rbac.authorization.k8s.io/v1scheduling.k8s.io/v1storage.k8s.io/v1storage.k8s.io/v1beta1v1#更详细的api信息root@k8s-master:~# kubectl api-resources

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

语法

kubectl apply -f FILENAMEkubectl apply -f test.yaml