Kubectl 命令（命令式 与 声明式）与 K8S Ports 访问端口

Kubernetes 中文手册
Kubernetes kubectl 命令表：http://docs.kubernetes.org.cn/683.html

管理k8s各种资源的方法有 陈述式（命令式） 和 声明式 两种。

• 陈述式 ：kubectl run/get/delete/set/rollout/ ，适合 增、删、查
• 声明式 yaml/json kubectl create/apply/delete -f * .yaml/json ，适合 改、增、删

一、陈述式（命令式）管理资源方法

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

kubectl --help
k8s中文文档: http://docs.kubernetes.org.cn/683.html

• 4 . 对资源的增、删、查操作比较方便，但对改的操作就不容易了

查看 配置信息

//查看版本信息
kubectl version
Client Version: version.Info{Major:"1", Minor:"15", GitVersion:"v1.15.1",

//查看资源对象简写，全拼和简写对照，
//如 namespaces 对应 ns、pods po、nodes no、deployments  deploy
//service svc、replicasets rs、persistentvolumeclaims pvc

kubectl api-resources
kubectl describe

//查看集群信息
kubectl cluster-info

//配置kubectl自动补全，
source <(kubectl completion bash)

//Node节点查看日志，动态跟踪
journalctl -u kubelet -f

查看 基本信息 get

获取资源的相关信息 get

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

，-n: 指定命令空间，-o: 指定输出格式
resource可以是具体资源名称，如 pod nginx-xxx；也可以是资源类型，如 pod；或者all（仅展示几种核心资源，并不完整)
--all-namespaces 或 -A :表示显示所有命令空间， 默认是 default 命名空间
--show-labels :显示所有标签
-l app :仅显示标签为app的资源
-l app=nginx :仅显示包含app标签，且值为nginx的资源

如： kubectl get pod
kubectl get pod --all-namespaces
kubectl get pod --show-labels
kubectl get nodes
kubectl get pod nginx-deployment-f797cd5f7-dmtqn -o wide

查看 master 节点组件状态

kubectl get componentstatuses
kubectl get cs

命名空间相关 namespace

命名空间有：default、kube-system、kube-public 、kube-node-lease等

POD 运行在 命名空间中，允许不同命令空间的相同类型的POD资源重名

查看命令空间

kubectl get namespace
kubectl get ns

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

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

kubectl get all [-n default]

创建命名空间 app

kubectl create ns apps
kubectl get ns

删除命名空间 apps

• 删之前记得看命名空间中有没有资源。

kubectl delete namespace app
kubectl get ns

创建资源 create

**在 命名空间 kube-public 创建指定控制器 (deployment）来运行 Pod **

• 创建资源时 顺便 -n 指定命名空间（没有这个命名空间会去创建）
• –image：如果有本地有就用本地的镜像，本地没有就会去公有仓库拉取

kubectl create deployment nginx-test1 --image=nginx -n kube-public

#查看刚创建的pod
kubectl get pod -n kube-public
kubectl get all -n kube-public

用 kubectl get pod 查不到，因为 kubectl get pod 默认只展示 default 命名空间中的 pod

查看描述某个资源的详细信息 describe

描述某个资源的详细信息，包括创建过程，拉取哪个镜像，经过哪些组件

kubectl get pod

方式一：
kubectl describe deployment nginx-test1 -n kube-public

方式二：
kubectl describe pod nginx-test1-55f688dd9c-4qd2l -n kube-public

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

kubectl get pods -n kube-public

NAME READY STATUS RESTART SAGE
nginx-wl-XXXX

kubectl exec 可以跨主机登录容器，而 docker exec 只能在当前容器所在主机上登录
在 master 就能登录目标主机的容器

kubectl exec -it nginx-test1-55f688dd9c-4qd2l bash -n kube-public

删除（重启) pod资源

• 注：删除（重启) pod资源，但是由于存在 deployment/rc 之类的副本控制器，删除pod后 也会被重新拉起来
• 只删掉 pod 资源，相当于重启，kubelet 会重新拉起一个pod 资源，没有真正的删除；而通过 deployment 资源 来删除，deployment 控制器是用来管理POD 的，才会真正的删除
• 即创建的时候执行了 create deployment/rc

kubectl delete pod名 [命名空间]
kubectl delete pod/nginx-test1-55f688dd9c-4qd2l -n kube-public

发现删掉后还有，其实就是重启了

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

kubectl delete pod <pod-name> -n <namespace> --force --grace-period=O
#grace-period表示过渡存活期，默认30s，在删除pod之前允许POD慢慢终止其上的容器进程，从而优雅退出，0表示立即终止pod

类似 kill命令

扩容、缩容 scale --replicas=

扩容、缩容

需要 -n 指定命名空间，--replicas 表示指定扩展多少个资源。（扩容、减容很方便，这就是 k8s 的优势）
 
kubectl scale deployment nginx-test1 --replicas=2 -n kube-public   #扩容
kubectl scale deployment nginx-test1 --replicas=1 -n kube-public   #缩容

kubectl get all -n kube-public  #查看

通过副本控制器删除 pod

只删掉 pod 资源，相当于重启，kubelet 会重新拉起一个pod 资源，没有真正的删除，
而通过 deployment 资源 来删除，deployment 控制器是用来管理POD 的，才会真正的删除

需要 -n 指定命名空间

kubectl delete deployment nginx-test1 -n kube-public
kubectl delete deployment/nginx-test1 -n kube-public

pod 更新升级 set

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

kubectl set --help

//获取修改模板

kubectl set image --help

//查看当前nginx的版本号
curl -l http://192.168.10.50:30950

