k8s之kubectl命令格式

一  kubectl介绍

kubectl是最常用的客户端工具之一，它提供了基于命令行访问kubernetes API的简洁方式，支持对各种类型资源的CRUD，能够满足针对kubernetes系统的绝大部分的操作需求。

kubectl特性丰富且功能强大，是kubernetes管理员最常用的集群管理工具，其最基本的语法格式为kubectl  [command] [TYPE] [NAME] [flages]；

• command：对资源执行相应操作的子命令，例如get、create、delete、run等；
• TYPE：要操作的资源类型，例如pods、services等；类型名称大小写敏感，但支持使用单数、复数或简写格式；
• NAME：要操作的资源对象名称，大小写敏感；省略时，则表示指定TYPE的所有资源对象；同一类型的资源名称可于TYPE后同时给出多个，也可以直接使用TYPE/NAME的格式来为每个资源对象分别指定类型；
• flags：命令行选项，例如-s或--server等；另外get等命令在输出时还有一个常用的标志-o <format>用于指定输出格式；

二 kubectl核心子命令

root@k8s-master-01:~# kubectl --help
kubectl controls the Kubernetes cluster manager.
Find more information at: https://kubernetes.io/docs/reference/kubectl/overview/基础命令（初级）:

create        通过文件或标准输入创建资源。create --save-config 等同于apply命令。

expose        基于RC、service、Deployment或pod创建service资源。

run           在集群中一pod形式运行指定的镜像。

set           设置目标资源对象的特定属性。基础命令 (中级):

explain       打印指定资源的内置文档。

get           显示一个或多个资源。

edit          编辑资源。

delete        基于文件名、stdin、资源或名字，以及资源和选择器删除资源。部署命令:

rollout       管理资源的滚动更新。

scale         伸缩Deployment、ReplicaSet、RC或job的规模。

autoscale     对Deployment、ReplicaSet、RC进行自动伸缩。集群管理命令:

certificate   配置数字证书资源。

cluster-info  打印集群信息。

top           打印资源（CPU/memory）使用率。

cordon        将指定node设定为“不可用”（unschedulable）状态。

uncordon      将指定node设定为“可用”（schedulable）状态。

drain         “排空”Node上的pod以进入“维护”模式。

taint         为node声明污点及标准行为。排错及调试命令:

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

logs          显示一个pod内容容器的日志。

attach        附加终端至一个运行中的容器。

exec          在容器中执行指定命令。

port-forward  将本地的一个或多个端口转发至指定的Pod。

proxy         创建能够访问kubernetes API Server的代理。

cp            在容器间复制文件或目录。

auth          打印授权信息。

debug         创建调试会话以对工作负载和节点进行故障排除。高级命令:

diff          对比当前版本与即将应用的新版的不同。

apply         基于文件或stdin将配置应用于资源。

patch         使用策略合并补丁更新资源字段。

replace       基于文件或stdin替换一个资源。

wait          等待一个或多个资源的指定情况。

kustomize     基于目录或URL构建kustomization目标。设置命令:

label         更新指定资源的label。

annotate      更新资源的annotation。

completion    输出指定的shell的补全码。其它命令:

api-resources 打印API支持的资源类型。

api-versions  以group/version格式打印服务器支持的API版本信息。

config        配置kubeconfig文件的内容。

plugin        运行命令行插件。

version       打印kubernetes服务端和客户端的版本信息。Usage:

kubectl [flags] [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).      

三 kubectl get命令的输出格式

-o wide                     以纯文档格式显示资源的附加信息。
-o name                     仅打印资源的名称。
-o yaml                     以YAML格式化输出API对象信息。
-o json                     以json格式化输出API对象信息。
-o jsonpath                 以自定义jsonpath模板格式输出API对象信息。
-o go-template              以自定义Go模板格式输出API对象信息。
-o custom-columns           自定义要输出的字段。
-s或--server                指定API Server的地址和端口。
--kubeconfig                使用的kubeconfig配置文件路径，默认为~/.kune/config。
-n或--namespace             命令执行的目标名称空间。      

四 kubectl常用操作示例

4.1 创建资源对象

~# kubectl create namespace dev #创建名为dev的名称空间。
~# kubectl create service clusterip demoapp --tcp=80 -n dev #在dev名称空间中创建名为demoapp的service资源对象。
~# kubectl create deployment demoapp --image="damoapp:v1.0" -n dev #在dev名称空间中创建为名demoapp的Deployment控制器资源。
~# kubectl apply -f deployment-demoapp.yaml -f service-damoapp.yaml #指定声明式配置文件创建资源。
~# kubectl apply . #执行当前目录下所有的yaml文件。      

4.2 查看资源对象

~# kubectl get namespace    #列出所有的namespace资源对象
~# kubectl get pods,services -o wide  #列出默认名称空间的pod和service，并输出额外信息。
~# kubectl get pods -l k8s-app -n kube-system  # 列出kube-system名称空间拥有k8s-app标签名称的所有pod对象。
~# kubectl explain deployment.spec.template.spec.containers # 查看deployment.spec.template.spec.containers字段信息。      

4.3 删除资源对象

~# kubectl delete services demoapp-svc #删除默认名称空间中名为demoapp-svc的service资源对象。
~# kubectl delete pods -l k8s-app=kube-proxy -n kube-system #删除kube-system名称空间中带有k8s-app=kube-proxy标签的所有pod对象。
~# kubectl delete pods --all -n kube-public #删除kube-public名称空间中所有的pod对象。
~# kubectl delete pods demoapp --force --grace-period=0 #指定删除资源宽限期。
~# kubectl delete -f nginx.yaml #删除以nginx.yaml创建的资源。      

4.4 资源对象打label

~# kubectl label node 192.168.174.106 project=dev #给192.168.174.106 node节点添加project=dev标签。
~# kubectl label node 192.168.174.106 project- #删除192.168.174.106 node节点的project=dev的标签。      

4.5 将node设为不可用

~# kubectl cordon 192.168.174.105  #将192.168.174.105 设置为schedulingDisabled
~# kubectl uncordon 192.168.174.105 #将102.168.174.105 设置为可调度节点。      

4.6 pod驱逐

~# kubectl drain 192.168.174.105 --force --ignore-daemonsets --delete-emptydor-data#驱逐当前节点的所有pod，适用于无状态服务。      

4.7 pod扩容缩容

~# kubectl scale demoapp --replicas=3 #将demoapp的pod副本数扩展至3个。