Merge pull request #48508 from yannkistenmacker/dev
[pt-br] Add docs/tasks/tools/install-kubectl-macospull/48759/head
Kubernetes Prow Robot
GitHub
commit
d1449bfa2e
|
|
@ -0,0 +1,109 @@
|
|||
---
|
||||
title: "Autocompletar no bash macOS"
|
||||
description: "Configurações opcionais do auto-completar do bash no macOS."
|
||||
headless: true
|
||||
_build:
|
||||
list: never
|
||||
render: never
|
||||
publishResources: false
|
||||
---
|
||||
|
||||
### Introdução
|
||||
|
||||
O script de autocompletar do kubectl para Bash pode ser gerado com o comando `kubectl completion bash`.
|
||||
O script permite habilitar o autocompletar do kubectl no seu shell.
|
||||
|
||||
No entanto, o script autocompletar depende do
|
||||
[**bash-completar**](https://github.com/scop/bash-completion), o que significa que você precisa instalar este software primeiro (executando `type _init_completion` você pode testar se tem o bash-completion instalado).
|
||||
|
||||
{{< warning>}}
|
||||
Existem duas versões de autocompletar do Bash, v1 e v2. V1 é para Bash 3.2
|
||||
(que é padrão no macOS), e v2 que é para Bash 4.1+. O script de autocompletar
|
||||
do kubectl **não funciona** corretamente com o autocompletar do bash v1 e o
|
||||
Bash 3.2. Ele requer **bash-completion v2** e **Bash 4.1+**. Por isso, para
|
||||
executarmos o autocompletar do kubectl no macOS de forma correta, você precisa
|
||||
instalar e usar o Bash 4.1+([*guia*](https://itnext.io/upgrading-bash-on-macos-7138bd1066ba)).
|
||||
As instruções a seguir, levam em conta que você utilize o Bash 4.1+.
|
||||
(Isso quer dizer, nenhuma versão do Bash 4.1 ou mais recente).
|
||||
{{< /warning >}}
|
||||
|
||||
### Atualizando Bash
|
||||
|
||||
As instruções abaixo sugerem que você esteja utilizando o Bash 4.1+. Você pode verificar a versão do seu Bash com o comando:
|
||||
|
||||
```bash
|
||||
echo $BASH_VERSION
|
||||
```
|
||||
|
||||
Se a versão do Bash for antiga, você pode instalar ou atualizar utilizando o Homebrew:
|
||||
|
||||
```bash
|
||||
brew install bash
|
||||
```
|
||||
|
||||
Recarregue seu shell e verifique se a versão desejada foi instalada ou se está em uso:
|
||||
|
||||
```bash
|
||||
echo $BASH_VERSION $SHELL
|
||||
```
|
||||
|
||||
O Homebrew normalmente instala os pacotes em `/usr/local/bin/bash`.
|
||||
|
||||
### Instalar bash-completar
|
||||
|
||||
{{< note >}}
|
||||
Como mencionado anteriormente, essas instruções levam em consideração que você esteja utilizando o Bash 4.1+, dessa forma você
|
||||
vai instalar o bash-completion v2 (diferentemente do Bash 3.2 e do bash-completion v1,
|
||||
nesses casos, o completar do kubectl não irá funcionar).
|
||||
{{< /note >}}
|
||||
|
||||
Você pode testar se você tiver o bash-completion v2 instalado, utilizando `type _init_completion`.
|
||||
Se não, você pode instalar utilizando o Homebrew:
|
||||
|
||||
```bash
|
||||
brew install bash-completion@2
|
||||
```
|
||||
|
||||
Como indicado na saída deste comando, adicione a seguinte linha em seu arquivo `~/.bash_profile`:
|
||||
|
||||
```bash
|
||||
brew_etc="$(brew --prefix)/etc" && [[ -r "${brew_etc}/profile.d/bash_completion.sh" ]] && . "${brew_etc}/profile.d/bash_completion.sh"
|
||||
```
|
||||
|
||||
Recarregue seu shell e verifique que o bash-completion v2 está instalado corretamente, utilizando `type _init_completion`.
|
||||
|
||||
### Habilitar autocompletar do kubectl
|
||||
|
||||
Agora você precisa garantir que o script de autocompletar do kubectl seja carregado em todas
|
||||
as suas sessões de shell. Existem várias maneiras de fazer isso:
|
||||
|
||||
- Carregue o script de autocompletar no seu arquivo `~/.bash_profile`:
|
||||
|
||||
```bash
|
||||
echo 'source <(kubectl completion bash)' >>~/.bash_profile
|
||||
```
|
||||
|
||||
- Adicione o script de autocompletar ao diretório `/usr/local/etc/bash_completion.d`:
|
||||
|
||||
```bash
|
||||
kubectl completion bash >/usr/local/etc/bash_completion.d/kubectl
|
||||
```
|
||||
|
||||
- Se você tiver um alias para o kubectl, pode estender o autocompletar do shell para funcionar com esse alias:
|
||||
|
||||
```bash
|
||||
echo 'alias k=kubectl' >>~/.bash_profile
|
||||
echo 'complete -o default -F __start_kubectl k' >>~/.bash_profile
|
||||
```
|
||||
|
||||
- Se você tiver instalado o kubectl com o Homebrew(conforme explicado
|
||||
[aqui](/docs/tasks/tools/install-kubectl-macos/#install-with-homebrew-on-macos)),
|
||||
então o script de autocompletar do kubectl deverá estar pronto em `/usr/local/etc/bash_completion.d/kubectl`.
|
||||
Neste caso, você não precisa fazer mais nada.
|
||||
|
||||
{{< note >}}
|
||||
A instalação do bash-completion v2 via Homebrew carrega todos os arquivos no diretório
|
||||
`BASH_COMPLETION_COMPAT_DIR`, é por isso que os dois últimos métodos funcionam..
|
||||
{{< /note >}}
|
||||
|
||||
De qualquer forma, após recarregar seu shell, o auto-completar do kubectl deve estar funcionando.
|
||||
|
|
@ -0,0 +1,301 @@
|
|||
---
|
||||
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 control planes nas versões 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 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)
|
||||
- [Plugins e ajustes opcionais do kubectl](#plugins-e-ajustes-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" >}}
|
||||
Loading…
Reference in New Issue