//将nginx版本更新为1.15版本
//#会先创建一个新的pod , 然后删除旧的pod
kubectl set image deployment/nginx nginx=nginx:1.15


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

#看更新好后的Pod 的ip会改变
kubectl get pods -o wide

//再看nginx的版本号
curl -l http://192.168.10.50:30950

对资源进行回滚管理 rollout

对资源进行回滚管理
kubectl rollout --help

//查看历史版本
kubectl rollout history deployment.apps/nginx-test1

//执行回滚到上一个版本
kubectl rollout undo deployment.apps/nginx-test1

//执行回滚到指定版本
kubectl rollout undo deployment.apps/nginx-test1 --to-revision=1

//检查回滚状态
kubectl rollout status deployment.apps/nginx-test1

kubectl get pods -w 跟踪查看pod 的变化

二、声明式

• 通过 yaml 或 Json 资源配置清单文件 在实现资源的管理，创建资源删除资源都要指定 yaml 文件。
• 就是将陈述式命令写到 配置文件中

kubectl create/apply -f *. yaml

2.1 声明式管理方法定义

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

2.2 查看、解释、修改资源配置 get、explain、apply

//查看资源配置清单
kubectl get deployment nginx -o yaml

//解释资源配置清单，指定 field
kubectl explain deployment.metadata

//查看资源配置清单
kubectl get service nginx -o yaml
//解释资源配置清单
kubectl explain service.metadata

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

eg：

kubectl get service nginx-test1 -o yaml > nginx-svc.yaml

vim nginx-svc.yaml
#修改port: 8080

#先使用 delete 清除资源
kubectl delete -f nginx-svc.yaml

#再 apply 创建资源
kubectl apply -f nginx-svc.yaml

kubectl get svc

2.3 在线修改资源

在线编辑资源配置清单并保存退出即时生效（如port: 8888)，此修改方式不会对yaml文件内容修改

就是vi编辑器，保存立即生效，但不会修改yaml源文件内容

kubectl edit service nginx-test1

2.4 删除资源配置清单

陈述式删除：

kubectl delete service nginx-test1

声明式删除：
将 apply 换成 delete 即可

kubectl delete -f nginx-svc.yaml

三、Kubernetes 集群中的 Ports 端口

集群中通过 service 来进行服务的转发和负载均衡。
service 通过label标签来选择、关联不同的 pod。

• 集群中有 多个Node
• Node 有 多个 Pod
• Pod 中有 多个容器
• 容器中有服务，比如 Nginx
• Service 只支持四层转发 ip:端口

4.1 port、nodeport、targetport、containerport分别是什么

• k8s集群 内部的 用户或者程序在 master、node 节点上通过 clusterip:port 访问，会被 service 转发到相应的 pod 上的 target-port，然后再有 target-port 转发（映射）到容器内部的程序所使用的 container port

• 用户或者程序在 ** k8s集群外部的** 通过访问 nodeip:nodeport，会被 service 转发到相应的 pod ip 上的 target-port，然后再有 target-port 转发（映射）到容器内部的程序所使用的 container port

注意：这里的 Node ip 就是 pod 所在的任意 Node 节点的物理网卡IP地址，它们使用的 nodeport 都是一样的。

• clusterip:port 是集群内部访问 service用的
• nodeip:nodeport 是集群外部访问 service用的
• containerPort 是容器内部的port

4.2 测试

kubectl expose deployment nginx --port=80 --target-port=80 --name=nginx-service --type=NodePort

或者

通过 nodeport 外部进行访问

在对应 node 节点上安装 ipvsadm 
yum install -y ipvsadm 
ipvsadm -Ln
查看转发

也可以在master 查看pod里面的日志
kubectl logs pod/nginx-test1-55f688dd9c-h8dmh

可以看到是通过 flannel 网卡转发的

四、项目生命周期相关命令

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

创建 run、create

1、创建 kubectl run 命令

• 创建并运行一个或多个容器镜像。
• 创建一个 deployment 或 job 来管理容器。
• kubectl run --help
• kubectl create --help

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

kubectl get pods

kubectl run nginx --image=nginx:1.14 --port=80 --replicas=3
kubectl get pods
kubectl get all

发布 expose

2、发布 kubectl expose 命令

• 将资源暴露为新的Service。

kubectl expose --help

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

kubectl expose deployment nginx --port=80 --target-port=80 --name=nginx-service --type=NodePort



---------------------------------------------------------------
Kubernetes 之所以需要Service，一方面是因为Pod 的 IP 不是固定的（Pod可能会重建)，另一方面则是因为一组Pod实例之间总会有负载均衡的需求。

Service 通过Label Selector实现的对一组的Pod的访问。

对于容器应用而言，Kubernetes提供了基于VIP(虚拟IP)的网桥的方式访问Service，再由 Service重定向到相应的 Pod。

service 的类型:
● ClusterIP:提供一个集群内部的虚拟IP以供Pod访问（service默认类型)

● NodePort:在每个Node上打开一个端口以供外部访问，Kubernetes将会在每个Node上打开一个端口并且每个kocde的端口都是一样的，通过NodeIp:NodePort的方式Kubernetes集群外部的程序可以访问Service。
注:每个端口只能是一种服务，端口范围只能是 30000-32767。

● LoadBalancer:通过外部的负载均衡器来访问，通常在云平台部署LoadBalancer还需要额外的费用。
---------------------------------------------------------------

总结

每个pod都会有一个pause (基础容器) 提供网络，存储命名空间。
pod内的容器共享同一个网络空间和数据卷提供一个init进程，来管理整个 pod 的生命周期