Kubernetes kubectl管理命令使用方法

陈述式资源管理方法（通过命令行）

1.kubernetes 集群管理集群资源的唯一入口是通过相应的方法调用 apiserver 的接口
2.kubectl 是官方的CLI命令行工具，用于与 apiserver 进行通信，将用户在命令行输入的命令，组织并转化为 apiserver 能识别的信息，进而实现管理 k8s 各种资源的一种有效途径
3.kubectl 的命令大全

kubectl --help

k8s中文文档：http://docs.kubernetes.org.cn/683.html
4.对资源的增、删、查操作比较方便，但对改的操作就不容易了（改一般用声明式）

总结

创建
kubectl create <资源类型> <资源名称> -n 命名空间  [选项]
                                                  --image=镜像  --replicas=副本数  --port=容器端口
查询
kubectl get <资源类型|all> [资源名称] -n 命名空间 -o wide|yaml|json  -w
                                                                 实时更新

详细信息
kubectl describe <资源类型> <资源名称> -n 命名空间

删除（重启）
kubectl delete  <资源类型> <资源名称>|--all  -n 命名空间  [--force --grace-period=0]
                                                      ✨立即终止Pod运行，强制删除资源
进入pod中某一容器
kubectl exec -it -n 命名空间    [-c 容器名称]  sh|bash

查看pod中某一容器的日志
kubectl logs -n 命名空间    [-c 容器名称] [-p]
                                                     重启之前的容器日志

设置pod副本数
kubectl scale -n 命名空间 deployment <资源名称> --replicas=副本数   

创建service
kubectl expose -n 命名空间 deployment <资源名称> --name <自定义svc资源名称> --port  --target-port <容器的端口> --type 
kubectl create svc  <资源名称> --tcp=:<容器的端口>
#create方式创建的service资源名与标签选择器同名。更建议使用expose。

//查看版本信息

kubectl version

//查看资源对象简写（非→常↑好↓用）

kubectl api-resources

//查看集群信息

kubectl cluster-info

//配置kubectl自动补全（也非常好用！）

source <(kubectl completion bash)

注意重定向后没有空格。
在当前shell中有效。设置永久则写入/etc/bashrc中

//node节点查看日志

journalctl -u kubelet -f

-u 指定服务查询。-u kubelet查询kubelet服务的日志。
-f 实时

---------- 基本信息查看 ----------

获取资源的相关信息，-n 指定命令空间，-o 指定输出格式
resource可以是具体资源名称，如pod nginx-xxx；也可以是资源类型，如pod；或者all(仅展示几种核心资源，并不完整)

kubectl get  [-o wide|json|yaml] [-n namespace]

--all-namespaces 或 -A ：表示显示所有命名空间，
--show-labels ：显示所有标签
-l app ：仅显示标签为app的资源
-l app=nginx ：仅显示包含app标签，且值为nginx的资源

 //查看 master 节点状态

kubectl get componentstatuses
kubectl get cs

//查看 pod 状态

kubectl get pods -A
kubectl get pods --all-namespaces
所有命名空间的pod

kubectl get pods
只能查看默认命名空间的pod

kubectl get pods -n kube-system
查看 kube-system 命名空间pod

yaml格式显示（-o yaml） 

kubectl get pods -n kube-system 【命名空间内资源名】 -o yaml

 根据标签筛选 

kubectl get pods -A --show-labels
查看标签
kubectl get pods -l app=flannel
根据标签筛选

 查看所有关键资源（pod service 控制器）

kubectl get all
查看所有关键资源（pod service 控制器）

kubectl get all -n kube-system
查看所有关键资源(命名空间 kube-system)

//查看命名空间

kubectl get namespace
kubectl get ns

//查看default命名空间的所有资源

kubectl get all [-n default]

查看master节点状态

kubectl get cs
kubectl get componentstatuses

命名空间管理（相当于mysql的库）

命令空间的作用：用于允许不同 命名空间 的 相同类型 的资源 重名的

查看命名空间

kubectl get namespace
kubectl get ns

//创建命名空间app

kubectl create ns app
kubectl get ns

