El único punto de entrada para que un clúster de Kubernetes administre los recursos del clúster es llamar a la interfaz apiserver a través del método correspondiente.

kubectl es la herramienta oficial de línea de comandos CLI, que se utiliza para comunicarse con el apiserver, organizar y convertir los comandos ingresados por el usuario en la línea de comando en información que el apiserver puede reconocer, logrando así una forma efectiva de administrar varios recursos de k8.

Es más conveniente agregar, eliminar y verificar recursos, pero no es fácil modificarlos.

kubectl的使用学习

kubectl --help  或  kubectl -h

2. comandos básicos de kubectl

#查看版本信息
kubectl version

#查看资源对象简写
kubectl api-resources

#查看集群信息
kubectl cluster-info

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

#node节点查看日志
journalctl -u kubelet -f

3. Ver información básica

kubectl get <resource> [-o wide|json|yaml] [-n namespace]
获取资源的相关信息，-n 指定命令空间，-o 指定输出格式
resource可以是具体资源名称，如pod nginx-xxx；也可以是资源类型，如pod；或者all(仅展示几种核心资源，并不完整)
--all-namespaces 或 -A ：表示显示所有命名空间，
--show-labels ：显示所有标签
-l app ：仅显示标签为app的资源
-l app=nginx ：仅显示包含app标签，且值为nginx的资源

#查看指定命名空间的pod资源
kubectl get pods -n <命名空间>  #不指定，默认查看default命名空间

#查看指定命名空间的关键资源
kubectl get -n <命名空间> all

#查看指定资源
kubectl get -n <命名空间> svc

#查看pod资源的详细信息
kubectl get -n kube-flannel pods -o wide
kubectl get -n kube-flannel pods -o=wide
kubectl get -n kube-flannel pods -owide

#以yaml显示资源配置信息
kubectl get -n kube-flannel pods -o yaml

1. Ver información de la etiqueta

#查看pods的标签信息
kubectl get pods -A --show-labels

#-l 查看包含指定标签的pods
kubectl get pods -A --show-labels -l app=flannel

2. Ver el estado del nodo maestro.

kubectl get componentstatuses
kubectl get cs

3. Ver espacio de nombres

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

4. Crear y eliminar aplicaciones de espacio de nombres.

#创建命名空间
kubectl create ns app
kubectl get ns

#删除命名空间
kubectl delete namespace app
kubectl get ns

5. Cree un controlador de réplica (implementación) en el espacio de nombres kube-public para iniciar el Pod (nginx-www)

kubectl create deployment nginx-www --image=nginx  -n kube-public --port=80 --replicas=2

--replicas：指定pod副本数

6. Describe los detalles de un recurso.

kubectl describe deployment nginx-www -n kube-public

kubectl describe pod nginx-www-f6d5f85dc-72h85 -n kube-public

7. kubectl exec puede iniciar sesión en el contenedor a través de hosts, mientras que docker exec solo puede iniciar sesión en el host donde se encuentra el contenedor.

kubectl exec -it nginx-www-f6d5f85dc-72h85 -n kube-public bash

8. Ver los registros de los contenedores en el pod.

kubectl logs nginx-www-f6d5f85dc-28mb4 [-c  <容器名>] -p

-c 容器名：查看指定容器名的日志
-p ：查看pod重启前日志

kubectl logs nginx-www-f6d5f85dc-28mb4 -n kube-public

9. Eliminar (reiniciar) los recursos del pod

删除（重启）pod资源，由于存在deployment/rc之类的副本控制器，删除pod也会重新拉起来
kubectl delete pod nginx-www-f6d5f85dc-72h85 -n kube-public

若pod无法删除，总是处于terminate状态，则要强行删除pod
kubectl delete pod <pod-name> -n <namespace> --force --grace-period=0
#grace-period表示过渡存活期，默认30s，在删除pod之前允许pod慢慢终止其上的容器进程，从而优雅退出，0表示立即终止pod

10. Ampliar y reducir el número de copias.

kubectl scale deployment nginx-www --replicas=6 -n kube-public	# 扩容
kubectl scale deployment nginx-www --replicas=3 -n kube-public	# 缩容

11. Eliminar el controlador de réplica.

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

4. Ciclo de vida del proyecto

Crear-->Publicar-->Actualizar-->Revertir-->Eliminar

1.Crear

Cree y ejecute una o más imágenes de contenedor.
Cree una implementación o trabajo para administrar contenedores.

启动 nginx 实例，暴露容器端口 80，设置副本数 3
kubectl create deployment nginx --image=nginx:1.14 --port=80 --replicas=3
 
kubectl get pods
kubectl get all

2.Publicar

La razón por la que Kubernetes requiere servicio es que, por un lado, la IP del Pod no es fija (el Pod puede reconstruirse) y, por otro lado, siempre existe la necesidad de equilibrar la carga entre un grupo de instancias de Pod. .
El servicio implementa el acceso a un grupo de Pods a través del Selector de etiquetas.
Para aplicaciones de contenedor, Kubernetes proporciona un método de puente basado en VIP (IP virtual) para acceder al Servicio y luego el Servicio redirige al Pod correspondiente.

Tipo de servicio:

