# Instalar versões anteriores à AWS CLI versão 2
Este tópico descreve como instalar ou atualizar versões anteriores à AWS Command Line Interface versão 2 (AWS CLI) em sistemas operacionais compatíveis. Para obter informações sobre os lançamentos da AWS CLI versão 2, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no GitHub.
Instruções de instalação da AWS CLI versão 2:
## Linux
### Requisitos de instalação
+ Você sabe qual lançamento da AWS CLI versão 2 gostaria de instalar. Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no *GitHub*.
+ Você deve ser capaz de extrair ou “descompactar” o pacote baixado. Se o sistema operacional não tiver o comando `unzip` integrado, use um equivalente.
+ A AWS CLI versão 2 usa `glibc`, `groff` e `less`. Estes são incluídos por padrão na maioria das principais distribuições do Linux.
+ A AWS CLI versão 2 é compatível com as versões de 64 bits das distribuições recentes do CentOS, Fedora, Ubuntu, Amazon Linux 1, Amazon Linux 2 e Linux ARM.
+ Como a AWS não mantém repositórios de terceiros, não podemos garantir que eles contenham a versão mais recente da AWS CLI.
### Instruções de instalação
Siga estes passos na linha de comando para instalar a AWS CLI no Linux.
Nós fornecemos as etapas em um grupo fácil de copiar e colar que leva em conta se você usa o Linux de 64 bits ou o Linux ARM. Consulte as descrições de cada linha nas etapas a seguir.
------
#### [ Linux x86 (64-bit) ]
**nota**
**(Opcional)** O bloco de comando a seguir baixa e instala a AWS CLI sem verificar a integridade do download. Para verificar a integridade do download, use as instruções passo a passo abaixo.
Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no *GitHub*.
**Para instalar** a AWS CLI, execute os comandos a seguir.
Para especificar uma versão, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `awscli-exe-linux-x86_64-2.0.30.zip`, o que resultaria no seguinte comando:
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
**Para atualizar a instalação atual** da AWS CLI, adicione as informações do symlink e instalador existentes para criar o comando `install` com os parâmetros `--bin-dir`, `--install-dir` e `--update`. O bloco de comando a seguir usa um exemplo de symlink de */usr/local/bin* e um exemplo de localização do instalador de */usr/local/aws-cli*.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
------
#### [ Linux ARM ]
**nota**
**(Opcional)** O bloco de comando a seguir baixa e instala a AWS CLI sem verificar a integridade do download. Para verificar a integridade do download, use as instruções passo a passo abaixo.
Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no *GitHub*.
**Para instalar** a AWS CLI, execute os comandos a seguir.
Para especificar uma versão, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `awscli-exe-linux-aarch64-2.0.30.zip`, o que resultaria no seguinte comando:
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
**Para atualizar a instalação atual** da AWS CLI, adicione as informações do symlink e instalador existentes para criar o comando `install` com os parâmetros `--bin-dir`, `--install-dir` e `--update`. O bloco de comando a seguir usa um exemplo de symlink de */usr/local/bin* e um exemplo de localização do instalador de */usr/local/aws-cli*.
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
------
1. Baixe o arquivo de instalação de uma das seguintes maneiras:
------
#### [ Linux x86 (64-bit) ]
+ **Usar o comando `curl`**: a opção `-o` especifica o nome do arquivo no qual o pacote obtido por download foi gravado. As opções no comando de exemplo a seguir gravam o arquivo obtido por download no diretório atual com o nome local `awscliv2.zip`.
Para especificar uma versão, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `awscli-exe-linux-x86_64-2.0.30.zip`, o que resultaria no seguinte comando:
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip" -o "awscliv2.zip"
```
Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no *GitHub*.
+ **Baixe usando o URL** –
Em seu navegador, baixe a versão específica da AWS CLI acrescentando um hífen e o número da versão ao nome do arquivo.
```
https://awscli.amazonaws.com/awscli-exe-linux-x86_64-version.number.zip
```
Nesse exemplo, o nome do arquivo da versão *2.0.30* seria awscli-exe-linux-x86\$164-2.0.30.zip, resultando no seguinte link: [https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip](https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip)
------
#### [ Linux ARM ]
+ **Usar o comando `curl`**: a opção `-o` especifica o nome do arquivo no qual o pacote obtido por download foi gravado. As opções no comando de exemplo a seguir gravam o arquivo obtido por download no diretório atual com o nome local `awscliv2.zip`.
Para especificar uma versão, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `awscli-exe-linux-aarch64-2.0.30.zip`, o que resultaria no seguinte comando:
```
$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
```
+ **Baixe usando o URL** –
Em seu navegador, baixe a versão específica da AWS CLI acrescentando um hífen e o número da versão ao nome do arquivo.
```
https://awscli.amazonaws.com/awscli-exe-linux-aarch64-version.number.zip
```
Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `awscli-exe-linux-aarch64-2.0.30.zip`, o que resultaria no seguinte link: [https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip](https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip)
------
1. **(Opcional) Verificar a integridade do arquivo zip baixado**
Se você tiver optado por baixar manualmente o pacote do instalador `.zip` da AWS CLI nas etapas acima, poderá executar as etapas a seguir para verificar as assinaturas por meio da ferramenta `GnuPG`.
Os arquivos AWS CLI do pacote do instalador da `.zip` são assinados criptograficamente com assinaturas PGP. Se houver qualquer dano ou alteração dos arquivos, ocorrerá uma falha nessa verificação e você não deverá prosseguir com a instalação.
1. Baixe e instale o comando `gpg` usando o gerenciador de pacotes. Para obter mais informações sobre a `GnuPG`, consulte o [site da GnuPG](https://www.gnupg.org/).
1. Para criar o arquivo de chave pública, crie um arquivo de texto e cole o texto a seguir.
```
-----BEGIN PGP PUBLIC KEY BLOCK-----
mQINBF2Cr7UBEADJZHcgusOJl7ENSyumXh85z0TRV0xJorM2B/JL0kHOyigQluUG
ZMLhENaG0bYatdrKP+3H91lvK050pXwnO/R7fB/FSTouki4ciIx5OuLlnJZIxSzx
PqGl0mkxImLNbGWoi6Lto0LYxqHN2iQtzlwTVmq9733zd3XfcXrZ3+LblHAgEt5G
TfNxEKJ8soPLyWmwDH6HWCnjZ/aIQRBTIQ05uVeEoYxSh6wOai7ss/KveoSNBbYz
gbdzoqI2Y8cgH2nbfgp3DSasaLZEdCSsIsK1u05CinE7k2qZ7KgKAUIcT/cR/grk
C6VwsnDU0OUCideXcQ8WeHutqvgZH1JgKDbznoIzeQHJD238GEu+eKhRHcz8/jeG
94zkcgJOz3KbZGYMiTh277Fvj9zzvZsbMBCedV1BTg3TqgvdX4bdkhf5cH+7NtWO
lrFj6UwAsGukBTAOxC0l/dnSmZhJ7Z1KmEWilro/gOrjtOxqRQutlIqG22TaqoPG
fYVN+en3Zwbt97kcgZDwqbuykNt64oZWc4XKCa3mprEGC3IbJTBFqglXmZ7l9ywG
EEUJYOlb2XrSuPWml39beWdKM8kzr1OjnlOm6+lpTRCBfo0wa9F8YZRhHPAkwKkX
XDeOGpWRj4ohOx0d2GWkyV5xyN14p2tQOCdOODmz80yUTgRpPVQUtOEhXQARAQAB
tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4CGwMF
CwkIBwIGFQoJCAsCBBYCAwECHgECF4AWIQT7Xbd/1cEYuAURraimMQrMRnJHXAUC
aGveYQUJDMpiLAAKCRCmMQrMRnJHXKBYD/9Ab0qQdGiO5hObchG8xh8Rpb4Mjyf6
0JrVo6m8GNjNj6BHkSc8fuTQJ/FaEhaQxj3pjZ3GXPrXjIIVChmICLlFuRXYzrXc
Pw0lniybypsZEVai5kO0tCNBCCFuMN9RsmmRG8mf7lC4FSTbUDmxG/QlYK+0IV/l
uJkzxWa+rySkdpm0JdqumjegNRgObdXHAQDWlubWQHWyZyIQ2B4U7AxqSpcdJp6I
S4Zds4wVLd1WE5pquYQ8vS2cNlDm4QNg8wTj58e3lKN47hXHMIb6CHxRnb947oJa
pg189LLPR5koh+EorNkA1wu5mAJtJvy5YMsppy2y/kIjp3lyY6AmPT1posgGk70Z
CmToEZ5rbd7ARExtlh76A0cabMDFlEHDIK8RNUOSRr7L64+KxOUegKBfQHb9dADY
qqiKqpCbKgvtWlds909Ms74JBgr2KwZCSY1HaOxnIr4CY43QRqAq5YHOay/mU+6w
hhmdF18vpyK0vfkvvGresWtSXbag7Hkt3XjaEw76BzxQH21EBDqU8WJVjHgU6ru+
DJTs+SxgJbaT3hb/vyjlw0lK+hFfhWKRwgOXH8vqducF95NRSUxtS4fpqxWVaw3Q
V2OWSjbne99A5EPEySzryFTKbMGwaTlAwMCwYevt4YT6eb7NmFhTx0Fis4TalUs+
j+c7Kg92pDx2uQ==
=OBAt
-----END PGP PUBLIC KEY BLOCK-----
```
Para referência, veja a seguir os detalhes da chave pública.
```
Key ID: A6310ACC4672
Type: RSA
Size: 4096/4096
Created: 2019-09-18
Expires: 2026-07-07
User ID: AWS CLI Team
Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
1. Importe a chave pública da AWS CLI com o comando a seguir, substituindo *public-key-file-name* pelo nome do arquivo da chave pública que você criou.
```
$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team " imported
gpg: Total number processed: 1
gpg: imported: 1
```
1. Baixe o arquivo de assinatura da AWS CLI para o pacote baixado. Ele tem o mesmo caminho e nome do arquivo `.zip` ao qual ele corresponde, mas tem a extensão `.sig`. Nos exemplos a seguir, ele foi salvo no diretório atual como um arquivo chamado `awscliv2.sig`.
------
#### [ Linux x86 (64-bit) ]
**Para a versão mais recente da AWS CLI**, use o seguinte bloco de comandos:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig
```
**Para uma versão específica da AWS CLI**, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `awscli-exe-linux-x86_64-2.0.30.zip.sig`, o que resultaria no seguinte comando:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip.sig
```
Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no *GitHub*.
------
#### [ Linux ARM ]
**Para a versão mais recente da AWS CLI**, use o seguinte bloco de comandos:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig
```
**Para uma versão específica da AWS CLI**, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `awscli-exe-linux-aarch64-2.0.30.zip.sig`, o que resultaria no seguinte comando:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip.sig
```
Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1) no *GitHub*.
------
1. Verifique a assinatura, passando os nomes dos arquivos `.sig` e `.zip` baixados como parâmetros para o comando `gpg`.
```
$ gpg --verify awscliv2.sig awscliv2.zip
```
A saída deve ser semelhante à seguinte.
```
gpg: Signature made Mon Nov 4 19:00:01 2019 PST
gpg: using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team " [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg: There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
```
**Importante**
O aviso na saída é esperado e não indica um problema. Isso ocorre porque não há uma cadeia de confiança entre a chave PGP pessoal (se você tiver uma) e a chave PGP da AWS CLI. Para obter mais informações, consulte [Web of trust](https://en.wikipedia.org/wiki/Web_of_trust).
1. Descompacte o instalador. Se a distribuição do Linux não tiver um comando `unzip` integrado, use um equivalente para descompactá-lo. O comando de exemplo a seguir descompacta o pacote e cria um diretório chamado `aws` no diretório atual.
```
$ unzip awscliv2.zip
```
1. Execute o programa de instalação. O comando de instalação usa um arquivo chamado `install` no diretório `aws` recém-descompactado. Por padrão, os arquivos são todos instalados em `/usr/local/aws-cli`, e um link simbólico é criado em `/usr/local/bin`. O comando inclui `sudo` para conceder permissões de gravação para esses diretórios.
```
$ sudo ./aws/install
```
Você poderá instalar sem `sudo` se especificar diretórios para os quais já tenha permissões de gravação. Use as seguintes instruções para o comando `install` para especificar o local de instalação:
+ Os caminhos fornecidos para os parâmetros `-i` e `-b` não devem conter nomes de diretório nem nomes de volume com caracteres de espaço ou outros caracteres de espaço em branco. Se houver um espaço, a instalação falhará.
+ `--install-dir` ou `-i`: essa opção especifica o diretório para o todos os arquivos serão copiados.
O valor padrão é `/usr/local/aws-cli`.
+ `--bin-dir` ou `-b`: essa opção especifica que o programa `aws` principal no diretório de instalação está simbolicamente vinculado ao arquivo `aws` no caminho especificado. É necessário ter permissões de gravação no diretório especificado. Criar um symlink para um diretório que já está em seu caminho elimina a necessidade de adicionar o diretório de instalação à variável `$PATH` do usuário.
O valor padrão é `/usr/local/bin`.
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
**nota**
Para atualizar a instalação atual da AWS CLI versão 2 para uma versão mais recente, adicione as informações do symlink e instalador existentes para construir o comando `install` com o parâmetro `--update`.
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
Para localizar o diretório de instalação e o symlink existentes, execute as seguintes etapas:
Use o comando `which` para encontrar o symlink. Isso fornece o caminho que deve ser usado com o parâmetro `--bin-dir`.
```
$ which aws
/usr/local/bin/aws
```
Use o comando `ls` para encontrar o diretório para o qual o symlink aponta. Isso fornece o caminho que deve ser usado com o parâmetro `--install-dir`.
```
$ ls -l /usr/local/bin/aws
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli/v2/current/bin/aws
```
1. Confirme a instalação com o comando a seguir.
```
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64
```
Se não for possível encontrar o comando `aws`, talvez seja necessário reiniciar o terminal ou seguir a solução de problemas em [Solução de problemas da AWS CLI](cli-chap-troubleshooting.md).
## macOS
### Requisitos de instalação
+ Você sabe qual lançamento da AWS CLI versão 2 gostaria de instalar. Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://github.com/aws/aws-cli/blob/v2/CHANGELOG.rst?plain=1) no *GitHub*.
+ Oferecemos suporte à AWS CLI versão 2 nas versões do macOS de 64 bits com suporte da Apple.
+ Como a AWS não mantém repositórios de terceiros, não podemos garantir que eles contenham a versão mais recente da AWS CLI.
### Instruções de instalação
Você pode instalar a AWS CLI versão 2 no macOS usando as opções a seguir.
------
#### [ GUI installer ]
As etapas a seguir mostram como instalar ou atualizar para o lançamento mais recente da AWS CLI versão 2 usando a interface de usuário padrão do macOS e o navegador. Se você estiver atualizando para a versão mais recente, use o mesmo método de instalação usado para a versão atual.
1. Em seu navegador, baixe a versão específica da AWS CLI acrescentando um hífen e o número da versão ao nome do arquivo.
```
https://awscli.amazonaws.com/AWSCLIV2-version.number.pkg
```
Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `AWSCLIV2-2.0.30.pkg`, o que resultaria no seguinte link: [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg).
1. Execute o arquivo baixado e siga as instruções na tela. Você pode optar por instalar a AWS CLI versão 2 das seguintes maneiras:
+ **Para todos os usuários no computador (requer `sudo`)**
+ Você pode instalar em qualquer pasta ou escolher a padrão recomendada `/usr/local/aws-cli`.
+ O instalador cria automaticamente um symlink em `/usr/local/bin/aws` que vincula o programa principal na pasta de instalação que você escolheu.
+ **Apenas para o usuário atual (não requer `sudo`)**
+ Você pode instalar em qualquer pasta para a qual tenha permissão de gravação.
+ Devido a permissões de usuário padrão, após a conclusão do instalador, é necessário criar manualmente um arquivo de symlink no `$PATH` que aponta para os programas `aws` e `aws_completer` usando os comandos a seguir no prompt de comando. Se `$PATH` incluir uma pasta na qual você pode gravar, será possível executar o comando a seguir sem `sudo` se você especificar essa pasta como o caminho de destino. Se você não tiver uma pasta gravável no `$PATH`, será necessário usar `sudo` nos comandos a fim de obter permissões para gravar na pasta de destino especificada. O local padrão para um symlink é `/usr/local/bin/`.
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
**nota**
É possível visualizar logs de depuração para a instalação pressionando **Cmd\$1L** em qualquer lugar do instalador. Essa ação abre um painel de log que permite filtrar e salvar o log. O arquivo de log também é salvo automaticamente em `/var/log/install.log`.
1. Para verificar se o shell pode encontrar e executar o comando `aws` no `$PATH`, use os comandos a seguir.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
Se não for possível encontrar o comando `aws`, talvez seja necessário reiniciar o terminal ou seguir a solução de problemas em [Solução de problemas da AWS CLI](cli-chap-troubleshooting.md).
------
#### [ Command line installer - All users ]
Se você tiver permissões `sudo`, poderá instalar a AWS CLI versão 2 para todos os usuários no computador. Nós fornecemos as etapas em um grupo fácil de copiar e colar. Consulte as descrições de cada linha nas etapas a seguir.
Para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `AWSCLIV2-2.0.30.pkg`, o que resultaria no seguinte comando:
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /
```
1. Baixe o arquivo usando o comando `curl`. A opção `-o` especifica o nome do arquivo no qual o pacote obtido por download foi gravado. No exemplo anterior, o arquivo é gravado como `AWSCLIV2.pkg` na pasta atual.
Para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `AWSCLIV2-2.0.30.pkg`, o que resultaria no seguinte comando:
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
```
Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no *GitHub*.
1. Execute o programa `installer` padrão do macOS, especificando o arquivo `.pkg` baixado como a origem. Use o parâmetro `-pkg` para especificar o nome do pacote a ser instalado e o parâmetro `-target /` para especificar em qual unidade instalar o pacote. Os arquivos são instalados no `/usr/local/aws-cli`, e um symlink é criado automaticamente em `/usr/local/bin`. Você deve incluir `sudo` no comando para conceder permissões de gravação para essas pastas.
```
$ sudo installer -pkg ./AWSCLIV2.pkg -target /
```
Após a conclusão da instalação, os logs de depuração são gravados em `/var/log/install.log`.
1. Para verificar se o shell pode encontrar e executar o comando `aws` no `$PATH`, use os comandos a seguir.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
Se não for possível encontrar o comando `aws`, talvez seja necessário reiniciar o terminal ou seguir a solução de problemas em [Solução de problemas da AWS CLI](cli-chap-troubleshooting.md).
------
#### [ Command line - Current user ]
1. Para especificar em qual pasta a AWS CLI está instalada, é necessário criar um arquivo XML. Esse é um arquivo no formato XML que se parece com o exemplo a seguir. Deixe todos os valores como mostrado e substitua o caminho */Users/myusername* na linha 9 pelo caminho até a pasta em que deseja instalar a AWS CLI versão 2. *A pasta já deve existir, caso contrário, o comando falhará.* Esse exemplo XML especifica que o instalador instalará a AWS CLI na pasta `/Users/myusername`, em que ele criará uma pasta chamada `aws-cli`.
```
choiceAttribute
customLocation
attributeSetting
/Users/myusername
choiceIdentifier
default
```
1. Baixe o instalador `pkg` usando o comando `curl`. A opção `-o` especifica o nome do arquivo no qual o pacote obtido por download foi gravado. No exemplo anterior, o arquivo é gravado como `AWSCLIV2.pkg` na pasta atual.
Para a versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo. Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `AWSCLIV2-2.0.30.pkg`, o que resultaria no seguinte comando:
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2-2.0.30.pkg" -o "AWSCLIV2.pkg"
```
Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no *GitHub*.
1. Execute o programa `installer` padrão do macOS com as seguintes opções:
+ Especifique o nome do pacote a ser instalado usando o parâmetro `-pkg`.
+ Especifique uma instalação *somente para o usuário atual* definindo o parâmetro `-target` como `CurrentUserHomeDirectory`.
+ Especifique o caminho (relativo à pasta atual) e o nome do arquivo XML criado no parâmetro `-applyChoiceChangesXML`.
O exemplo a seguir instala a AWS CLI na pasta `/Users/myusername/aws-cli`.
```
$ installer -pkg AWSCLIV2.pkg \
-target CurrentUserHomeDirectory \
-applyChoiceChangesXML choices.xml
```
1. Como as permissões de usuário padrão geralmente não permitem gravar em pastas no `$PATH`, o instalador nesse modo não tenta adicionar os symlinks aos programas `aws` e `aws_completer`. Para que a AWS CLI seja executada corretamente, é necessário criar manualmente os symlinks após a conclusão do instalador. Se `$PATH` incluir uma pasta na qual você pode gravar e você especificar a pasta como o caminho de destino, é possível executar o comando a seguir sem `sudo`. Se você não tiver uma pasta gravável no `$PATH`, será necessário usar `sudo` para permissões para gravar na pasta de destino especificada. O local padrão para um symlink é `/usr/local/bin/`.
```
$ sudo ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws
$ sudo ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer
```
Após a conclusão da instalação, os logs de depuração são gravados em `/var/log/install.log`.
1. Para verificar se o shell pode encontrar e executar o comando `aws` no `$PATH`, use os comandos a seguir.
```
$ which aws
/usr/local/bin/aws
$ aws --version
aws-cli/2.27.41 Python/3.11.6 Darwin/23.3.0
```
Se não for possível encontrar o comando `aws`, talvez seja necessário reiniciar o terminal ou seguir a solução de problemas em [Solução de problemas da AWS CLI](cli-chap-troubleshooting.md).
------
## Windows
### Requisitos de instalação
+ Você sabe qual lançamento da AWS CLI versão 2 gostaria de instalar. Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no *GitHub*.
+ A AWS CLI pode ser utilizada em versões compatíveis com o Microsoft Windows de 64 bits.
+ Direitos de administrador para instalar software
### Instruções de instalação
Para atualizar a instalação atual da AWS CLI versão 2 no Windows, baixe um novo instalador sempre que atualizar para substituir as versões anteriores. A AWS CLI é atualizada regularmente. Para ver quando a versão mais recente foi lançada, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no *GitHub*.
1. Baixe e execute o instalador MSI da AWS CLI para Windows (64 bits) de uma das seguintes maneiras:
+ **Baixando e executando o instalador MSI:** para criar seu link de download para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo.
```
https://awscli.amazonaws.com/AWSCLIV2-version.number.msi
```
Neste exemplo, o nome do arquivo da versão *2.0.30* seria `AWSCLIV2-2.0.30.msi`, o que resultaria no seguinte link: [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi).
+ **Usando o comando msiexec:** você também pode usar o instalador MSI adicionando o link ao comando `msiexec`. Para uma versão específica da AWS CLI, acrescente um hífen e o número da versão ao nome do arquivo.
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-version.number.msi
```
Neste exemplo, o nome do arquivo para a versão *2.0.30* seria `AWSCLIV2-2.0.30.msi`, o que resultaria no seguinte link: [https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi](https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi)
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2-2.0.30.msi
```
Com relação a vários parâmetros que podem ser usados com `msiexec`, consulte [msiexec](https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/msiexec) no site de *documentação da Microsoft*.
Para obter uma lista das versões, consulte o [Log de alterações da AWS CLI versão 2](https://raw.githubusercontent.com/aws/aws-cli/v2/CHANGELOG.rst) no *GitHub*.
1. Para confirmar a instalação, abra o menu **Início**, procure `cmd` para abrir uma janela do prompt de comando e, no prompt de comando, use o comando `aws --version`.
```
C:\> aws --version
aws-cli/2.27.41 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
Se o Windows não puder localizar o programa, talvez seja necessário fechar e abrir a janela do prompt de comando novamente para atualizar o caminho ou seguir a solução de problemas em [Solução de problemas da AWS CLI](cli-chap-troubleshooting.md).
## Solução de problemas de erros de instalação e desinstalação da AWS CLI
Se você encontrar problemas após instalar ou desinstalar a AWS CLI, consulte [Solução de problemas da AWS CLI](cli-chap-troubleshooting.md) para obter os passos para a solução de problemas. Para obter os passos mais relevantes para a solução de problemas, consulte [Erros de comando não encontrado](cli-chap-troubleshooting.md#tshoot-install-not-found), [O comando “`aws --version`” retorna uma versão diferente da que você instalou](cli-chap-troubleshooting.md#tshoot-install-wrong-version) e [O comando “`aws --version`” retorna uma versão após a desinstalação da AWS CLI](cli-chap-troubleshooting.md#tshoot-uninstall-1).
## Próximas etapas
Depois de concluir as etapas em [Pré-requisitos para usar a AWS CLI versão 2](getting-started-prereqs.md) e instalar a AWS CLI, você deve utilizar [Configuração da AWS CLI](getting-started-quickstart.md).