//删除命名空间app（删除命名空间会把其下的所有资源删除，慎用）

kubectl delete namespace app
kubectl get ns

//在命名空间kube-public 创建副本控制器（deployment）来启动Pod（nginx1）并且使用端口5701    2个副本

kubectl create deployment nginx1 --image=nginx  -n kube-public --port=5701 --replicas=2

//描述某个资源的详细信息

kubectl describe deployment nginx-wl -n kube-public
kubectl describe pod nginx-wl-d47f99cb6-hv6gz -n kube-public

//查看命名空间kube-public 中的pod 信息

kubectl get pods -n kube-public

NAME                       READY   STATUS    RESTARTS   AGE
nginx-wl-d47f99cb6-hv6gz   1/1     Running   0          24m

//kubectl exec可以跨主机登录容器，docker exec 只能在容器所在主机上登录

kubectl exec -it nginx1-d47f99cb6-hv6gz bash -n kube-public

查看pod中的某个容器的日志【-p查看pod重启前日志 用于排查故障。（莫名其妙重启pod，工作常用）】

kubectl logs nginx1-d47f99cb6-hv6gz [-c 容器名] [-p]

不指定-c则显示pod中第一个容器的日志

-p查看pod重启前日志 用于排查故障。（莫名其妙重启pod，工作常用）

//删除（重启）pod资源，由于存在deployment/rc之类的副本控制器，删除pod也会重新拉起来

手动上传镜像后，创建pod时仍然会拉取镜像。此时可以直接重启正在拉取镜像的pod，这样pod重启后就会使用本地镜像

kubectl delete pod nginx1-d47f99cb6-hv6gz -n kube-public

//若pod无法删除，总是处于terminate状态，则要强行删除pod【重要】

kubectl delete pod  -n  --force --grace-period=0

加上两个选项
--force 
--grace-period=0
grace-period表示过渡存活期，默认30s，在删除pod之前允许pod慢慢终止其上的容器进程，从而优雅退出，0表示立即终止pod

//扩缩容

kubectl scale deployment nginx1 --replicas=2 -n kube-public    # 扩容
kubectl scale deployment nginx1 --replicas=1 -n kube-public    # 缩容

若--replicas=0 没有任何pod资源，但是控制器还存在

//删除副本控制器

若要完全删除pod，即使删除了也会被deployment重新拉起。此时应该直接删除副本控制器

kubectl delete deployment nginx1 -n kube-public
kubectl delete deployment/nginx1 -n kube-public

 批量删除同一控制器下的！！！所有！！！pod资源

kubectl delete -n kube-public        deployments.apps --all
                                         资源类型      所有

另外注意，通过kubelet run

kubelet run

运行的pod，挂了就挂了。

---

而通过kubectl create deployment 

kubectl create deployment 

等控制器拉起的pod，只要控制器存在，挂了也会被拉起。

项目的生命周期：创建-->发布-->更新-->回滚-->删除

1、创建    kubectl create命令
●创建并运行一个或多个容器镜像。
●创建一个deployment 或job 来管理容器。
kubectl create --help

//启动 nginx 实例，暴露容器端口 80，设置副本数 3

kubectl create deployment nginx02 --image=nginx:1.14 --port=80 --replicas=3

kubectl get pods
kubectl get all

2、发布    kubectl expose命令
●将资源暴露为新的 Service（防止ip变动）。

kubectl expose --help

//为deployment的nginx创建service，并通过Service的80端口转发至容器的80端口上，Service的名称为nginx-service，类型为NodePort

kubectl expose deployment nginx02 --port=80 --target-port=80 --name=nginx-service --type=NodePort -n kube-public
                        pod资源名|service端口| 容器/pod的端口 |--name指定名称（同命名空间内不能有同名）

 查看kube-public创建的pod的端口

kybectl get svc -n kube-public

 

 使用任意一个node节点的ip+端口访问

192.168.80.102:30801