ClusterIP: proporciona una IP virtual dentro del clúster para el acceso al Pod (tipo de servicio predeterminado)
NodePort: abra un puerto en cada nodo para acceso externo. Kubernetes abrirá un puerto en cada nodo y el puerto de cada nodo es el mismo. Los programas fuera del clúster de Kubernetes pueden acceder a él a través de NodeIp: NodePort. Servicio. Cada puerto solo puede ser un servicio y el rango de puertos predeterminado solo puede ser 30000-32767.
LoadBalancer: asigne LoadBalancer a la dirección de LoadBalancer proporcionada por el proveedor de servicios en la nube configurándolo. Este uso solo se utiliza en escenarios en los que el Servicio está configurado en la plataforma de nube de un proveedor de servicios de nube pública. Se accede a través de un equilibrador de carga externo y, por lo general, la implementación de LoadBalancer en una plataforma en la nube requiere costos adicionales. Una vez enviado el servicio, Kubernetes llamará a CloudProvider para crear un servicio de equilibrio de carga para usted en la nube pública y configurará la dirección IP del Pod proxy para el servicio de equilibrio de carga como backend.
externalName: asigna el nombre del servicio a un nombre de dominio DNS, que es equivalente al registro CNAME del servicio DNS. Se utiliza para permitir que el Pod acceda a recursos fuera del clúster. No vincula ningún recurso en sí.

2.1 Exponer recursos como nuevos Servicios

为deployment的nginx创建service，并通过Service的80端口转发至容器的80端口上，Service的名称为nginx-service，类型为NodePort
kubectl expose deployment nginx --port=80 --target-port=80 --name=nginx-service --type=NodePort

--name：指定service名称，默认为deployment名称相同
--type：指定service类型

2.2 Ver los detalles del estado de la red del pod y los puertos expuestos al servicio

kubectl get pods,svc -o wide

2.3 Ver los nodos asociados con el backend

kubectl get endpoints

2.4 Ver la información de descripción del servicio.

kubectl describe svc nginx

2.5 Operar en el nodo y verificar el puerto de equilibrio de carga

yum install ipvsadm -y
ipvsadm -Ln

3. actualizar

3.1 Actualización continua

kubectl get all

DESIRED：表示期望的状态是 3 个 READY 的副本
CURRENT：表示当前副本的总数
UP_TO-DATE：表示当前已经完成更新的副本数
AVAILABLE：表示当前处于 READY 状态的副本数

kubectl describe deployment/nginx

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

max Surge：此参数控制滚动更新过程中副本总数的超过 DESIRED 的上限。maxSurge 可以是具体的整数（比如 3），也可以是百分百，向上取整。maxSurge 默认值为 25%。

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

#查看当前 nginx 的版本号
curl -I http://192.168.88.70:32587

#将nginx 版本更新为 1.15 版本
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 -I http://192.168.88.70:32587

4.Revertir

#查看历史版本
kubectl rollout history deployment/nginx 

#执行回滚到上一个版本
kubectl rollout undo deployment/nginx

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

#检查回滚状态
kubectl rollout status deployment/nginx

5.Eliminar

#删除副本控制器
kubectl delete deployment/nginx

#删除service
kubectl delete svc/nginx-service

kubectl get all

5. Lanzamiento Canary (lanzamiento en escala de grises)

El controlador de implementación admite un control personalizado del ritmo de desplazamiento durante el proceso de actualización, como "pausar" o "reanudar" las operaciones de actualización. Por ejemplo, el proceso de actualización se pausa inmediatamente después de que se crea el primer lote de nuevos recursos Pod. En este momento, solo existe una parte de la nueva versión de la aplicación y la parte principal sigue siendo la versión anterior. Luego, filtre una pequeña porción de las solicitudes de los usuarios y enrútelas a la nueva versión de la aplicación Pod, y continúe observando si puede ejecutarse de manera estable y de la manera deseada. Después de confirmar que no hay ningún problema, continúe completando la actualización continua restante de los recursos del Pod; de lo contrario, revierta la operación de actualización inmediatamente. Esto se llama liberación canaria.

1. Actualice la versión de implementación y configure la implementación de suspensión.

kubectl set image deployment/nginx nginx=nginx:1.14 && kubectl rollout pause deployment/nginx

kubectl rollout status deployment/nginx　　#观察更新状态

2. Supervise el proceso de actualización. Puede ver que se ha agregado un nuevo recurso, pero un recurso antiguo no se elimina como se esperaba. Esto se debe a que se utiliza el comando de pausa.

kubectl get pods -owide

curl -I http://10.244.1.19

curl -I http://10.244.1.18

3. Asegúrese de que no haya problemas con el pod actualizado y continúe actualizando.

kubectl rollout resume deployment/nginx

4. Consulta las últimas actualizaciones

kubectl get pods -w 

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

6. Gestión declarativa de recursos

Adecuado para operaciones de modificación de recursos.
El método declarativo de gestión de recursos se basa en archivos de manifiesto de configuración de recursos para gestionar los recursos.
El archivo de lista de configuración de recursos tiene dos formatos: yaml (amigable para humanos y fácil de leer), json (interfaz API fácil de analizar)
La gestión de recursos se define de antemano en una lista de configuración de recursos unificada y luego se aplica al clúster k8s mediante comandos declarativos.
Formato de sintaxis: kubectl crear/aplicar/eliminar -f xxxx.yaml

1. Verifique la lista de configuración de recursos

kubectl get deployment nginx -o yaml

2. Explique la lista de configuración de recursos.

kubectl explain deployment.metadata

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

3. Modifique la lista de configuración de recursos y aplíquela.

3.1 Modificación sin conexión

修改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

3.2 Modificación en línea

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

4. Eliminar la lista de configuración de recursos.

陈述式删除：
kubectl delete service nginx

声明式删除：
kubectl delete -f nginx-svc.yaml

explicación detallada de kubectl

1. Introducción a kubectl