removed from wrong path
yannkistenmacker
parent
36ef6fb755
commit
62fa17024b
|
|
@ -1,305 +0,0 @@
|
|||
---
|
||||
reviewers:
|
||||
- mikedanese
|
||||
title: Instalar e configurar o kubectl no macOS
|
||||
content_type: task
|
||||
weight: 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-kubectl-no-macos)
|
||||
- [Instalar o binário do kubectl com curl no macOS](#instalar-o-binario-do-kubectl-com-curl-no-macos)
|
||||
- [Instalar com Homebew no macOS](#instalar-com-homebrew-no-macos)
|
||||
- [Instalar com Macports no macOS](#instalar-com-macports-no-macos)
|
||||
- [Verificar ajustes do kubectl](#verificar-ajustes-do-kubectl)
|
||||
- [Plugins e ajustes opcionais do kubectl](#plugins-e-ajustes-opcionais-do-kubectl)
|
||||
- [Habilitar autocomplete no shell](#habilitar-autocomplete-no-shell)
|
||||
- [Instalar `kubectl convert` plugin](#instalar-kubectl-convert-plugin)
|
||||
|
||||
### 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:
|
||||
|
||||
```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. 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:
|
||||
|
||||
```bash
|
||||
echo "$(cat kubectl.sha256) kubectl" | shasum -a 256 --check
|
||||
```
|
||||
|
||||
Se for válido, a saída será:
|
||||
|
||||
```console
|
||||
kubectl: OK
|
||||
```
|
||||
|
||||
Se a houver falha na validação, `shasum` ele 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. Tornando o binário do kubectl executável.
|
||||
|
||||
```bash
|
||||
chmod +x ./kubectl
|
||||
```
|
||||
|
||||
1. Movendo o binário do kubectl para um diretório do seu sistema `PATH`.
|
||||
|
||||
```bash
|
||||
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 >}}
|
||||
|
||||
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 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 >}}
|
||||
|
||||
1. 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:
|
||||
|
||||
```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 o teste falhar, `shasum` irá retornar um status com número diferente de zero, e uma saída parecida como abaixo:
|
||||
|
||||
```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 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" >}}
|
||||
|
||||
|
||||
Loading…
Reference in New Issue