Kubernetes 之所以需要 Service，一方面是因为 Pod 的 IP 不是固定的（Pod可能会重建），另一方面则是因为一组 Pod 实例之间总会有负载均衡的需求。
Service 通过 Label Selector 实现的对一组的 Pod 的访问。
对于容器应用而言，Kubernetes 提供了基于 VIP（虚拟IP） 的网桥的方式访问 Service，再由 Service 重定向到相应的 Pod。

service 的 4 种类型【重中之重】

• ClusterIP：默认的service资源的类型，提供clusterIP供K8S集群内部访问【由外向内】
• NodePort：会在每个Node节点上开启一个端口，K8S集群内部和外部的用户都可以通过NodeIP:NodePort访问service以及其关联的Pod【由外向内】
• LoadBalancer：使用公有云的LB服务和service做映射，用户可以使用公有云LB服务的IP地址即可将请求转发到Node节点，再通过NodeIP:NodePort访问service以及其关联的Pod【由外向内】
• ExternalName：相当于给一个域名或IP做别名，Pod可以通过这个service访问相关的外部服务【由外向内】

service 的端口

port ：service 资源的 clusterIP 所使用的端口
nodePort ：在NodePort类型的service所定义的，在每个Node节点上开启的端口（默认范围为30000~32767）
targetPort ：service 将发送给 port 或 nodePort 的请求 再次转发到后端的 Pod 的容器端口【port / nodePort  →  Pod】

containerPort ：创建 Pod 时所指定的容器端口

K8S集群内部 http://clusterIP:port  -->  podIP:containerPort
K8S集群外部 http://nodeIP:nodePort  -->  podIP:containerPort

//查看pod网络状态详细信息和 Service暴露的端口

kubectl get pods,svc -o wide

NAME                        READY   STATUS    RESTARTS   AGE   IP            NODE            NOMINATED NODE
pod/nginx-cdb6b5b95-fjm2x   1/1     Running   0          44s   172.17.26.3   192.168.80.101   
pod/nginx-cdb6b5b95-g28wz   1/1     Running   0          44s   172.17.36.3   192.168.80.102   
pod/nginx-cdb6b5b95-x4m24   1/1     Running   0          44s   172.17.36.2   192.168.80.102   

NAME                    TYPE        CLUSTER-IP   EXTERNAL-IP   PORT(S)        AGE   SELECTOR
service/kubernetes      ClusterIP   10.0.0.1             443/TCP        14d   
service/nginx-service  NodePort    10.0.0.189           80:44847/TCP   18s   run=nginx

//查看关联后端的节点地址

kubectl get endpoints
kubectl describe endpoints [service资源名] #可以在多endpoints时显示所有endpoints

//查看 service 的描述信息

kubectl describe svc nginx

//在 node01 节点上操作，查看负载均衡端口

yum install ipvsadm -y
ipvsadm -Ln
ipvsadm -Ln -t [ip:port] #-t可以指定地址

//外部访问的IP和端口
TCP  192.168.80.101:44847 rr
  -> 172.17.26.3:80               Masq    1      0          0         
  -> 172.17.36.2:80               Masq    1      0          0         
  -> 172.17.36.3:80               Masq    1      0          0     
//pod集群组内部访问的IP和端口
TCP  10.0.0.189:80 rr
  -> 172.17.26.3:80               Masq    1      0          0         
  -> 172.17.36.2:80               Masq    1      0          0         
  -> 172.17.36.3:80               Masq    1      0          0     

//在 node02 节点上操作，同样方式查看负载均衡端口

yum install ipvsadm -y
ipvsadm -Ln

TCP  192.168.80.102:44847 rr
  -> 172.17.26.3:80               Masq    1      0          0         
  -> 172.17.36.2:80               Masq    1      0          0         
  -> 172.17.36.3:80               Masq    1      0          0         
 
TCP  10.0.0.189:80 rr
  -> 172.17.26.3:80               Masq    1      0          0         
  -> 172.17.36.2:80               Masq    1      0          0         
  -> 172.17.36.3:80               Masq    1      0          0    

curl 10.0.0.189
curl 192.168.80.101:44847

//在master01操作 查看访问日志

