Skip to content

Commit

Permalink
Merge pull request #39132 from MrErlison/pt-br/install-kubectl-linux
Browse files Browse the repository at this point in the history
[pt-br] Add pt-br/docs/tasks/tools/install-kubectl-linux
  • Loading branch information
k8s-ci-robot authored Feb 21, 2023
2 parents 74725dd + 0d2bb2c commit a5883ed
Show file tree
Hide file tree
Showing 7 changed files with 434 additions and 0 deletions.
Original file line number Diff line number Diff line change
@@ -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)
15 changes: 15 additions & 0 deletions content/pt-br/docs/tasks/tools/included/kubectl-whats-next.md
Original file line number Diff line number Diff line change
@@ -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/)
Original file line number Diff line number Diff line change
@@ -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
```
Original file line number Diff line number Diff line change
@@ -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.
Original file line number Diff line number Diff line change
@@ -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
```
33 changes: 33 additions & 0 deletions content/pt-br/docs/tasks/tools/included/verify-kubectl.md
Original file line number Diff line number Diff line change
@@ -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
```
Loading

0 comments on commit a5883ed

Please sign in to comment.