Versão do Cliente e Servidor Kubernetes - Guia kubectl

Introdução

Kubernetes é uma poderosa ferramenta de orquestração de contêineres que auxilia os desenvolvedores a implantar, escalar e gerenciar aplicações em contêineres. Conhecer as versões do cliente Kubernetes (kubectl) e do servidor é essencial para solucionar problemas, garantir a compatibilidade e gerenciar atualizações. Neste laboratório, você aprenderá como verificar as versões do cliente e do servidor e formatar a saída de diferentes maneiras.

Iniciar o Cluster Kubernetes

Antes de executar qualquer comando Kubernetes, você precisa de um cluster em execução. Para este laboratório, usaremos o Minikube para configurar um cluster Kubernetes local.

Primeiro, abra seu terminal e certifique-se de estar no diretório /home/labex/project:

cd ~/project

Em seguida, inicie o cluster Minikube com o seguinte comando:

minikube start

Este comando inicializa um cluster Kubernetes de nó único. O Minikube oferece uma maneira fácil de testar comandos Kubernetes localmente, sem a necessidade de um cluster remoto. O processo pode levar alguns minutos, pois o Minikube configura o cluster e instala os componentes necessários.

Para garantir que o cluster esteja em execução, você pode verificar seu status executando:

minikube status

Você deve ver um status indicando que o cluster está em execução. Se não estiver, tente reiniciar o Minikube com minikube delete seguido por minikube start.

Versão do Cliente e Servidor

Para visualizar as informações da versão do cliente e do servidor Kubernetes, use o seguinte comando:

kubectl version

Este comando exibirá detalhes tanto para o cliente (sua ferramenta kubectl local) quanto para o servidor (a API Kubernetes em execução no seu cluster). As informações da versão incluem as versões principais e secundárias, o hash de commit do Git, a data de compilação e muito mais.

Por exemplo, você pode ver uma saída como esta:

Client Version: version.Info{Major:"1", Minor:"26", GitVersion:"v1.26.0", ...}
Server Version: version.Info{Major:"1", Minor:"26", GitVersion:"v1.26.0", ...}

A "Client Version" mostra a versão da sua ferramenta kubectl, enquanto a "Server Version" se refere ao servidor da API Kubernetes no cluster. Idealmente, essas versões devem corresponder ou ser compatíveis para que os comandos funcionem corretamente.

Obter Apenas a Versão do Cliente

Às vezes, você pode precisar apenas verificar a versão da sua ferramenta kubectl, por exemplo, ao solucionar problemas locais ou verificar a compatibilidade com um cluster remoto. Para exibir apenas a versão do cliente, use o seguinte comando:

kubectl version --client

Este comando exibe apenas a versão do cliente sem tentar se conectar a um cluster Kubernetes. Isso é particularmente útil quando nenhum cluster está disponível, ou você deseja verificar a instalação do kubectl em sua máquina.

A saída será semelhante a esta:

Client Version: version.Info{Major:"1", Minor:"26", GitVersion:"v1.26.0", ...}

Exibir Informações da Versão do Servidor em Formato JSON

O Kubernetes suporta a saída de informações em formatos estruturados como JSON, que é amplamente utilizado em automação e integração com outras ferramentas. Para exibir as informações da versão do servidor em formato JSON, execute:

kubectl version --output=json

Este comando recupera as informações da versão tanto para o cliente quanto para o servidor e as formata como um objeto JSON. A saída JSON é legível por máquina e pode ser analisada por scripts ou aplicações externas.

Aqui está um exemplo de saída JSON:

{
  "clientVersion": {
    "major": "1",
    "minor": "26",
    "gitVersion": "v1.26.0",
    ...
  },
  "serverVersion": {
    "major": "1",
    "minor": "26",
    "gitVersion": "v1.26.0",
    ...
  }
}

Exibir Informações da Versão do Servidor em Formato YAML

O Kubernetes frequentemente usa YAML para arquivos de configuração e manifestos, tornando-o uma escolha natural para saída legível por humanos. Para exibir as informações da versão do servidor em formato YAML, execute:

kubectl version --output=yaml

Este comando recupera as informações da versão e as formata como um documento YAML. YAML é mais fácil para os humanos lerem e é comumente usado em fluxos de trabalho do Kubernetes.

Por exemplo, a saída YAML pode ser semelhante a esta:

clientVersion:
  major: "1"
  minor: "26"
  gitVersion: v1.26.0
  ...
serverVersion:
  major: "1"
  minor: "26"
  gitVersion: v1.26.0
  ...

Resumo

Neste laboratório, você aprendeu a:

Iniciar um cluster Kubernetes local usando o Minikube.
Recuperar informações da versão do cliente e do servidor usando kubectl version.
Verificar a versão do cliente independentemente com a flag --client.
Formatar informações da versão nos formatos JSON e YAML para diferentes casos de uso.

Compreender os detalhes da versão do Kubernetes é crucial para solucionar problemas, garantir a compatibilidade e integrar o Kubernetes com outras ferramentas. Com esses comandos fundamentais, você está mais bem equipado para gerenciar ambientes Kubernetes e depurar problemas relacionados à versão. Continue praticando e explorando!