kubectl é a ferramenta oficial de linha de comando CLI, usada para se comunicar com o apiserver, organizar e converter os comandos inseridos pelo usuário na linha de comando em informações que o apiserver pode reconhecer, realizando assim uma maneira eficaz de gerenciar vários recursos k8s.

É mais conveniente adicionar, excluir e verificar recursos, mas não é fácil modificá-los.

kubectl的使用学习

kubectl --help  或  kubectl -h

Dois, comandos básicos do kubectl

#查看版本信息
kubectl version

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

#查看集群信息
kubectl cluster-info

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

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

3. Veja informações básicas

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. Veja as informações do rótulo

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

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

2. Verifique o status do nó mestre

kubectl get componentstatuses
kubectl get cs

3. Ver espaço para nome

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

4. Crie e exclua aplicativo de namespace

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

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

5. Crie um controlador de réplica (implantação) no namespace kube-public para iniciar o pod (nginx-www)

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

--replicas：指定pod副本数

6. Descreva os detalhes de um recurso

kubectl describe deployment nginx-www -n kube-public

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

7. kubectl exec pode efetuar login no contêiner entre hosts, enquanto docker exec só pode efetuar login no host onde o contêiner está localizado.

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

8. Visualize os logs dos contêineres no pod

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

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

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

9. Exclua (reinicie) recursos do 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. Amplie e reduza o número de cópias

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

11. Exclua o controlador de réplica

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

4. Ciclo de vida do projeto

Criar -> Publicar -> Atualizar -> Reverter -> Excluir

1.Criar

Crie e execute uma ou mais imagens de contêiner.
Crie uma implantação ou trabalho para gerenciar os contêineres.

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

2.Publicar

A razão pela qual o Kubernetes requer serviço é que, por um lado, o IP do Pod não é fixo (o Pod pode ser reconstruído) e, por outro lado, sempre há necessidade de balanceamento de carga entre um grupo de instâncias do Pod .
O serviço implementa o acesso a um grupo de pods por meio do Label Selector.
Para aplicativos de contêiner, o Kubernetes fornece um método de ponte baseado em VIP (IP virtual) para acessar o serviço e, em seguida, o serviço redireciona para o pod correspondente.

O tipo de serviço:

ClusterIP: fornece um IP virtual dentro do cluster para acesso ao pod (tipo de serviço padrão)
NodePort: Abra uma porta em cada Node para acesso externo. O Kubernetes abrirá uma porta em cada Node e a porta de cada Node é a mesma. Programas fora do cluster Kubernetes podem acessá-lo através do NodeIp: NodePort. Service. Cada porta pode ser apenas um serviço e o intervalo de portas padrão pode ser apenas 30000-32767.
LoadBalancer: mapeie o LoadBalancer para o endereço LoadBalancer fornecido pelo provedor de serviços de nuvem configurando-o. Este uso é utilizado apenas em cenários em que o Serviço é configurado na plataforma de nuvem de um provedor de serviços de nuvem pública. Acessado por meio de um balanceador de carga externo, geralmente a implantação do LoadBalancer em uma plataforma de nuvem requer custos adicionais. Depois que o serviço for enviado, o Kubernetes chamará o CloudProvider para criar um serviço de balanceamento de carga para você na nuvem pública e configurar o endereço IP do pod com proxy para o serviço de balanceamento de carga como back-end.
externalName: mapeia o nome do serviço para um nome de domínio DNS, que é equivalente ao registro CNAME do serviço DNS. Ele é usado para permitir que o pod acesse recursos fora do cluster. Ele não vincula nenhum recurso em si.

2.1 Expor recursos como novos serviços

为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 Visualizar detalhes do status da rede do pod e portas expostas ao serviço

kubectl get pods,svc -o wide

2.3 Visualize os nós associados ao backend

kubectl get endpoints

2.4 Visualizar as informações de descrição do serviço

kubectl describe svc nginx

2.5 Opere no nó e verifique a porta de balanceamento de carga

yum install ipvsadm -y
ipvsadm -Ln

3.Atualização

3.1 Atualização contínua

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.Reversão

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

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

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

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

5.Excluir

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

#删除service
kubectl delete svc/nginx-service

kubectl get all

5. Liberação Canário (liberação em escala de cinza)

O controlador de implantação oferece suporte ao controle personalizado do ritmo de rolagem durante o processo de atualização, como "pausar" ou "continuar" operações de atualização. Por exemplo, o processo de atualização é pausado imediatamente após a criação do primeiro lote de novos recursos do Pod. No momento, existe apenas uma parte da nova versão do aplicativo, e a parte principal ainda é a versão antiga. Em seguida, filtre uma pequena parte das solicitações do usuário e encaminhe-as para a nova versão do aplicativo Pod, e continue observando se ele pode ser executado de forma estável e da maneira desejada. Depois de confirmar que não há problema, continue a concluir a atualização contínua restante dos recursos do pod, caso contrário, reverta a operação de atualização imediatamente. Isso é chamado de versão canário.

1. Atualize a versão de implantação e configure a implantação de suspensão

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

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

2. Monitore o processo de atualização. Você pode ver que um novo recurso foi adicionado, mas um recurso antigo não foi excluído conforme o esperado. Isso ocorre porque o comando pause é usado.

kubectl get pods -owide

curl -I http://10.244.1.19

curl -I http://10.244.1.18

3. Certifique-se de que não haja problemas com o pod atualizado e continue atualizando.

kubectl rollout resume deployment/nginx

4. Verifique as atualizações mais recentes

kubectl get pods -w 

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

6. Gestão declarativa de recursos

Adequado para modificar operações em recursos
O método declarativo de gerenciamento de recursos depende de arquivos de manifesto de configuração de recursos para gerenciar recursos.
O arquivo da lista de configuração de recursos tem dois formatos: yaml (amigável e fácil de ler), json (fácil de analisar a interface da API)
O gerenciamento de recursos é definido antecipadamente em uma lista unificada de configuração de recursos e depois aplicado ao cluster k8s por meio de comandos declarativos.
Formato de sintaxe: kubectl create/apply/delete -f xxxx.yaml

1. Veja a lista de configuração de recursos

kubectl get deployment nginx -o yaml

2.Explique a lista de alocação de recursos

kubectl explain deployment.metadata

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

3. Modifique a lista de configuração de recursos e aplique-a

3.1 Modificação off-line

修改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 Modificação on-line

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

4. Excluir lista de configuração de recursos

陈述式删除：
kubectl delete service nginx

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

explicação detalhada do kubectl

1. Introdução ao kubectl