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 utilizar uma versão do kubectl que tenha pouca diferença da versão do seu cluster. Por exemplo, um cliente v{{< skew currentVersion >}} pode comunicar-se com control planes v{{< skew currentVersionAddMinor -1 >}}, v{{< skew currentVersionAddMinor 0 >}}, e v{{< skew currentVersionAddMinor 1 >}}. Usar a versão compatível e mais recente do kubectl pode evitar imprevistos ou problemas.

Instalando o kubectl no macOS

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

• Instalar kubectl no macOS
  • Instalar o binário do kubectl com curl no macOS
  • Instalar com Homebrew no macOS
  • Instalar com Macports no macOS
• Verificar ajustes do kubectl
• Plugins e ajustes opcionais do kubectl
  • Habilitar autocomplete no shell
  • Instalar o plugin kubectl convert

Instalar o binário do 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 $(curl -L -s https://dl.k8s.io/release/stable.txt) parte 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. Validando 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 >}}

   Validando 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. Tornando o binário do kubectl executável.

   chmod +x ./kubectl
   

4. Movendo 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 >}} Tenha certeza 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 ajustes do kubectl

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

Plugins e ajustes opcionais do kubectl

Habilitar autocomplete no shell

O kubectl fornece suporte para auto-complete para Bash, Zsh, Fish, e PowerShell o que pode fazer com que você digite menos.

Abaixo seguem os procedimentos para configurar o auto-complete para Bash, Fish, and 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. Baixe a última versão 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).

   Baixe o arquivo de checksum 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 do kubectl-convert com o checksum:

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

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

   kubectl-convert: OK
   

   Se o teste falhar, shasum irá retornar um status com número diferente de zero, e uma saída parecida como abaixo:

   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" >}}