From e0e658d7e2ddeca5c14f8a4c65caab7c8df9ca93 Mon Sep 17 00:00:00 2001 From: Luis Felipe Rosa de Oliveira Date: Wed, 20 Nov 2024 15:13:32 -0300 Subject: [PATCH 1/7] add install-kubectl-windows.md --- .../included/optional-kubectl-configs-pwsh.md | 27 +++ .../tasks/tools/install-kubectl-windows.md | 213 ++++++++++++++++++ 2 files changed, 240 insertions(+) create mode 100644 content/pt-br/docs/tasks/tools/included/optional-kubectl-configs-pwsh.md create mode 100644 content/pt-br/docs/tasks/tools/install-kubectl-windows.md diff --git a/content/pt-br/docs/tasks/tools/included/optional-kubectl-configs-pwsh.md b/content/pt-br/docs/tasks/tools/included/optional-kubectl-configs-pwsh.md new file mode 100644 index 0000000000000..ade590c0534a2 --- /dev/null +++ b/content/pt-br/docs/tasks/tools/included/optional-kubectl-configs-pwsh.md @@ -0,0 +1,27 @@ +--- +title: "Ative o autocompletar no PowerShell" +description: "Algumas configurações opcionais para ativar o autocompletar no PowerShell." +headless: true +_build: + list: never + render: never + publishResources: false +--- + +O script de autocompletar do kubectl para PowerShell, pode ser gerado com o comando `kubectl completion powershell`. + +Para fazer isso em todas as suas sessões de shell, adicione a seguinte linha ao seu arquivo `$PROFILE`: + +```powershell +kubectl completion powershell | Out-String | Invoke-Expression +``` + +Este comando irá regenerar o script de autocompletar toda vez que o PowerShell for iniciado. Você também pode adicionar o script gerado diretamente ao seu arquivo `$PROFILE`. + +Para adicionar o script gerado ao seu arquivo `$PROFILE`, execute a seguinte linha no prompt do PowerShell: + +```powershell +kubectl completion powershell >> $PROFILE +``` + +Após recarregar seu shell, o autocompletar do kubectl deve estar funcionando. diff --git a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md new file mode 100644 index 0000000000000..767e04715dcfc --- /dev/null +++ b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md @@ -0,0 +1,213 @@ +--- +title: Instale e configure o kubectl no Windows +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 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. + +## Instale o kubectl no Windows + +Existem os seguintes métodos para instalar o kubectl no Windows: + +- [Instale o binário kubectl no Windows (via download direto ou curl)](#install-kubectl-binary-on-windows-via-direct-download-or-curl) +- [Instale no Windows usando Chocolatey, Scoop ou winget](#install-nonstandard-package-tools) + +### Instale o binário kubectl no Windows (via download direto ou curl) + +1. Você tem duas opções para instalar o kubectl em seu dispositivo Windows + + - Download direto: + + Baixe a última versão do patch {{< skew currentVersion >}} diretamente para sua arquitetura específica visitando a [pagina de lançamentos do Kubernetes](https://kubernetes.io/releases/download/#binaries). Certifique-se de selecionar o binário correto para a sua arquitetura. (e.g., amd64, arm64, etc.). + + - Usando curl: + + Se você tiver o `curl` instalado, use este comando: + + ```powershell + curl.exe -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl.exe" + ``` + + {{< note >}} + Para descobrir a versão estável mais recente (por exemplo, para scripts), veja + [https://dl.k8s.io/release/stable.txt](https://dl.k8s.io/release/stable.txt). + {{< /note >}} + +2. Validar o binario (opcional) + + Baixe o arquivo de checksum do `kubectl`: + + ```powershell + curl.exe -LO "https://dl.k8s.io/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl.exe.sha256" + ``` + + Valide o binário do `kubectl` com o arquivo de checksum: + + - Usando o Prompt de Comando para comparar manualmente a saída do `CertUtil` ao arquivo de checksum baixado: + + ```cmd + CertUtil -hashfile kubectl.exe SHA256 + type kubectl.exe.sha256 + ``` + + - Usando PowerShell para automatizar a verificação com o operador `-eq` para obter + um resultado `True` ou `False`: + + ```powershell + $(Get-FileHash -Algorithm SHA256 .\kubectl.exe).Hash -eq $(Get-Content .\kubectl.exe.sha256) + ``` + +3. Adicione (no início ou no final) o diretório do binário `kubectl` na variável de ambiente `PATH`. + +4. Teste para garantir que a versão do `kubectl` seja a mesma que foi baixada: + + ```cmd + kubectl version --client + ``` + + Ou use este comando para uma visão detalhada da versão: + + ```cmd + kubectl version --client --output=yaml + ``` + + + +{{< note >}} +[Docker Desktop para Windows](https://docs.docker.com/docker-for-windows/#kubernetes) +adiciona sua própria versão do `kubectl` ao `PATH`. Se você instalou o Docker Desktop anteriormente, +pode ser necessário colocar sua entrada no `PATH` antes da adicionada pelo instalador do Docker Desktop +ou remover o `kubectl`do Docker Desktop. +{{< /note >}} + +### Instalar no Windows usando Chocolatey, Scoop, ou winget {#install-nonstandard-package-tools} + +1. Para instalar o kubectl no Windows, você pode usar o gerenciador de pacotes [Chocolatey](https://chocolatey.org), + o instalador de linha de comando [Scoop](https://scoop.sh) ou o gerenciador de pacotes + [winget](https://learn.microsoft.com/en-us/windows/package-manager/winget/). + + {{< tabs name="kubectl_win_install" >}} + {{% tab name="choco" %}} + ```powershell + choco install kubernetes-cli + ``` + {{% /tab %}} + {{% tab name="scoop" %}} + ```powershell + scoop install kubectl + ``` + {{% /tab %}} + {{% tab name="winget" %}} + ```powershell + winget install -e --id Kubernetes.kubectl + ``` + {{% /tab %}} + {{< /tabs >}} + +2. Teste para garantir que a versão que você instalou está atualizada: + + ```powershell + kubectl version --client + ``` + +3. Navegue até seu diretório pessoal: + + ```powershell + # Se você estiver usando o cmd.exe, execute: cd %USERPROFILE% + cd ~ + ``` + +4. Crie o diretório `.kube`: + + ```powershell + mkdir .kube + ``` + +5. Mude para o diretório `.kube` que você acabou de criar: + + ```powershell + cd .kube + ``` + +6. Configure o kubectl para usar um cluster Kubernetes remoto: + + ```powershell + New-Item config -type file + ``` + +{{< note >}} +Edite o arquivo de configuração com um editor de texto de sua escolha, como o Notepad. +{{< /note >}} + +## Verificar a configuração do kubectl + +{{< include "included/verify-kubectl.md" >}} + +## Configurações e plugins opcionais do kubectl + +### Ativar autocompletar no shell + +O kubectl oferece suporte ao autocompletar para Bash, Zsh, Fish e PowerShell, +o que pode economizar tempo de digitação. + +Abaixo estão os procedimentos para configurar o autocompletar no PowerShell. + +{{< include "included/optional-kubectl-configs-pwsh.md" >}} + +### Instalar o plugin `kubectl convert` + +{{< include "included/kubectl-convert-overview.md" >}} + +1. Baixe a última versão com este comando: + + ```powershell + curl.exe -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl-convert.exe" + ``` + +2. Validar o binario (opcional). + + Baixe o arquivo de checksum do `kubectl-convert`: + + ```powershell + curl.exe -LO "https://dl.k8s.io/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl-convert.exe.sha256" + ``` + + Valide o binário do `kubectl-convert` com o arquivo de checksum: + + - Usando o Prompt de Comando para comparar manualmente a saída do `CertUtil` ao arquivo de checksum baixado: + + ```cmd + CertUtil -hashfile kubectl-convert.exe SHA256 + type kubectl-convert.exe.sha256 + ``` + + - Usando PowerShell para automatizar a verificação com o operador `-eq` para obter + um resultado `True` ou `False`: + + ```powershell + $($(CertUtil -hashfile .\kubectl-convert.exe SHA256)[1] -replace " ", "") -eq $(type .\kubectl-convert.exe.sha256) + ``` + +3. Adicione (no início ou no final) o diretório do binário `kubectl-convert` na variável de ambiente `PATH`. + +4. Verifique se o plugin foi instalado com sucesso. + + ```shell + kubectl convert --help + ``` + + Se você não ver um erro, isso significa que o plugin foi instalado com sucesso. + +5. Após instalar o plugin, limpe os arquivos de instalação: + + ```powershell + del kubectl-convert.exe + del kubectl-convert.exe.sha256 + ``` + +## {{% heading "whatsnext" %}} + +{{< include "included/kubectl-whats-next.md" >}} From 2843342fee370de6834473f37a80f1f28dedf934 Mon Sep 17 00:00:00 2001 From: Luis Oliveira Date: Thu, 28 Nov 2024 11:21:25 -0300 Subject: [PATCH 2/7] Update content/pt-br/docs/tasks/tools/install-kubectl-windows.md ajuste conforme recomendado Co-authored-by: Edson Ferreira --- content/pt-br/docs/tasks/tools/install-kubectl-windows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md index 767e04715dcfc..6dfb12973ed74 100644 --- a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md +++ b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md @@ -36,7 +36,7 @@ Existem os seguintes métodos para instalar o kubectl no Windows: [https://dl.k8s.io/release/stable.txt](https://dl.k8s.io/release/stable.txt). {{< /note >}} -2. Validar o binario (opcional) +2. Validar o binário (opcional) Baixe o arquivo de checksum do `kubectl`: From 6cf8f59c2f45c649a5f60db8e995bf4b79362aaf Mon Sep 17 00:00:00 2001 From: Luis Felipe Rosa de Oliveira Date: Thu, 28 Nov 2024 11:24:21 -0300 Subject: [PATCH 3/7] ajustes acentuacao --- content/pt-br/docs/tasks/tools/install-kubectl-windows.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md index 6dfb12973ed74..26aa894b7bf86 100644 --- a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md +++ b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md @@ -36,7 +36,7 @@ Existem os seguintes métodos para instalar o kubectl no Windows: [https://dl.k8s.io/release/stable.txt](https://dl.k8s.io/release/stable.txt). {{< /note >}} -2. Validar o binário (opcional) +2. Validar o binário (opcional) Baixe o arquivo de checksum do `kubectl`: @@ -167,7 +167,7 @@ Abaixo estão os procedimentos para configurar o autocompletar no PowerShell. curl.exe -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl-convert.exe" ``` -2. Validar o binario (opcional). +2. Validar o binário (opcional). Baixe o arquivo de checksum do `kubectl-convert`: From e1224a175da70ccc77adf2cfc003b690a6b0f5be Mon Sep 17 00:00:00 2001 From: Luis Felipe Rosa de Oliveira Date: Thu, 28 Nov 2024 11:28:46 -0300 Subject: [PATCH 4/7] ajustes acentuacao --- content/pt-br/docs/tasks/tools/install-kubectl-windows.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md index 26aa894b7bf86..12908e7742b19 100644 --- a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md +++ b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md @@ -36,7 +36,7 @@ Existem os seguintes métodos para instalar o kubectl no Windows: [https://dl.k8s.io/release/stable.txt](https://dl.k8s.io/release/stable.txt). {{< /note >}} -2. Validar o binário (opcional) +2. Validar o binário (opcional) Baixe o arquivo de checksum do `kubectl`: @@ -167,7 +167,7 @@ Abaixo estão os procedimentos para configurar o autocompletar no PowerShell. curl.exe -LO "https://dl.k8s.io/release/v{{< skew currentPatchVersion >}}/bin/windows/amd64/kubectl-convert.exe" ``` -2. Validar o binário (opcional). +2. Validar o binário (opcional). Baixe o arquivo de checksum do `kubectl-convert`: From 37b6148bfb4c54d629cbbd8dcee6c0d46e4cc6a6 Mon Sep 17 00:00:00 2001 From: Luis Oliveira Date: Fri, 29 Nov 2024 10:08:24 -0300 Subject: [PATCH 5/7] adicionado ancora do titulo adicionado ancora do titulo Co-authored-by: Mauren <698465+stormqueen1990@users.noreply.github.com> --- content/pt-br/docs/tasks/tools/install-kubectl-windows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md index 12908e7742b19..93ce707504471 100644 --- a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md +++ b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md @@ -15,7 +15,7 @@ Existem os seguintes métodos para instalar o kubectl no Windows: - [Instale o binário kubectl no Windows (via download direto ou curl)](#install-kubectl-binary-on-windows-via-direct-download-or-curl) - [Instale no Windows usando Chocolatey, Scoop ou winget](#install-nonstandard-package-tools) -### Instale o binário kubectl no Windows (via download direto ou curl) +### Instale o binário kubectl no Windows (via download direto ou curl) {#install-kubectl-binary-on-windows-via-direct-download-or-curl} 1. Você tem duas opções para instalar o kubectl em seu dispositivo Windows From 64600189b4742af297df0c69de37689aa6276c1a Mon Sep 17 00:00:00 2001 From: Luis Oliveira Date: Fri, 29 Nov 2024 10:08:53 -0300 Subject: [PATCH 6/7] =?UTF-8?q?ajuste=20espa=C3=A7amento=20e=20branco?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-authored-by: Mauren <698465+stormqueen1990@users.noreply.github.com> --- content/pt-br/docs/tasks/tools/install-kubectl-windows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md index 93ce707504471..71962f966be20 100644 --- a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md +++ b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md @@ -80,7 +80,7 @@ Existem os seguintes métodos para instalar o kubectl no Windows: [Docker Desktop para Windows](https://docs.docker.com/docker-for-windows/#kubernetes) adiciona sua própria versão do `kubectl` ao `PATH`. Se você instalou o Docker Desktop anteriormente, pode ser necessário colocar sua entrada no `PATH` antes da adicionada pelo instalador do Docker Desktop -ou remover o `kubectl`do Docker Desktop. +ou remover o `kubectl` do Docker Desktop. {{< /note >}} ### Instalar no Windows usando Chocolatey, Scoop, ou winget {#install-nonstandard-package-tools} From 2cd92d2bf7970e6932d25b06357eb3a5a92d9003 Mon Sep 17 00:00:00 2001 From: Luis Oliveira Date: Fri, 29 Nov 2024 10:09:36 -0300 Subject: [PATCH 7/7] ajuste termo Co-authored-by: Mauren <698465+stormqueen1990@users.noreply.github.com> --- content/pt-br/docs/tasks/tools/install-kubectl-windows.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md index 71962f966be20..4d4e62cd3d46e 100644 --- a/content/pt-br/docs/tasks/tools/install-kubectl-windows.md +++ b/content/pt-br/docs/tasks/tools/install-kubectl-windows.md @@ -126,7 +126,7 @@ ou remover o `kubectl` do Docker Desktop. mkdir .kube ``` -5. Mude para o diretório `.kube` que você acabou de criar: +5. Navegue para o diretório `.kube` que você acabou de criar: ```powershell cd .kube