---
title: Instalar e configurar o kubectl no macOS
content_type: task
weight: 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](#instalando-o-kubectl-no-macos)
  - [Instalar o kubectl com curl no macOS](#instalar-o-kubectl-com-o-curl-no-macos)
  - [Instalar com Homebrew no macOS](#instalar-com-homebrew-no-macos)
  - [Instalar com Macports no macOS](#instalar-com-macports-no-macos)
- [Verificar a configuração do kubectl](#verificar-a-configuração-do-kubectl)
- [Configurações e plugins opcionais do kubectl](#configurações-e-plugins-opcionais-do-kubectl)
  - [Habilitar o autocompletar no shell](#ative-o-autocompletar-no-shell)
  - [Instalar o plugin `kubectl convert`](#instalar-kubectl-convert-plugin)

### 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:

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

   E para macOS no Apple Silicon, digite:

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

   {{< /note >}}

1. 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:

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

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

   ```console
   kubectl: OK
   ```

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

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

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

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

   ```bash
   chmod +x ./kubectl
   ```

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

   ```bash
   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 >}}

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

   ```bash
   kubectl version --client
   ```
   
   Ou se preferir, use o seguinte comando para uma visão mais detalhada sobre a versão do Kubernetes:

   ```cmd
   kubectl version --client --output=yaml
   ```

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

   ```bash
   rm kubectl.sha256
   ```

### Instalar com Homebrew no macOS

Se você está no macOS e usando o gerenciador de pacote [Homebrew](https://brew.sh/),
você pode instalar o kubectl usando o Homebrew.

1. Execute o comando de instalação:

   ```bash
   brew install kubectl
   ```

   ou

   ```bash
   brew install kubernetes-cli
   ```

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

   ```bash
   kubectl version --client
   ```

### Instalar com Macports no macOS

Se você está no macOS, usando o gerenciador de pacotes [Macports](https://macports.org/),
você pode instalar o kubectl utilizando o Macports.

1. Execute o comando de instalação:

   ```bash
   sudo port selfupdate
   sudo port install kubectl
   ```

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

   ```bash
   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 >}}

1. 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:

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

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

   ```console
   kubectl-convert: OK
   ```

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

   ```console
   kubectl-convert: FAILED
   shasum: WARNING: 1 computed checksum did NOT match
   ```

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

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

   ```bash
   chmod +x ./kubectl-convert
   ```

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

   ```bash
   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 >}}

1. Verifique se o plugin foi instalado com sucesso.

   ```shell
   kubectl convert --help
   ```

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

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

   ```bash
   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:

    ```bash
    which kubectl
    ```

1.  Remova o binário `kubectl`:

    ```bash
    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:

```bash
brew remove kubectl
```
  
## {{% heading "whatsnext" %}}

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