website/content/pt-br/docs/tasks/tools/install-kubectl-macos.md

title	content_type	weight
Instalar e configurar o kubectl no macOS	task	10

{{% heading "prerequisites" %}}

Você deve usar uma versão do kubectl que esteja próxima da versão do seu cluster. Por exemplo, um cliente v{{< skew currentVersion >}} pode se comunicar com as versões v{{< skew currentVersionAddMinor -1 >}}, v{{< skew currentVersionAddMinor 0 >}} e v{{< skew currentVersionAddMinor 1 >}} da camada de gerenciamento. Usar a versão compatível mais recente do kubectl ajuda a evitar problemas inesperados.

Instalando o kubectl no macOS

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

• Instalando o kubectl no macOS
  • Instalar o kubectl com curl no macOS
  • Instalar com Homebrew no macOS
  • Instalar com Macports no macOS
• Verificar a configuração do kubectl
• Configurações e plugins opcionais do kubectl
  • Habilitar o autocompletar no shell
  • Instalar o plugin kubectl convert

Instalar o kubectl com o curl no macOS

1. Baixe a última versão:

   {{< tabs name="download_binary_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl" {{< /tab >}} {{< tab name="Apple Silicon" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl" {{< /tab >}} {{< /tabs >}}

   {{< note >}} Para baixar uma versão específica, substitua a parte $(curl -L -s https://dl.k8s.io/release/stable.txt) do comando com a versão específica da versão.

   Por exemplo, para baixar a versão {{< skew currentPatchVersion >}} no Intel macOS, digite:

   curl -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/darwin/amd64/kubectl"
   

   E para macOS no Apple Silicon, digite:

   curl -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/darwin/arm64/kubectl"
   

   {{< /note >}}

2. Valide o binário (opcional).

   Baixe o arquivo de checksum do kubectl:

   {{< tabs name="download_checksum_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl.sha256" {{< /tab >}} {{< tab name="Apple Silicon" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl.sha256" {{< /tab >}} {{< /tabs >}}

   Valide o binário do kubectl com o arquivo de checksum:

   echo "$(cat kubectl.sha256)  kubectl" | shasum -a 256 --check
   

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

   kubectl: OK
   

   Se houver falha na validação, o shasum vai retornar uma saída diferente de zero semelhante a:

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

   {{< note >}} Baixe a mesma versão do binário e do checksum. {{< /note >}}

3. Torne o binário do kubectl executável.

   chmod +x ./kubectl
   

4. Mova o binário do kubectl para um diretório que esteja no PATH do seu sistema.

   sudo mv ./kubectl /usr/local/bin/kubectl
   sudo chown root: /usr/local/bin/kubectl
   

   {{< note >}} Confira que /usr/local/bin está configurado na sua variável de ambiente PATH. {{< /note >}}

5. Teste para validar que a versão instalada está atualizada:

   kubectl version --client
   

   Ou se preferir, use o seguinte comando para uma visão mais detalhada sobre a versão do Kubernetes:

   kubectl version --client --output=yaml
   

6. Depois de instalar e validar o kubectl, delete o arquivo de checksum:

   rm kubectl.sha256
   

Instalar com Homebrew no macOS

Se você está no macOS e usando o gerenciador de pacote Homebrew, você pode instalar o kubectl usando o Homebrew.

1. Execute o comando de instalação:

   brew install kubectl
   

   ou

   brew install kubernetes-cli
   

2. Teste para validar se a versão instalada está atualizada:

   kubectl version --client
   

Instalar com Macports no macOS

Se você está no macOS, usando o gerenciador de pacotes Macports, você pode instalar o kubectl utilizando o Macports.

1. Execute o comando de instalação:

   sudo port selfupdate
   sudo port install kubectl
   

2. Teste para validar se a versão instalada está atualizada:

   kubectl version --client
   

Verificar a configuração do kubectl

{{< include "included/verify-kubectl.md" >}}

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.

{{< tabs name="kubectl_autocompletion" >}} {{< tab name="Bash" include="included/optional-kubectl-configs-bash-mac.md" />}} {{< tab name="Fish" include="included/optional-kubectl-configs-fish.md" />}} {{< tab name="Zsh" include="included/optional-kubectl-configs-zsh.md" />}} {{< /tabs >}}

Instalar kubectl convert plugin

{{< include "included/kubectl-convert-overview.md" >}}

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

   {{< tabs name="download_convert_binary_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert" {{< /tab >}} {{< tab name="Apple Silicon" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert" {{< /tab >}} {{< /tabs >}}

2. Valide o binário (opcional).

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

   {{< tabs name="download_convert_checksum_macos" >}} {{< tab name="Intel" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/amd64/kubectl-convert.sha256" {{< /tab >}} {{< tab name="Apple Silicon" codelang="bash" >}} curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/darwin/arm64/kubectl-convert.sha256" {{< /tab >}} {{< /tabs >}}

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

   echo "$(cat kubectl-convert.sha256)  kubectl-convert" | shasum -a 256 --check
   

   Se for 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
   shasum: WARNING: 1 computed checksum did NOT match
   

   {{< note >}} Baixe a mesma versão do binário e do checksum. {{< /note >}}

3. Torne o binário do kubectl-convert um executável.

   chmod +x ./kubectl-convert
   

4. Mova o binário do kubectl-convert para o PATH do sistema.

   sudo mv ./kubectl-convert /usr/local/bin/kubectl-convert
   sudo chown root: /usr/local/bin/kubectl-convert
   

   {{< note >}} Tenha certeza de que /usr/local/bin está no PATH em suas configurações de variáveis ambiente. {{< /note >}}

5. Verifique se o plugin foi instalado com sucesso.

   kubectl convert --help
   

   Se você não encontrar nenhum erro, isso quer dizer que o plugin foi instalado com sucesso.

6. Após instalar o plugin, limpe os arquivos de instalação:

   rm kubectl-convert kubectl-convert.sha256
   

Desinstalar o kubectl no macOS

Dependendo da forma que você instalou o kubectl, use um dos métodos abaixo.

Desinstalar o kubectl usando a linha de comando

1. Localize o binário do kubectl no seu sistema:

   which kubectl
   

2. Remova o binário kubectl:

   sudo rm <path>
   

   Substitua <path> com o PATH do binário kubectl conforme os passos anteriores. Por exemplo, sudo rm /usr/local/bin/kubectl.

Desinstalar o kubectl usando o homebrew

Se você instalou o kubectl utilizando Homebrew, execute o comando a seguir:

brew remove kubectl

{{% heading "whatsnext" %}}

{{< include "included/kubectl-whats-next.md" >}}