removed from wrong path
This commit is contained in:
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