Skip to content

Commit 8a89acc

Browse files
moreirayokoyamastormqueen1990
moreirayokoyama
and
stormqueen1990
authored
[pt-br] Update docs/tasks/tools/install-kubectl-linux.md (#48000)
* Updating documentation to Install Kubectl on Linux * Replacing `falso` for `simbólico` as a more adequate translation for `dummy` Co-authored-by: Mauren <[email protected]> * Apply suggestions from code review (Typos and small adjustments) Co-authored-by: Mauren <[email protected]> * Fixing command for downloading public signing key for Kubernetes apt repository * Apply suggestions from code review (fixing indentation for better rendering) Co-authored-by: Mauren <[email protected]> --------- Co-authored-by: Mauren <[email protected]>
1 parent 7f43855 commit 8a89acc

File tree

1 file changed

+161
-41
lines changed

1 file changed

+161
-41
lines changed

‎content/pt-br/docs/tasks/tools/install-kubectl-linux.md

Lines changed: 161 additions & 41 deletions
Original file line numberDiff line numberDiff line change
@@ -10,7 +10,7 @@ card:
1010

1111
## {{% heading "prerequisites" %}}
1212

13-
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.
13+
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 as versões v{{< skew currentVersionAddMinor -1 >}}, v{{< skew currentVersionAddMinor 0 >}} e v{{< skew currentVersionAddMinor 1 >}} da camada de gerenciamento. Usar a versão compatível mais recente do kubectl ajuda a evitar problemas inesperados.
1414

1515
## Instale o kubectl no Linux
1616

@@ -25,27 +25,43 @@ Existem os seguintes métodos para instalar o kubectl no Linux:
2525

2626
1. Faça download da versão mais recente com o comando:
2727

28-
```bash
29-
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
30-
```
28+
{{< tabs name="download_binary_linux" >}}
29+
{{< tab name="x86-64" codelang="bash" >}}
30+
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl"
31+
{{< /tab >}}
32+
{{< tab name="ARM64" codelang="bash" >}}
33+
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl"
34+
{{< /tab >}}
35+
{{< /tabs >}}
3136

3237
{{< note >}}
3338
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.
3439

35-
Por exemplo, para fazer download da versão {{< skew currentPatchVersion >}} no Linux, digite:
40+
Por exemplo, para fazer download da versão {{< skew currentPatchVersion >}} no Linux x86-64, digite:
3641

3742
```bash
3843
curl -LO https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/linux/amd64/kubectl
3944
```
45+
46+
E para Linux ARM64, digite:
47+
48+
```bash
49+
curl -LO https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/linux/arm64/kubectl
50+
```
4051
{{< /note >}}
4152

4253
1. Valide o binário (opcional)
4354

4455
Faça download do arquivo checksum de verificação do kubectl:
45-
46-
```bash
56+
57+
{{< tabs name="download_checksum_linux" >}}
58+
{{< tab name="x86-64" codelang="bash" >}}
4759
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl.sha256"
48-
```
60+
{{< /tab >}}
61+
{{< tab name="ARM64" codelang="bash" >}}
62+
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl.sha256"
63+
{{< /tab >}}
64+
{{< /tabs >}}
4965

5066
Valide o binário kubectl em relação ao arquivo de verificação:
5167

@@ -109,60 +125,144 @@ Por exemplo, para fazer download da versão {{< skew currentPatchVersion >}} no
109125

110126
```shell
111127
sudo apt-get update
112-
sudo apt-get install -y ca-certificates curl
128+
# apt-transport-https pode ser um pacote simbólico; se for o caso, você pode ignorá-lo
129+
sudo apt-get install -y apt-transport-https ca-certificates curl gnupg
113130
```
114131

115-
Se você usa o Debian 9 (stretch) ou anterior, também precisará instalar o `apt-transport-https`:
116-
```shell
117-
sudo apt-get install -y apt-transport-https
118-
```
119-
120-
2. Faça download da chave de assinatura pública do Google Cloud:
132+
2. Faça download da chave de assinatura pública para os repositórios de pacote do Kubernetes. A mesma chave de assinatura é usada para todos os repositórios, então você pode desconsiderar a versão na URL:
121133

122134
```shell
123-
curl -fsSL https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-archive-keyring.gpg
135+
# Se a pasta `/etc/apt/keyrings` não existir, ela deve ser criada antes do comando curl, leia a nota abaixo.
136+
# sudo mkdir -p -m 755 /etc/apt/keyrings
137+
curl -fsSL https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/deb/Release.key | sudo gpg --dearmor -o /etc/apt/keyrings/kubernetes-apt-keyring.gpg
138+
sudo chmod 644 /etc/apt/keyrings/kubernetes-apt-keyring.gpg # permitir que programas APT sem acesso privilegiado leiam este keyring
124139
```
125140

126-
3. Adicione o repositório `apt` do Kubernetes:
141+
{{< note >}}
142+
Em releases mais antigos que o Debian 12 e Ubuntu 22.04, a pasta `/etc/apt/keyrings` não existe por padrão, e ela deve ser criada antes do comando curl.
143+
{{< /note >}}
144+
145+
3. Adicione o repositório `apt` do Kubernetes. Se você quiser usar uma versão do Kubernetes diferente de {{< param "version" >}},
146+
substitua {{< param "version" >}} com a versão menor desejada no comando a seguir:
127147

128148
```shell
129-
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
149+
# Isto substitui qualquer configuração existente na pasta /etc/apt/sources.list.d/kubernetes.list
150+
echo 'deb [signed-by=/etc/apt/keyrings/kubernetes-apt-keyring.gpg] https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/deb/ /' | sudo tee /etc/apt/sources.list.d/kubernetes.list
151+
sudo chmod 644 /etc/apt/sources.list.d/kubernetes.list # ajuda ferramentas tais como command-not-found a funcionar corretamente
130152
```
153+
154+
{{< note >}}
155+
Para atualizar o kubectl para outra versão menor, você vai precisar atualizar a versão no arquivo `/etc/apt/sources.list.d/kubernetes.list` antes de rodar `apt-get update` e `apt-get upgrade`. Este procedimento está descrito com mais detalhes em [Mudando o Repositório de Pacotes do Kubernetes](/docs/tasks/administer-cluster/kubeadm/change-package-repository/) (em inglês).
156+
{{< /note >}}
131157

132158
4. Atualize o índice do `apt` com o novo repositório e instale o kubectl:
133159

134160
```shell
135161
sudo apt-get update
136162
sudo apt-get install -y kubectl
137163
```
164+
165+
{{% /tab %}}
166+
167+
{{% tab name="Distribuições baseadas no Red Hat" %}}
168+
169+
1. Adicione o repositório `yum` do Kubernetes. Se você quiser usar uma versão do
170+
Kubernetes diferente de {{< param "version" >}}, substitua {{< param "version" >}}
171+
pela versão menor desejada no comando a seguir.
172+
173+
```bash
174+
# Isto substitui qualquer configuração existente na pasta /etc/yum.repos.d/kubernetes.repo
175+
cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
176+
[kubernetes]
177+
name=Kubernetes
178+
baseurl=https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/rpm/
179+
enabled=1
180+
gpgcheck=1
181+
gpgkey=https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/rpm/repodata/repomd.xml.key
182+
EOF
183+
```
184+
138185
{{< note >}}
139-
Em versões anteriores ao Debian 12 e Ubuntu 22.04, o `/etc/apt/keyrings` não existe por padrão.
140-
Você pode criar este diretório se precisar, tornando-o visível para todos, mas com permissão de escrita apenas aos administradores.
186+
Para atualizar o kubectl para outra versão menor, você vai precisar atualizar a versão no arquivo `/etc/yum.repos.d/kubernetes.repo` antes de rodar `yum update`. Este procedimento está descrito com mais detalhes em [Mudando o Repositório de Pacotes do Kubernetes](/docs/tasks/administer-cluster/kubeadm/change-package-repository/) (em inglês).
141187
{{< /note >}}
142188

189+
2. Instale o kubectl usando `yum`:
190+
191+
```bash
192+
sudo yum install -y kubectl
193+
```
194+
143195
{{% /tab %}}
144196

145-
{{% tab name="Distribuições baseadas no Red Hat" %}}
146-
```bash
147-
cat <<EOF | sudo tee /etc/yum.repos.d/kubernetes.repo
148-
[kubernetes]
149-
name=Kubernetes
150-
baseurl=https://packages.cloud.google.com/yum/repos/kubernetes-el7-\$basearch
151-
enabled=1
152-
gpgcheck=1
153-
gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
154-
EOF
155-
sudo yum install -y kubectl
156-
```
197+
{{% tab name="Distribuições baseadas em SUSE" %}}
198+
199+
1. Adicione o repositório `zypper` do Kubernetes. Se você quiser instalar uma versão
200+
diferente de {{< param "version" >}}, substitua {{< param "version" >}} pela versão
201+
menor desejada no comando a seguir.
202+
203+
```bash
204+
# Isto substitui qualquer configuração existente no arquivo /etc/zypp/repos.d/kubernetes.repo
205+
cat <<EOF | sudo tee /etc/zypp/repos.d/kubernetes.repo
206+
[kubernetes]
207+
name=Kubernetes
208+
baseurl=https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/rpm/
209+
enabled=1
210+
gpgcheck=1
211+
gpgkey=https://pkgs.k8s.io/core:/stable:/{{< param "version" >}}/rpm/repodata/repomd.xml.key
212+
EOF
213+
```
214+
{{< note >}}
215+
Para atualizar o kubectl para outra versão menor, você vai precisar atualizar a versão no arquivo `/etc/zypp/repos.d/kubernetes.repo`
216+
antes de rodar `zypper update`. Este procedimento está descrito com mais detalhes em [Mudando o Repositório de Pacotes do Kubernetes](/docs/tasks/administer-cluster/kubeadm/change-package-repository/) (em inglês).
217+
{{< /note >}}
218+
219+
2. Atualize o `zypper` e confirme a adição do novo repositório:
157220
221+
```bash
222+
sudo zypper update
223+
```
224+
225+
Quando esta mensagem aparecer, pressione 't' ou 'a':
226+
227+
```
228+
New repository or package signing key received:
229+
230+
Repository: Kubernetes
231+
Key Fingerprint: 1111 2222 3333 4444 5555 6666 7777 8888 9999 AAAA
232+
Key Name: isv:kubernetes OBS Project <isv:[email protected]>
233+
Key Algorithm: RSA 2048
234+
Key Created: Thu 25 Aug 2022 01:21:11 PM -03
235+
Key Expires: Sat 02 Nov 2024 01:21:11 PM -03 (expires in 85 days)
236+
Rpm Name: gpg-pubkey-9a296436-6307a177
237+
238+
Note: Signing data enables the recipient to verify that no modifications occurred after the data
239+
were signed. Accepting data with no, wrong or unknown signature can lead to a corrupted system
240+
and in extreme cases even to a system compromise.
241+
242+
Note: A GPG pubkey is clearly identified by its fingerprint. Do not rely on the key's name. If
243+
you are not sure whether the presented key is authentic, ask the repository provider or check
244+
their web site. Many providers maintain a web page showing the fingerprints of the GPG keys they
245+
are using.
246+
247+
Do you want to reject the key, trust temporarily, or trust always? [r/t/a/?] (r): a
248+
```
249+
250+
3. Instale o kubectl usando `zypper`:
251+
252+
```bash
253+
sudo zypper install -y kubectl
254+
```
255+
158256
{{% /tab %}}
159257
{{< /tabs >}}
160258
161259
### Instale usando outro gerenciador de pacotes
162260
163261
{{< tabs name="other_kubectl_install" >}}
164262
{{% tab name="Snap" %}}
165-
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/).
263+
Se você estiver no Ubuntu ou em outra distribuição Linux que suporte o gerenciador de
264+
pacotes [snap](https://snapcraft.io/docs/core/install), o kubectl está disponível como
265+
um aplicativo [snap](https://snapcraft.io/).
166266
167267
```shell
168268
snap install kubectl --classic
@@ -172,7 +272,9 @@ kubectl version --client
172272
{{% /tab %}}
173273
174274
{{% tab name="Homebrew" %}}
175-
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).
275+
Se você estiver no Linux e usando o gerenciador de pacotes
276+
[Homebrew](https://docs.brew.sh/Homebrew-on-Linux), o kubectl está disponível para
277+
[instalação](https://docs.brew.sh/Homebrew-on-Linux#install).
176278
177279
```shell
178280
brew install kubectl
@@ -188,9 +290,11 @@ kubectl version --client
188290
{{< include "included/verify-kubectl.md" >}}
189291
190292
## Configurações e plugins opcionais do kubectl
293+
191294
### Ative o autocompletar no shell
192295
193-
O kubectl oferece recursos de autocompletar para Bash, Zsh, Fish e PowerShell, o que pode economizar muita digitação.
296+
O kubectl oferece recursos de autocompletar para Bash, Zsh, Fish e PowerShell,
297+
o que pode economizar muita digitação.
194298
195299
Abaixo estão os procedimentos para configurar o autocompletar para Bash, Fish e Zsh.
196300
@@ -206,17 +310,27 @@ Abaixo estão os procedimentos para configurar o autocompletar para Bash, Fish e
206310
207311
1. Faça download da versão mais recente com o comando:
208312
209-
```bash
210-
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert"
211-
```
212-
313+
{{< tabs name="download_convert_binary_linux" >}}
314+
{{< tab name="x86-64" codelang="bash" >}}
315+
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert"
316+
{{< /tab >}}
317+
{{< tab name="ARM64" codelang="bash" >}}
318+
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl-convert"
319+
{{< /tab >}}
320+
{{< /tabs >}}
321+
213322
1. Valide o binário (opcional)
214323
215324
Faça download do arquivo checksum de verificação do kubectl-convert:
216325
217-
```bash
326+
{{< tabs name="download_convert_checksum_linux" >}}
327+
{{< tab name="x86-64" codelang="bash" >}}
218328
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/amd64/kubectl-convert.sha256"
219-
```
329+
{{< /tab >}}
330+
{{< tab name="ARM64" codelang="bash" >}}
331+
curl -LO "https://dl.k8s.io/release/$(curl -L -s https://dl.k8s.io/release/stable.txt)/bin/linux/arm64/kubectl-convert.sha256"
332+
{{< /tab >}}
333+
{{< /tabs >}}
220334
221335
Valide o binário kubectl-convert com o arquivo de verificação:
222336
@@ -255,6 +369,12 @@ Abaixo estão os procedimentos para configurar o autocompletar para Bash, Fish e
255369
256370
Se não for exibido um erro, isso significa que o plugin foi instalado com sucesso.
257371
372+
1. Depois de instalar o plugin, remova os arquivos de instalação:
373+
374+
```bash
375+
rm kubectl-convert kubectl-convert.sha256
376+
```
377+
258378
## {{% heading "whatsnext" %}}
259379
260380
{{< include "included/kubectl-whats-next.md" >}}

0 commit comments

Comments
 (0)