k8s-kubectl命令行工具

kubectl命令行工具用法详解

kubectl作为客户端CLI工具，可以让用户通过命令行的方式对Kubernetes集群进行操作

kubectl用法概述：

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

• （1）command：子命令，用于操作Kubernetes集群资源对象的命令，例如create、delete、describe、get、apply等。
• （2）TYPE：资源对象的类型，区分大小写，能以单数形式、复数形式或者简写形式表示。

例如以下3种TYPE是等价的:

$ kubectl get pod pod1

$ kubectl get pods pod1

$ kubectl get po pod1

• （3）NAME：资源对象的名称，区分大小写。如果不指定名称，则系统将返回属于TYPE的全部对象的列表，

例如 $ kubectl get pods 将返回所有Pod的列表。

• （4）flags：kubectl子命令的可选参数，例如使用“-s”指定apiserver的URL地址而不用默认值。

kubectl可操作的资源对象类型(TYPE)

cluster
componentstatuses   cs
configmaps          cm
daemonsets          ds
deployments         deploy
endpoints           ep
events              ev
horizontalpodautoscalers    hpa
ingresses           ing
Jobs
limitranges         limits
nodes               no
namespaces          ns
networkpolicies
statefulsets
persistentvolumeclaims      pvc
persistentvolumes           pv
pods                po
podsecuritypolicies         psp
podtemplate
replicasets         rs
replicationcontrollers      rc
resourcequotas      quota
cronjob
secrets
serviceaccounts
services            svc
storageclasses      sc
thirdpartyresources

在一个命令行中也可以同时对多个资源对象进行操作，以多个TYPE和NAME的组合表示

示例如下:

• 获取多个Pod的信息：

$ kubectl get pods pod1 pod2

• 获取多种对象的信息：

$ kubectl get pod/pod1 rc/rc1

• 同时应用多个yaml文件，以多个-f file参数表示：

$ kubectl get pod -f pod1.yaml -f pod2.yaml
$ kubectl create -f pod1.yaml -f rc1.yaml -f service1.yaml

kubectl输出格式:

kubectl 命令可以用多种格式对结果进行显示，输出的格式通过-o参数指定：

$ kubectl [command] [TYPE] [NAME] -o=<output_format>

根据不同子命令的输出结果，可选的输出格式如下:

-o=custom-columns=<spec>            根据自定义列名进行输出，以逗号分隔
-o=custom-colimns-file=<filename>   从文件中获取自定义列名进行输出
-o=json                             以JSON格式显示结果
-o=jsonpath=<template>              输出jsonpath表达式定义的字段信息
-o=jsonpath-file=<filename>         输出jsonpath表达式定义的字段信息，来源于文件
-o=name                             仅输出资源对象的名称
-o=wide                             输出额外信息。对于Pod，将输出Pod所在的Node名
-o=yaml                             以yaml格式显示结果

常用的输出格式示例如下:

（1）显示Pod的更多信息：

$ kubectl get pod <pod-name> -o wide

（2）以yaml格式显示Pod的详细信息：

$ kubectl get pod <pod-name> -o yaml

（3）以自定义列名显示Pod的信息：

$ kubectl get pod <pod-name> -o=custom-columns=NAME:.metadata.name,RSRC:.metadata.resourceVersion

（4）基于文件的自定义列名输出：

$ kubectl get pods <pod-name> -o=custom-columns-file=template.txt

• 还可以将输出结果按某个字段排序，通过–sort-by参数以jsonpath表达式进行指定：

按照名字进行排序：

$ kubectl get pods --sort-by=.metadata.name

kubectl操作示例:

1. 创建资源对象

• 根据yaml配置文件一次创建service和rc：

$ kubectl create -f my-service.yaml -f my-rc.yaml

• 根据 yaml 创建资源, apply 可以重复执行，create 不行

kubectl apply -f pod.yaml

• 根据目录下所有.yaml、.yml、.json文件的定义进行创建操作；

$ kubectl create -f <directory>

2. 查看资源对象

• 查看所有Pod列表：

$ kubectl get pods

• 查看rc和service列表：

$ kubectl get rc,service

• 查看所有 pod 列表, -n 后跟 namespace, 查看指定的命名空间

kubectl get pod -n kube

3. 描述资源对象

• 显示Node的详细信息：

$ kubectl describe nodes <node-name>

• 显示Pod的详细信息

$ kubectl describe pods <pod-name>

• 显示由RC管理的Pod的信息：

$ kubectl describe pods <rc-name>

4.删除资源对象

• 基于pod.yaml定义的名称删除Pod：

$ kubectl delete -f pod.yaml

• 删除所有包含某个label的Pod和Service：

$ kubectl delete pod,service -l name=<label-name>

• 删除所有Pod：

$ kubectl delete pods --all

5. 执行容器的命令

• 执行Pod的date命令，默认使用Pod的第1个容器执行：

$ kubectl exec <pod-name> date

$ kubectl exec <pod-name> -- bash

$ kubectl exec <pod-name> -- ping 10.24.51.9

• 指定Pod中某个容器执行date命令：

$ kubectl exec <pod-name> -c <container-name> date

• 通过bash获得Pod中某个容器的TTY，相当于登陆容器：

$ kubectl exec -ti <pod-name> -c <container-name> /bin/bash

6.查看容器的日志

• 查看容器输出到stdout的日志：

$ kubectl logs <pod-name>

• 跟踪查看容器的日志，相当于tail -f命令的结果,若 pod 只有一个容器，可以不加 -c

$ kubectl logs -f <pod-name> -c <container-name>

• 实时查看日志

$ kubectl logs -f <pod-name>

• 容器日志输出到文件

$ log_pod release-xxxx 10000 > xxxx.txt

7.查看注释

$ kubectl explain pod

$ kubectl explain pod.apiVersion

8.重启 pod

$ kubectl get pod <POD名称> -n <NAMESPACE名称> -o yaml | kubectl replace --force -f -

9.修改网络类型

kubectl patch service istio-ingressgateway -n istio-system -p '{"spec":{"type":"NodePort"}}'

Google访问k8s集群中的pod（需要进行端口转发port-forward）

kubectl port-forward pod名称 主机端口:POD端口