Merge pull request #39132 from MrErlison/pt-br/install-kubectl-linux
[pt-br] Add pt-br/docs/tasks/tools/install-kubectl-linuxpull/39613/head
Kubernetes Prow Robot
GitHub
commit
a5883ed882
|
|
@ -0,0 +1,14 @@
|
|||
---
|
||||
title: "Visão geral do kubectl-convert"
|
||||
description: >-
|
||||
Um plugin para o `kubectl` que permite converter manifestos entre diferentes versões da API.
|
||||
headless: true
|
||||
_build:
|
||||
list: never
|
||||
render: never
|
||||
publishResources: false
|
||||
---
|
||||
|
||||
Um plugin para a ferramenta Kubernetes de linha de comando `kubectl`, que permite converter manifestos entre diferentes versões da API.
|
||||
Isso pode ser particularmente útil para migrar manifestos para uma versão não obsoleta com a versão mais recente da API Kubernetes.
|
||||
Para mais informações, visite [Migrar para APIs não obsoletas](/docs/reference/using-api/deprecation-guide/#migrate-to-non-deprecated-apis)
|
||||
|
|
@ -0,0 +1,15 @@
|
|||
---
|
||||
title: "Próximos passos"
|
||||
description: "Próximos passos depois de instalar o kubectl."
|
||||
headless: true
|
||||
_build:
|
||||
list: never
|
||||
render: never
|
||||
publishResources: false
|
||||
---
|
||||
|
||||
* [Instale o Minikube](https://minikube.sigs.k8s.io/docs/start/)
|
||||
* Veja os [guias de introdução](/pt-br/docs/setup/) para saber mais sobre a criação de clusters.
|
||||
* [Saiba como iniciar e publicar sua aplicação.](/docs/tasks/access-application-cluster/service-access-application-cluster/)
|
||||
* Se você precisar de acesso a um cluster que não criou, consulte [Compartilhamento de Acesso ao Cluster](/docs/tasks/access-application-cluster/configure-access-multiple-clusters/)
|
||||
* Leia os [documentos de referência kubectl](/docs/reference/kubectl/kubectl/)
|
||||
|
|
@ -0,0 +1,61 @@
|
|||
---
|
||||
title: "autocompletar do bash no Linux"
|
||||
description: "Algumas configurações opcionais para o autocompletar do bash no Linux."
|
||||
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-completion**](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).
|
||||
|
||||
### Instale bash-completion
|
||||
|
||||
O bash-completion é fornecido por muitos gerenciadores de pacotes (veja [aqui](https://github.com/scop/bash-completion#installation)). Você pode instalar com `apt-get install bash-completion` ou `yum install bash-completion`, etc.
|
||||
|
||||
Os comandos acima criam `/usr/share/bash-completion/bash_completion`, que é o script principal de bash-completion. Dependendo do seu gerenciador de pacotes, você tem que adicionar manualmente ao seu arquivo `~/.bashrc`.
|
||||
|
||||
Para descobrir, recarregue seu shell e execute `type _init_completion`. Se o comando for bem-sucedido, já está definido, caso contrário, adicione o seguinte ao seu arquivo `~/.bashrc`:
|
||||
|
||||
```bash
|
||||
source /usr/share/bash-completion/bash_completion
|
||||
```
|
||||
|
||||
Recarregue o seu shell e verifique se o bash-completion está instalado corretamente digitando `type _init_completion`.
|
||||
|
||||
### Ative o autocompletar do kubectl
|
||||
|
||||
#### Bash
|
||||
|
||||
Agora você precisa garantir que o autocompletar do kubectl esteja ativo em todas as suas sessões shell. Existem duas maneiras pelas quais você pode fazer isso:
|
||||
|
||||
{{< tabs name="kubectl_bash_autocompletion" >}}
|
||||
{{< tab name="User" codelang="bash" >}}
|
||||
echo 'source <(kubectl completion bash)' >>~/.bashrc
|
||||
{{< /tab >}}
|
||||
{{< tab name="System" codelang="bash" >}}
|
||||
kubectl completion bash | sudo tee /etc/bash_completion.d/kubectl > /dev/null
|
||||
{{< /tab >}}
|
||||
{{< /tabs >}}
|
||||
|
||||
Se você tiver um alias para kubectl, você pode estender o autocompletar do shell para trabalhar com esse alias:
|
||||
|
||||
```bash
|
||||
echo 'alias k=kubectl' >>~/.bashrc
|
||||
echo 'complete -o default -F __start_kubectl k' >>~/.bashrc
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
bash-completion fornece todos os scripts de autocompletar em `/etc/bash_completion.d`.
|
||||
{{< /note >}}
|
||||
|
||||
Todas as abordagens são equivalentes. Depois de recarregar seu shell, o autocompletar do kubectl deve estar funcionando. Para ativar o autocompletar do bash na sessão atual do shell, execute `exec bash`:
|
||||
|
||||
```bash
|
||||
exec bash
|
||||
```
|
||||
|
|
@ -0,0 +1,23 @@
|
|||
---
|
||||
title: "Autocompletar do fish"
|
||||
description: "Configurações opcionais para ativar o autocompletar no shell fish."
|
||||
headless: true
|
||||
_build:
|
||||
list: never
|
||||
render: never
|
||||
publishResources: false
|
||||
---
|
||||
|
||||
{{< note >}}
|
||||
O autocompletar para Fish requer kubectl 1.23 ou posterior.
|
||||
{{< /note >}}
|
||||
|
||||
O script de autocompletar do kubectl para Fish pode ser gerado com o comando `kubectl completion fish`. O script permite habilitar o autocompletar do kubectl no seu shell.
|
||||
|
||||
Para fazer isso em todas as suas sessões do shell, adicione a seguinte linha ao seu arquivo `~/.config/fish/config.fish`:
|
||||
|
||||
```shell
|
||||
kubectl completion fish | source
|
||||
```
|
||||
|
||||
Depois de recarregar seu shell, o autocompletar do kubectl deve estar funcionando.
|
||||
|
|
@ -0,0 +1,28 @@
|
|||
---
|
||||
title: "Autocompletar zsh"
|
||||
description: "Configurações opcionais para ativar o autocompletar no shell zsh."
|
||||
headless: true
|
||||
_build:
|
||||
list: never
|
||||
render: never
|
||||
publishResources: false
|
||||
---
|
||||
|
||||
O script de autocompletar do kubectl para Zsh pode ser gerado com o comando `kubectl completion zsh`. Este script habilita o autocompletar do kubectl no seu shell.
|
||||
|
||||
Para fazer isso em todas as suas sessões de shell, adicione a seguinte linha no arquivo `~/.zshrc`:
|
||||
|
||||
```zsh
|
||||
source <(kubectl completion zsh)
|
||||
```
|
||||
|
||||
Se você tiver um alias para kubectl, o autocompletar funcionará automaticamente com ele.
|
||||
|
||||
Depois de recarregar seu shell, o autocompletar do kubectl deve estar funcionando.
|
||||
|
||||
Se você ver um erro similar a `2: command not found: compdef`, adicione o seguinte bloco ao início do seu arquivo `~/.zshrc`:
|
||||
|
||||
```zsh
|
||||
autoload -Uz compinit
|
||||
compinit
|
||||
```
|
||||
|
|
@ -0,0 +1,33 @@
|
|||
---
|
||||
title: "Verifique a instalação do kubectl"
|
||||
description: "Como verificar a instalação do kubectl."
|
||||
headless: true
|
||||
_build:
|
||||
list: never
|
||||
render: never
|
||||
publishResources: false
|
||||
---
|
||||
|
||||
Para que o kubectl encontre e acesse um cluster Kubernetes, ele precisa de um [arquivo kubeconfig](/pt-br//docs/concepts/configuration/organize-cluster-access-kubeconfig/), que é criado automaticamente quando você cria um cluster usando [kube-up.sh](https://github.com/kubernetes/kubernetes/blob/master/cluster/kube-up.sh) ou instala com sucesso um cluster Minikube. Por padrão, a configuração kubectl está localizada em `~/.kube/config`.
|
||||
|
||||
Verifique se o kubectl está configurado corretamente obtendo o estado do cluster:
|
||||
|
||||
```shell
|
||||
kubectl cluster-info
|
||||
```
|
||||
|
||||
Se você receber uma URL de resposta, o kubectl está configurado corretamente para acessar seu cluster.
|
||||
|
||||
Se você receber uma mensagem semelhante à seguinte, o kubectl não está configurado corretamente ou não consegue se conectar a um cluster Kubernetes.
|
||||
|
||||
```
|
||||
The connection to the server <server-name:port> was refused - did you specify the right host or port?
|
||||
```
|
||||
|
||||
Por exemplo, se você pretende executar um cluster Kubernetes no seu laptop (localmente), precisará que uma ferramenta como o Minikube seja instalada primeiro, para em seguida executar novamente os comandos indicados acima.
|
||||
|
||||
Se o kubectl cluster-info retornar a URL de resposta, mas você não conseguir acessar seu cluster, para verificar se ele está configurado corretamente, use:
|
||||
|
||||
```shell
|
||||
kubectl cluster-info dump
|
||||
```
|
||||
|
|
@ -0,0 +1,260 @@
|
|||
---
|
||||
title: Instale e configure o kubectl no Linux
|
||||
content_type: task
|
||||
weight: 10
|
||||
card:
|
||||
name: tasks
|
||||
weight: 20
|
||||
title: Install kubectl on Linux
|
||||
---
|
||||
|
||||
## {{% heading "prerequisites" %}}
|
||||
|
||||
Você deve usar uma versão do kubectl que esteja próxima da versão do seu cluster. Por exemplo, um cliente v1.26 pode se comunicar com as versões v1.25, v1.26 e v1.27 da camada de gerenciamento. Usar a versão compatível mais recente do kubectl ajuda a evitar problemas inesperados.
|
||||
|
||||
## Instale o kubectl no Linux
|
||||
|
||||
Existem os seguintes métodos para instalar o kubectl no Linux:
|
||||
|
||||
- [Instale o binário kubectl no Linux usando o curl](#instale-o-binário-kubectl-no-linux-usando-o-curl)
|
||||
- [Instale usando o gerenciador de pacotes nativo](#instale-usando-o-gerenciador-de-pacotes-nativo)
|
||||
- [Instale usando outro gerenciador de pacotes](#instale-usando-outro-gerenciador-de-pacotes)
|
||||
|
||||
|
||||
### Instale o binário kubectl no Linux usando o curl
|
||||
|
||||
1. Faça download da versão mais recente com o comando:
|
||||
|
||||
```bash
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Para fazer o download de uma versão específica, substitua a parte `$(curl -L -s https://dl.k8s.io/release/stable.txt)` do comando pela versão específica.
|
||||
|
||||
Por exemplo, para fazer download da versão {{< param "fullversion" >}} no Linux, digite:
|
||||
|
||||
```bash
|
||||
curl -LO https://dl.k8s.io/release/{{< param "fullversion" >}}/bin/linux/amd64/kubectl
|
||||
```
|
||||
{{< /note >}}
|
||||
|
||||
1. Valide o binário (opcional)
|
||||
|
||||
Faça download do arquivo checksum de verificação do kubectl:
|
||||
|
||||
```bash
|
||||
curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
|
||||
```
|
||||
|
||||
Valide o binário kubectl em relação ao arquivo de verificação:
|
||||
|
||||
```bash
|
||||
echo "$(cat kubectl.sha256) kubectl" | sha256sum --check
|
||||
```
|
||||
|
||||
Se válido, a saída será:
|
||||
|
||||
```console
|
||||
kubectl: OK
|
||||
```
|
||||
|
||||
Se a verificação falhar, o `sha256` exibirá o status diferente de zero e a saída será semelhante a:
|
||||
|
||||
```bash
|
||||
kubectl: FAILED
|
||||
sha256sum: WARNING: 1 computed checksum did NOT match
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Faça download da mesma versão do binário e do arquivo de verificação.
|
||||
{{< /note >}}
|
||||
|
||||
1. Instale o kubectl
|
||||
|
||||
```bash
|
||||
sudo install -o root -g root -m 0755 kubectl /usr/local/bin/kubectl
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Se você não tiver acesso root no sistema de destino, ainda poderá instalar o kubectl no diretório `~/.local/bin`:
|
||||
|
||||
```bash
|
||||
chmod +x kubectl
|
||||
mkdir -p ~/.local/bin
|
||||
mv ./kubectl ~/.local/bin/kubectl
|
||||
# e depois adicione ~/.local/bin na variável $PATH
|
||||
```
|
||||
|
||||
{{< /note >}}
|
||||
|
||||
1. Teste para garantir que a versão que você instalou esteja atualizada:
|
||||
|
||||
```bash
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
Ou use isso para visualizar mais detalhes da versão:
|
||||
|
||||
```cmd
|
||||
kubectl version --client --output=yaml
|
||||
```
|
||||
|
||||
### Instale usando o gerenciador de pacotes nativo
|
||||
|
||||
{{< tabs name="kubectl_install" >}}
|
||||
{{% tab name="Distribuições baseadas no Debian" %}}
|
||||
|
||||
1. Atualize o índice do `apt` e instale os pacotes necessários para utilizar o repositório `apt` do Kubernetes:
|
||||
|
||||
```shell
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y ca-certificates curl
|
||||
```
|
||||
|
||||
Se você usa o Debian 9 (stretch) ou anterior, também precisará instalar o `apt-transport-https`:
|
||||
```shell
|
||||
sudo apt-get install -y apt-transport-https
|
||||
```
|
||||
|
||||
2. Faça download da chave de assinatura pública do Google Cloud:
|
||||
|
||||
```shell
|
||||
sudo curl -fsSLo /etc/apt/keyrings/kubernetes-archive-keyring.gpg https://packages.cloud.google.com/apt/doc/apt-key.gpg
|
||||
```
|
||||
|
||||
3. Adicione o repositório `apt` do Kubernetes:
|
||||
|
||||
```shell
|
||||
echo "deb [signed-by=/etc/apt/keyrings/kubernetes-archive-keyring.gpg] https://apt.kubernetes.io/ kubernetes-xenial main" | sudo tee /etc/apt/sources.list.d/kubernetes.list
|
||||
```
|
||||
|
||||
4. Atualize o índice do `apt` com o novo repositório e instale o kubectl:
|
||||
|
||||
```shell
|
||||
sudo apt-get update
|
||||
sudo apt-get install -y kubectl
|
||||
```
|
||||
{{< note >}}
|
||||
Em versões anteriores ao Debian 12 e Ubuntu 22.04, o `/etc/apt/keyrings` não existe por padrão.
|
||||
Você pode criar este diretório se precisar, tornando-o visível para todos, mas com permissão de escrita apenas aos administradores.
|
||||
{{< /note >}}
|
||||
|
||||
{{% /tab %}}
|
||||
|
||||
{{% tab name="Distribuições baseadas no Red Hat" %}}
|
||||
```bash
|
||||
cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
|
||||
[kubernetes]
|
||||
name=Kubernetes
|
||||
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-\$basearch
|
||||
enabled=1
|
||||
gpgcheck=1
|
||||
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
|
||||
EOF
|
||||
sudo yum install -y kubectl
|
||||
```
|
||||
|
||||
{{% /tab %}}
|
||||
{{< /tabs >}}
|
||||
|
||||
### Instale usando outro gerenciador de pacotes
|
||||
|
||||
{{< tabs name="other_kubectl_install" >}}
|
||||
{{% tab name="Snap" %}}
|
||||
Se você estiver no Ubuntu ou em outra distribuição Linux que suporte o gerenciador de pacotes [snap](https://snapcraft.io/docs/core/install), o kubectl está disponível como um aplicativo [snap](https://snapcraft.io/).
|
||||
|
||||
```shell
|
||||
snap install kubectl --classic
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
{{% /tab %}}
|
||||
|
||||
{{% tab name="Homebrew" %}}
|
||||
Se você estiver no Linux e usando o gerenciador de pacotes [Homebrew](https://docs.brew.sh/Homebrew-on-Linux), o kubectl está disponível para [instalação](https://docs.brew.sh/Homebrew-on-Linux#install).
|
||||
|
||||
```shell
|
||||
brew install kubectl
|
||||
kubectl version --client
|
||||
```
|
||||
|
||||
{{% /tab %}}
|
||||
|
||||
{{< /tabs >}}
|
||||
|
||||
## Verifique a configuração 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-linux.md" />}}
|
||||
{{< tab name="Fish" include="included/optional-kubectl-configs-fish.md" />}}
|
||||
{{< tab name="Zsh" include="included/optional-kubectl-configs-zsh.md" />}}
|
||||
{{< /tabs >}}
|
||||
|
||||
### Instale o plugin `kubectl convert`
|
||||
|
||||
{{< include "included/kubectl-convert-overview.md" >}}
|
||||
|
||||
1. Faça download da versão mais recente com o comando:
|
||||
|
||||
```bash
|
||||
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert"
|
||||
```
|
||||
|
||||
1. Valide o binário (opcional)
|
||||
|
||||
Faça download do arquivo checksum de verificação do kubectl-convert:
|
||||
|
||||
```bash
|
||||
curl -LO "https://dl.k8s.io/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert.sha256"
|
||||
```
|
||||
|
||||
Valide o binário kubectl-convert com o arquivo de verificação:
|
||||
|
||||
```bash
|
||||
echo "$(cat kubectl-convert.sha256) kubectl-convert" | sha256sum --check
|
||||
```
|
||||
|
||||
Se 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:
|
||||
|
||||
```bash
|
||||
kubectl-convert: FAILED
|
||||
sha256sum: WARNING: 1 computed checksum did NOT match
|
||||
```
|
||||
|
||||
{{< note >}}
|
||||
Faça download da mesma versão do binário e do arquivo de verificação.
|
||||
{{< /note >}}
|
||||
|
||||
1. Instale o kubectl-convert
|
||||
|
||||
```bash
|
||||
sudo install -o root -g root -m 0755 kubectl-convert /usr/local/bin/kubectl-convert
|
||||
```
|
||||
|
||||
1. Verifique se o plugin foi instalado com sucesso
|
||||
|
||||
```shell
|
||||
kubectl convert --help
|
||||
```
|
||||
|
||||
Se não for exibido um erro, isso significa que o plugin foi instalado com sucesso.
|
||||
|
||||
## {{% heading "whatsnext" %}}
|
||||
|
||||
{{< include "included/kubectl-whats-next.md" >}}
|
||||
Loading…
Reference in New Issue