# Instalar ou atualizar a versão mais recente da AWS CLI Este tópico descreve como instalar ou atualizar a versão mais recente da AWS Command Line Interface(AWS CLI) em sistemas operacionais compatíveis. Para obter informações sobre as versões mais recentes da AWS CLI, 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 uma versão anterior da AWS CLI, consulte [Instalar versões anteriores à AWS CLI versão 2](getting-started-version.md). Para obter instruções de desinstalação, consulte [Desinstalar a AWS CLI versão 2](uninstall.md). **Importante** As versões 1 e 2 da AWS CLI usam o mesmo nome de comando da `aws`. Se você instalou a AWS CLI versão 1 anteriormente, consulte [Guia de migração para a AWS CLI versão 2](cliv2-migration.md). **Topics** + [ ## Instruções de instalação e atualização da AWS CLI ](#getting-started-install-instructions) + [ ## Solução de problemas de erros de instalação e desinstalação da AWS CLI ](#install-tshoot) + [ ## Próximas etapas ](#install-next-steps) ## Instruções de instalação e atualização da AWS CLI Para obter as instruções de instalação, expanda a seção do sistema operacional. ### Linux #### Requisitos de instalação e atualização + 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 usa `glibc`, `groff` e `less`. Estes são incluídos por padrão na maioria das principais distribuições do Linux. + A AWS CLI pode ser utilizada em versões de 64 bits das distribuições recentes do CentOS, Fedora, Ubuntu, Amazon Linux 1, Amazon Linux 2, Amazon Linux 2023 e Linux ARM. + Como a AWS não mantém repositórios de terceiros diferentes de `snap`, não podemos garantir que eles contenham a versão mais recente da AWS CLI. #### Instalar ou atualizar a AWS CLI **Atenção** Se esta é a primeira vez que você realiza uma atualização no Amazon Linux, para instalar a versão mais recente da AWS CLI, você deve desinstalar a versão pré-instalada do `yum` usando o seguinte comando: ``` $ sudo yum remove awscli ``` Depois de remover a instalação do `yum` da AWS CLI, siga as instruções de instalação do Linux abaixo. Instale a AWS CLI usando um dos seguintes métodos: + **O instalador da linha de comando** é uma boa opção para controle de versão, pois você pode especificar a versão a ser instalada. Essa opção não é atualizada automaticamente e é necessário baixar um novo instalador sempre que atualizar para substituir a versão anterior. + **O pacote `snap` com suporte oficial** é uma boa opção para que a versão mais recente dos pacotes da AWS CLI como snap seja sempre atualizada automaticamente. Não há suporte integrado para selecionar versões secundárias da AWS CLI e, portanto, não é um método de instalação ideal se sua equipe precisar fixar versões. ------ #### [ Command line installer - Linux x86 (64-bit) ] Para atualizar a instalação atual da AWS CLI, baixe um novo instalador sempre que atualizar para substituir as versões anteriores. Siga estes passos na linha de comando para instalar a AWS CLI no Linux. A seguir estão as etapas de instalação rápida em um único grupo de copiar e colar que fornece uma instalação básica. Para obter instruções guiadas, veja as etapas a seguir. **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 instalar** a AWS CLI, execute os comandos a seguir. ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.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* para instalar a AWS CLI localmente para o usuário local. ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update ``` **Etapas de instalação guiada** 1. Baixe o arquivo de instalação de uma das seguintes maneiras: + **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`. ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip" ``` + **Baixe usando o URL**: para baixar o instalador com o navegador, use o seguinte URL: [https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip](https://awscli.amazonaws.com/awscli-exe-linux-x86_64.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: A6310ACC4672475C 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`. **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 ``` 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 ``` **nota** Ao atualizar de uma versão anterior, o comando `unzip` solicita a substituição dos arquivos existentes. Para ignorar essas solicitações, como com a automação de scripts, use o sinalizador de atualização `-u` para `unzip`. Esse sinalizador atualiza automaticamente os arquivos existentes e cria outros conforme necessário. ``` $ unzip -u 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, adicione as informações do symlink e instalador existentes para criar 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). ------ #### [ Command line - Linux ARM ] Para atualizar a instalação atual da AWS CLI, baixe um novo instalador sempre que atualizar para substituir as versões anteriores. Siga estes passos na linha de comando para instalar a AWS CLI no Linux. A seguir estão as etapas de instalação rápida em um único grupo de copiar e colar que fornece uma instalação básica. Para obter instruções guiadas, veja as etapas a seguir. **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 instalar** a AWS CLI, execute os comandos a seguir. ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.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.zip" -o "awscliv2.zip" unzip awscliv2.zip sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update ``` **Etapas de instalação guiada** 1. Baixe o arquivo de instalação de uma das seguintes maneiras: + **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`. ``` $ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip" ``` + **Baixe usando o URL**: para baixar o instalador com o navegador, use o seguinte URL: [https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip](https://awscli.amazonaws.com/awscli-exe-linux-aarch64.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: A6310ACC4672475C 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`. **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 ``` 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 ``` **nota** Ao atualizar de uma versão anterior, o comando `unzip` solicita a substituição dos arquivos existentes. Para ignorar essas solicitações, como com a automação de scripts, use o sinalizador de atualização `-u` para `unzip`. Esse sinalizador atualiza automaticamente os arquivos existentes e cria outros conforme necessário. ``` $ unzip -u 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, adicione as informações do symlink e instalador existentes para criar 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). ------ #### [ Snap package ] Nós fornecemos uma versão oficial com suporte da AWS da AWS CLI no `snap`. Se você quiser ter sempre a versão mais recente da AWS CLI instalado em seu sistema, um pacote snap fornece isso para você enquanto ele é atualizado automaticamente. Não há suporte integrado para selecionar versões secundárias da AWS CLI e, portanto, não é um método de instalação ideal se sua equipe precisar fixar versões. Se você quiser instalar uma versão secundária específica da AWS CLI, sugerimos que você use o instalador da linha de comando. 1. Se sua plataforma Linux ainda não estiver o `snap` instalado, instale o `snap` na sua plataforma. 1. Para obter informações sobre a instalação do `snap`, consulte [Instalar o daemon](https://snapcraft.io/docs/installing-snapd) na *documentação do snap*. 1. Talvez seja necessário reiniciar o sistema para que suas variáveis `PATH` sejam atualizadas corretamente. Se você estiver tendo problemas de instalação, siga as etapas em [Corrigir problemas comuns](https://snapcraft.io/docs/fix-common-issues) na *documentação do snap*. 1. Para verificar se o `snap` está instalado corretamente, execute o seguinte comando. ``` $ snap version ``` 1. Execute comando `snap install` a seguir para a AWS CLI. ``` $ snap install aws-cli --classic ``` Dependendo de suas permissões, talvez seja necessário adicionar `sudo` ao comando. ``` $ sudo snap install aws-cli --classic ``` **nota** Para ver o repositório de snap da AWS CLI, incluindo instruções adicionais do `snap`, consulte a página da [https://snapcraft.io/aws-cli](https://snapcraft.io/aws-cli) no *site do Canonical Snapcraft*. 1. Verifique se o AWS CLI está instalado corretamente. ``` $ aws --version aws-cli/2.27.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 ``` Se houver um erro, consulte [Solução de problemas da AWS CLI](cli-chap-troubleshooting.md). ------ ### macOS #### Requisitos de instalação e atualização + A AWS CLI pode ser utilizada no macOS versões 11 e posterior. Para obter mais informações, consulte as [atualizações da política de suporte do macOS para a AWS CLI v2](https://aws.amazon.com/blogs/developer/macos-support-policy-updates-for-the-aws-cli-v2/) no *blog de ferramentas para desenvolvedores da AWS*. + 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. **Matriz de suporte da versão do macOS** | AWS CLIVersão do | Versão compatível do macOS | | --- | --- | | 2.21.0: atual | 11\$1 | | 2.17.0-2.20.0 | 10.15\$1 | | 2.0.0-2.16.12 | 10.14 e anterior | #### Instalar ou atualizar a AWS CLI Se você estiver atualizando para a versão mais recente, use o mesmo método de instalação usado na versão atual. É possível instalar a AWS CLI de uma das maneiras a seguir. ------ #### [ GUI installer ] As etapas a seguir mostram como instalar a versão mais recente da AWS CLI usando a interface de usuário padrão do macOS e o navegador. 1. No navegador, baixe o arquivo `pkg` do macOS: [https://awscli.amazonaws.com/AWSCLIV2.pkg](https://awscli.amazonaws.com/AWSCLIV2.pkg) 1. Execute o arquivo baixado e siga as instruções na tela. Você pode optar por instalar a AWS CLI 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. O local padrão para um symlink é `/usr/local/bin/`: ``` $ ln -s /folder/installed/aws-cli/aws /usr/local/bin/aws $ ln -s /folder/installed/aws-cli/aws_completer /usr/local/bin/aws_completer ``` Se você não tiver permissões de gravação na pasta, talvez seja necessário usar `sudo` em seu comando. O exemplo a seguir usa `sudo` com o local padrão para um symlink em `/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 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. ``` $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" $ sudo installer -pkg AWSCLIV2.pkg -target / ``` **Instruções de instalação guiada** 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. ``` $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" ``` 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 com qualquer nome. Esse é um arquivo no formato XML que se parece com o exemplo a seguir. Deixe todo o valor como mostrado e substitua o caminho */Users/myusername* na linha 9 pelo caminho até a pasta em que deseja instalar a AWS CLI. *A pasta já deve existir, caso contrário, o comando falhará.* O exemplo de XML a seguir, chamado *choices.xml*, especifica o instalador para instalar a AWS CLI na pasta`/Users/myusername`, onde ele cria 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. ``` $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg" ``` 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/`. Substitua o `folder/installed` pelo caminho da instalação da AWS CLI. ``` $ 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 e atualização + A AWS CLI pode ser utilizada em versões compatíveis com o Microsoft Windows de 64 bits. + Direitos de administrador para instalar software #### Instalar ou atualizar a AWS CLI Para atualizar a instalação atual da AWS CLI 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. Fazer download e executar o instalador MSI da AWS CLI para Windows (64 bits) [https://awscli.amazonaws.com/AWSCLIV2.msi](https://awscli.amazonaws.com/AWSCLIV2.msi) Você também pode executar o comando `msiexec` para executar o instalador MSI. ``` C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.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*. Por exemplo, você pode usar a sinalização `/qn` para uma instalação silenciosa. ``` C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi /qn ``` 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 Após a instalação bem-sucedida da AWS CLI, você poderá excluir com segurança os arquivos do instalador baixados. 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).