kubectl logs nginx-cdb6b5b95-fjm2x
kubectl logs nginx-cdb6b5b95-g28wz
kubectl logs nginx-cdb6b5b95-x4m24

3、更新    kubectl set

●更改现有应用资源一些信息。

kubectl set --help

总结

kubectl set image deployment <资源名称> <容器名>=<镜像名>

kubectl rollout history deployment <资源名称>
kubectl rollout undo deployment <资源名称>  [--to-revision= ]
kubectl rollout status deployment <资源名称>

//获取修改模板

kubectl set image --help
Examples:
  # Set a deployment's nginx container image to 'nginx:1.9.1', and its busybox container image to 'busybox'.
  kubectl set image deployment/nginx busybox=busybox nginx=nginx:1.9.1
                       资源名称            容器名称        镜像

//查看当前 nginx 的版本号

curl -I http://192.168.80.101:44847
curl -I http://192.168.80.102:44847

获取容器名 

kubectl get -n kube-public pods -o wide
#查看pod名
kubectl describe -n kube-public pod [完整pod_name，包括后面的随机数]
#查看某一个pod详细信息

//将nginx 版本更新为 1.15 版本

kubectl set image deployment/nginx   nginx=nginx:1.15
                    控制器  pod资源名  容器名   镜像

 //处于动态监听 pod 状态，由于使用的是滚动更新方式，所以会先生成一个新的pod，然后删除一个旧的pod，往后依次类推

kubectl get pods -w

滚动更新详解

kubectl get all

DESIRED：表示期望的状态是 10 个 READY 的副本
CURRENT：表示当前副本的总数: 即8 个日副本 + 5 个新副本
UP_TO-DATE：表示当前已经完成更新的副本数: 即 5个新副本
AVAILABLE：表示当前处于 READY 状态的副本数: 即8个日副本。

---

kubectl describe deployment/nginx

滚动更新通过参数 maxSurge 和 maxUnavailable 来控制副本替换的数量
maxSurge：此参数控制滚动更新过程中副本总数的超过 DESIRED 的上限。maxSurge 可以是具体的整数（比如 3），也可以是百分百，向上取整。maxSurge 默认值为 25%。
例如，DESIRED 为 10，那么副本总数的最大值为 10 + 10 * 25% = 13，即 CURRENT 为 13。

25% max unavailable   滚动更新过程中，销毁的Pod数量不超过期望副本数的25%，向下取整
25% max surge         滚动更新过程中，新增的Pod数量不超过期望副本数的25%，向上取整

期望的Pod副本数是10个，销毁的数量2，新增3        整个更新过程中Pod的数量会一致保持在 8 ~ 13

maxUnavailable：此参数控制滚动更新过程中，不可用的副本相占 DESIRED 的最大比例。maxUnavailable 可以是具体的整数（比如 3），也可以是百分百，向下取整。 maxUnavailable 默认值为 25%。

例如，DESIRED 为 10，那么可用的副本数至少要为 10 - 10 * 25% = 8，即 AVAILABLE 为 8。

因此 maxSurge 值越大，初始创建的新副本数量就越多；maxUnavailable 值越大，初始销毁的旧副本数量就越多。

理想情况下，DESIRED 为 10 的滚动更新的过程应该是这样的：
首先创建 3 个新副本使副本总数达到 13 个。
然后销毁 2 个旧副本使可用的副本数降到 8 个。
当这 2 个旧副本成功销毁后，可再创建 2 个新副本，使副本总数保持为 13 个。
当新副本通过 Readiness 探测后，会使可用副本数增加，超过 8。
进而可以继续销毁更多的旧副本，使可用副本数回到 8。
旧副本的销毁使副本总数低于 13，这样就允许创建更多的新副本。
这个过程会持续进行，最终所有的旧副本都会被新副本替换，滚动更新完成。

//再看更新好后的 Pod 的 ip 会改变

kubectl get pods -o wide

//再看 nginx 的版本号

curl -I http://192.168.80.101:44847
curl -I http://192.168.80.102:44847

4、回滚    kubectl rollout 

●对资源进行回滚管理
 

kubectl rollout --help

//查看历史版本

kubectl rollout history deployment/nginx 

