Instale e configure o kubectl no Linux

Antes de você começar

Você deve usar uma versão do kubectl que esteja próxima da versão do seu cluster. Por exemplo, um cliente v1.26 pode se comunicar com as versões v1.25, v1.26 e v1.27 da camada de gerenciamento. Usar a versão compatível mais recente do kubectl ajuda a evitar problemas inesperados.

Instale o kubectl no Linux

Existem os seguintes métodos para instalar o kubectl no Linux:

• Instale o binário kubectl no Linux usando o curl
• Instale usando o gerenciador de pacotes nativo
• Instale usando outro gerenciador de pacotes

Instale o binário kubectl no Linux usando o curl

1. Faça download da versão mais recente com o comando:

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
   

   Nota:

   Para fazer o download de uma versão específica, substitua a parte $(curl -L -s https://dl.k8s.io/release/stable.txt) do comando pela versão específica.

   Por exemplo, para fazer download da versão 1.28.1 no Linux, digite:

   curl -LO https://dl.k8s.io/release/v1.28.1/bin/linux/amd64/kubectl
   

2. Valide o binário (opcional)

   Faça download do arquivo checksum de verificação do kubectl:

   curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
   

   Valide o binário kubectl em relação ao arquivo de verificação:

   echo "$(cat kubectl.sha256)  kubectl" | sha256sum --check
   

   Se válido, a saída será:

   kubectl: OK
   

   Se a verificação falhar, o sha256 exibirá o status diferente de zero e a saída será semelhante a:

   kubectl: FAILED
   sha256sum: WARNING: 1 computed checksum did NOT match
   

   Nota: Faça download da mesma versão do binário e do arquivo de verificação.

3. Instale o kubectl

   sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
   

   Nota:

   Se você não tiver acesso root no sistema de destino, ainda poderá instalar o kubectl no diretório ~/.local/bin:

   chmod +x kubectl
   mkdir -p ~/.local/bin
   mv ./kubectl ~/.local/bin/kubectl
   # e depois adicione ~/.local/bin na variável $PATH
   

4. Teste para garantir que a versão que você instalou esteja atualizada:

   kubectl version --client
   

   Ou use isso para visualizar mais detalhes da versão:

   kubectl version --client --output=yaml    
   

Instale usando o gerenciador de pacotes nativo

• Distribuições baseadas no Debian
• Distribuições baseadas no Red Hat

cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
[kubernetes]
name=Kubernetes
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-\$basearch
enabled=1
gpgcheck=1
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOF
sudo yum install -y kubectl

Instale usando outro gerenciador de pacotes

• Snap
• Homebrew

snap install kubectl --classic
kubectl version --client

brew install kubectl
kubectl version --client

Verifique a configuração kubectl

Para que o kubectl encontre e acesse um cluster Kubernetes, ele precisa de um arquivo kubeconfig, que é criado automaticamente quando você cria um cluster usando kube-up.sh ou instala com sucesso um cluster Minikube. Por padrão, a configuração kubectl está localizada em ~/.kube/config.

Verifique se o kubectl está configurado corretamente obtendo o estado do cluster:

kubectl cluster-info

Se você receber uma URL de resposta, o kubectl está configurado corretamente para acessar seu cluster.

Se você receber uma mensagem semelhante à seguinte, o kubectl não está configurado corretamente ou não consegue se conectar a um cluster Kubernetes.

The connection to the server <server-name:port> was refused - did you specify the right host or port?

Por exemplo, se você pretende executar um cluster Kubernetes no seu laptop (localmente), precisará que uma ferramenta como o Minikube seja instalada primeiro, para em seguida executar novamente os comandos indicados acima.

Se o kubectl cluster-info retornar a URL de resposta, mas você não conseguir acessar seu cluster, para verificar se ele está configurado corretamente, use:

kubectl cluster-info dump

Configurações e plugins opcionais do kubectl

Ative o autocompletar no shell

O kubectl oferece recursos de autocompletar para Bash, Zsh, Fish e PowerShell, o que pode economizar muita digitação.

Abaixo estão os procedimentos para configurar o autocompletar para Bash, Fish e Zsh.

• Bash
• Fish
• Zsh

source /usr/share/bash-completion/bash_completion

echo 'source <(kubectl completion bash)' >>~/.bashrc

kubectl completion bash | sudo tee /etc/bash_completion.d/kubectl > /dev/null
sudo chmod a+r /etc/bash_completion.d/kubectl

echo 'alias k=kubectl' >>~/.bashrc
echo 'complete -o default -F __start_kubectl k' >>~/.bashrc

exec bash

kubectl completion fish | source

source <(kubectl completion zsh)

autoload -Uz compinit
compinit

Instale o plugin kubectl convert

Um plugin para a ferramenta Kubernetes de linha de comando kubectl, que permite converter manifestos entre diferentes versões da API. Isso pode ser particularmente útil para migrar manifestos para uma versão não obsoleta com a versão mais recente da API Kubernetes. Para mais informações, visite Migrar para APIs não obsoletas

1. Faça download da versão mais recente com o comando:

   curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert"
   

2. Valide o binário (opcional)

   Faça download do arquivo checksum de verificação do kubectl-convert:

   curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert.sha256"
   

   Valide o binário kubectl-convert com o arquivo de verificação:

   echo "$(cat kubectl-convert.sha256) kubectl-convert" | sha256sum --check
   

   Se válido, a saída será:

   kubectl-convert: OK
   

   Se a verificação falhar, o sha256 exibirá o status diferente de zero e a saída será semelhante a:

   kubectl-convert: FAILED
   sha256sum: WARNING: 1 computed checksum did NOT match
   

   Nota: Faça download da mesma versão do binário e do arquivo de verificação.

3. Instale o kubectl-convert

   sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert
   

4. Verifique se o plugin foi instalado com sucesso

   kubectl convert --help
   

   Se não for exibido um erro, isso significa que o plugin foi instalado com sucesso.

Próximos passos

• Instale o Minikube
• Veja os guias de introdução para saber mais sobre a criação de clusters.
• Saiba como iniciar e publicar sua aplicação.
• Se você precisar de acesso a um cluster que não criou, consulte Compartilhamento de Acesso ao Cluster
• Leia os documentos de referência kubectl