

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Opções de instalação para Eksctl
<a name="installation"></a>

 `eksctl`está disponível para instalação a partir das versões oficiais, conforme descrito abaixo. Recomendamos que você instale somente `eksctl` a partir das GitHub versões oficiais. Você pode optar por usar um instalador terceirizado, mas esteja ciente de que a AWS não mantém nem oferece suporte a esses métodos de instalação. Use-os a seu próprio critério.

## Pré-requisito
<a name="_prerequisite"></a>

Você precisará ter as credenciais da API da AWS configuradas. O que funciona para o AWS CLI ou qualquer outra ferramenta (kops, Terraform etc.) deve ser suficiente. Você pode usar [variáveis de [`~/.aws/credentials`arquivo](https://docs.aws.amazon.com/cli/latest/userguide/cli-config-files.html) ou ambiente](https://docs.aws.amazon.com/cli/latest/userguide/cli-environment.html). Para obter mais informações, consulte a referência [da AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-environment.html).

Você também precisará do comando [AWS IAM Authenticator for Kubernetes](https://github.com/kubernetes-sigs/aws-iam-authenticator) (um ou `aws eks get-token` (disponível na versão 1.16.156 `aws-iam-authenticator` ou superior do AWS CLI) em seu. `PATH`

A conta do IAM usada para a criação do cluster EKS deve ter esses níveis mínimos de acesso.


| Serviço da AWS | Nível de acesso | 
| --- | --- | 
|  CloudFormation  |  Acesso total  | 
|  EC2  |   **Completo:** Marcação **limitada:** listar, ler, escrever  | 
|  EC2 Auto Scaling  |   **Limitado:** listar, escrever  | 
|  EKS  |  Acesso total  | 
|  IAM  |   **Limitado:** lista, leitura, gravação, gerenciamento de permissões  | 
|  Systems Manager  |   **Limitado:** Listar, Leir  | 

## Para Unix
<a name="_for_unix"></a>

Para baixar a versão mais recente, execute:

```
# for ARM systems, set ARCH to: `arm64`, `armv6` or `armv7`
ARCH=amd64
PLATFORM=$(uname -s)_$ARCH

curl -sLO "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_$PLATFORM.tar.gz"

# (Optional) Verify checksum
curl -sL "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_checksums.txt" | grep $PLATFORM | sha256sum --check

tar -xzf eksctl_$PLATFORM.tar.gz -C /tmp && rm eksctl_$PLATFORM.tar.gz

sudo install -m 0755 /tmp/eksctl /usr/local/bin && rm /tmp/eksctl
```

## No Windows
<a name="_for_windows"></a>

Download direto (versão mais recente):
+  [AMD64/x86\$164](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_windows_amd64.zip) 
+  [ARMv6](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_windows_armv6.zip) 
+  [ARMv7](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_windows_armv7.zip) 
+  [ARM64](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_windows_arm64.zip) 

Certifique-se de descompactar o arquivo em uma pasta na `PATH` variável.

Opcionalmente, verifique a soma de verificação:

1. [Baixe o arquivo de soma de verificação: mais recente](https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_checksums.txt) 

1. Use o prompt de comando para comparar manualmente `CertUtil` a saída com o arquivo de soma de verificação baixado.

   ```
     REM Replace amd64 with armv6, armv7 or arm64
     CertUtil -hashfile eksctl_Windows_amd64.zip SHA256
   ```

1. Usando PowerShell para automatizar a verificação usando o `-eq` operador para obter um `False` resultado `True` ou:

   ```
   # Replace amd64 with armv6, armv7 or arm64
    (Get-FileHash -Algorithm SHA256 .\eksctl_Windows_amd64.zip).Hash -eq ((Get-Content .\eksctl_checksums.txt) -match 'eksctl_Windows_amd64.zip' -split ' ')[0]
   ```

### Usando o Git Bash:
<a name="_using_git_bash"></a>

```
# for ARM systems, set ARCH to: `arm64`, `armv6` or `armv7`
ARCH=amd64
PLATFORM=windows_$ARCH

curl -sLO "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_$PLATFORM.zip"

# (Optional) Verify checksum
curl -sL "https://github.com/eksctl-io/eksctl/releases/latest/download/eksctl_checksums.txt" | grep $PLATFORM | sha256sum --check

unzip eksctl_$PLATFORM.zip -d $HOME/bin

rm eksctl_$PLATFORM.zip
```

O `eksctl` executável é colocado em`$HOME/bin`, que `$PATH` vem do Git Bash.

## Homebrew
<a name="_homebrew"></a>

Você pode usar o Homebrew para instalar software no macOS e no Linux.

A AWS mantém uma torneira Homebrew, incluindo eksctl.

Para obter mais informações sobre o Homebrew tap, consulte o [projeto no Github](https://github.com/aws/homebrew-tap) e a [fórmula do Homebrew](https://github.com/aws/homebrew-tap/blob/master/Formula/eksctl.rb) para eksctl.

 **Para instalar o eksctl com o Homebrew** 

1. [(Pré-requisito) Instale o Homebrew](https://brew.sh/) 

1. Adicione a torneira da AWS

   ```
   brew tap aws/tap
   ```

1. Instalar o eksctl

   ```
   brew install aws/tap/eksctl
   ```

## Docker
<a name="_docker"></a>

Para cada versão e RC, uma imagem de contêiner é enviada para o repositório ECR. `public.ecr.aws/eksctl/eksctl` Saiba mais sobre o uso da [Galeria Pública ECR - eksctl](https://gallery.ecr.aws/eksctl/eksctl). Por exemplo,

```
docker run --rm -it public.ecr.aws/eksctl/eksctl version
```

## Conclusão do Shell
<a name="_shell_completion"></a>

### Bash
<a name="_bash"></a>

Para habilitar a conclusão do bash, execute o seguinte ou coloque-o em `~/.bashrc` ou`~/.profile`:

```
. <(eksctl completion bash)
```

### Cinzas
<a name="_zsh"></a>

Para completar o zsh, execute:

```
mkdir -p ~/.zsh/completion/
eksctl completion zsh > ~/.zsh/completion/_eksctl
```

e insira o seguinte`~/.zshrc`:

```
fpath=($fpath ~/.zsh/completion)
```

Observe que, se você não estiver executando uma distribuição como oh-my-zsh, talvez seja necessário primeiro ativar o preenchimento automático (e inseri-lo `~/.zshrc` para torná-la persistente):

```
autoload -U compinit
compinit
```

### Peixe
<a name="_fish"></a>

Os comandos abaixo podem ser usados para o preenchimento automático de fish:

```
mkdir -p ~/.config/fish/completions
eksctl completion fish > ~/.config/fish/completions/eksctl.fish
```

### PowerShell
<a name="_powershell"></a>

O comando abaixo pode ser consultado para configurá-lo. Observe que o caminho pode ser diferente dependendo das configurações do sistema.

```
eksctl completion powershell > C:\Users\Documents\WindowsPowerShell\Scripts\eksctl.ps1
```

## Atualizações
<a name="_updates"></a>

**Importante**  
Se você instalar o eksctl baixando-o diretamente (sem usar um gerenciador de pacotes), precisará atualizá-lo manualmente.