//执行回滚到上一个版本

kubectl rollout undo deployment/nginx

//执行回滚到指定版本

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

//检查回滚状态

kubectl rollout status deployment/nginx

5、删除    kubectl delete

//删除副本控制器

kubectl delete deployment/nginx

//删除service

kubectl delete svc/nginx-service

kubectl get all

应用的发布策略

 蓝绿发布

用户无感知 升级方便。但是需要两套系统，成本高（大公司才用的起），若出问题影响大。 

滚动发布  

  每次只更新一个或多个服务。节约资源，但是部署时间慢，不易于回滚

金丝雀发布/灰度发布（Canary Release）

Deployment控制器支持自定义控制更新过程中的滚动节奏，如“暂停(pause)”或“继续(resume)”更新操作。比如等待第一批新的Pod资源创建完成后立即暂停更新过程，此时，仅存在一部分新版本的应用，主体部分还是旧的版本。然后，再筛选一小部分的用户请求路由到新版本的Pod应用，继续观察能否稳定地按期望的方式运行。确定没问题之后再继续完成余下的Pod资源滚动更新，否则立即回滚更新操作。这就是所谓的金丝雀发布。

挑选一部分用户到新版本，其余用户继续使用老版本。若新版本无问题则扩大用户范围。

（1）更新deployment的版本，并配置暂停deployment

kubectl set image deployment <资源名称> <容器名>=<镜像名>  &&  kubectl rollout pause deployment <资源名称>
       #                                          更新资源 && 暂停更新
kubectl rollout resume deployment <资源名称>

kubectl set image deployment/nginx nginx=nginx:1.14 && kubectl rollout pause deployment/nginx
kubectl rollout status deployment/nginx　　#观察更新状态

 （2）监控更新的过程，可以看到已经新增了一个资源，但是并未按照预期的状态去删除一个旧的资源，就是因为使用了pause暂停命令

kubectl get pods -w 

curl [-I] 10.0.0.189
curl [-I] 192.168.80.101:44847

（3）确保更新的pod没问题了，继续更新

kubectl rollout resume deployment/nginx

#若还是不想一次性完成更新，继续灰度发布（继续更新&&加上再次暂停）
kubectl rollout resume deployment/nginx && kubectl rollout pause deployment deployment/nginx

（4）查看最后的更新情况

kubectl get pods -w 

curl [-I] 10.0.0.189
curl [-I] 192.168.80.101:44847

 

声明式管理方法（通过yaml文件 更细致）

1.适合于对资源的修改操作
2.声明式资源管理方法依赖于资源配置清单文件对资源进行管理
资源配置清单文件有两种格式：yaml（人性化，易读），json（易于api接口解析）
3.对资源的管理，是通过事先定义在统一资源配置清单内，再通过陈述式命令应用到k8s集群里
4.语法格式

kubectl create/apply/delete -f xxxx.yaml
create与apply相似，但是create创建的不能更新。常用apply

kubectl edit <资源类型> <资源名称>
kubectl explain <资源类型>.<字段1>.<字段2>

//查看资源配置清单

kubectl get deployment nginx -o yaml

//解释资源配置清单

kubectl explain deployment.metadata

kubectl get service nginx -o yaml
kubectl explain service.metadata

//修改资源配置清单并应用
离线修改：
修改yaml文件，并用 kubectl apply -f xxxx.yaml 文件使之生效
注意：当apply不生效时，先使用delete清除资源，再apply创建资源

kubectl get service nginx -o yaml > nginx-svc.yaml
vim nginx-svc.yaml                #修改port: 8080

kubectl delete -f nginx-svc.yaml
kubectl apply -f nginx-svc.yaml
kubectl get svc

在线修改：
直接使用 kubectl edit service nginx 在线编辑资源配置清单并保存退出即时生效（如port: 888）
PS：此修改方式不会对yaml文件内容修改

kubectl edit service nginx
#别忘了-n 指定命名空间

//删除资源配置清单

陈述式删除：

kubectl delete service nginx

声明式删除：

kubectl delete -f nginx-svc.yaml