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 as Notas de alteração da AWS CLI
Para instalar uma versão anterior da AWS CLI, consulte Instalar versões anteriores à AWS CLI versão 2.
Para obter instruções de desinstalação, consulte Desinstalar a AWS CLI versão 2.
As versões 1 e 2 da AWS CLI usam o mesmo nome de comando da aws
. Se você tiver as duas versões instaladas, o computador usará a primeira encontrada no caminho de pesquisa. Se você já instalou a AWS CLI versão 1, recomendamos executar um dos seguintes procedimentos para usar a AWS CLI versão 2:
-
Recomendado: desinstalar a AWS CLI versão 1 e usar apenas a AWS CLI versão 2. Para obter instruções de desinstalação, determine o método usado para instalar a AWS CLI versão 1 e siga as instruções de desinstalação apropriadas para seu sistema operacional em Instalar, atualizar e desinstalar a AWS CLIversão 1.
-
Use a capacidade do sistema operacional para criar um link simbólico (symlink) ou um alias com um nome diferente para um dos dois comandos da
aws
. Por exemplo, você pode usar um link simbólicoou um alias no Linux e no macOS ou DOSKEY
no Windows.
Para obter informações sobre as principais diferenças entre a versão 1 e a versão 2, consulte Principais alterações – Migração da AWS CLI versão 1 para a versão 2.
Instruções de instalação da AWS CLI:
Requisitos de instalaçã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
eless
. 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 e Lunux 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.
Instalar ou atualizar a AWS CLI
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.
-
Baixe o arquivo de instalação de uma das seguintes maneiras:
-
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 chamadoaws
no diretório atual.$
unzip awscliv2.zip
-
Execute o programa de instalação. O comando de instalação usa um arquivo chamado
install
no diretórioaws
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 incluisudo
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 comandoinstall
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 programaaws
principal no diretório de instalação está simbolicamente vinculado ao arquivoaws
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
--updatePara 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
-
-
Confirme a instalação com o comando a seguir.
$
aws --version
aws-cli/2.4.5 Python/3.8.8 Linux/4.14.133-113.105.amzn2.x86_64 botocore/2.4.5
Se não for possível encontrar o comando
aws
, talvez seja necessário reiniciar o terminal ou seguir as instruções em Como adicionar a AWS CLI ao seu caminho.
(Opcional) Verificar a integridade do arquivo zip baixado
Se você optar 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 .zip
do pacote do instalador da AWS CLI 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.
-
Baixe e instale o comando
gpg
usando o gerenciador de pacotes. Para obter mais informações sobre aGnuPG
, consulte o site da GnuPG. -
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 tCFBV1MgQ0xJIFRlYW0gPGF3cy1jbGlAYW1hem9uLmNvbT6JAlQEEwEIAD4WIQT7 Xbd/1cEYuAURraimMQrMRnJHXAUCXYKvtQIbAwUJB4TOAAULCQgHAgYVCgkICwIE FgIDAQIeAQIXgAAKCRCmMQrMRnJHXJIXEAChLUIkg80uPUkGjE3jejvQSA1aWuAM yzy6fdpdlRUz6M6nmsUhOExjVIvibEJpzK5mhuSZ4lb0vJ2ZUPgCv4zs2nBd7BGJ MxKiWgBReGvTdqZ0SzyYH4PYCJSE732x/Fw9hfnh1dMTXNcrQXzwOmmFNNegG0Ox au+VnpcR5Kz3smiTrIwZbRudo1ijhCYPQ7t5CMp9kjC6bObvy1hSIg2xNbMAN/Do ikebAl36uA6Y/Uczjj3GxZW4ZWeFirMidKbtqvUz2y0UFszobjiBSqZZHCreC34B hw9bFNpuWC/0SrXgohdsc6vK50pDGdV5kM2qo9tMQ/izsAwTh/d/GzZv8H4lV9eO tEis+EpR497PaxKKh9tJf0N6Q1YLRHof5xePZtOIlS3gfvsH5hXA3HJ9yIxb8T0H QYmVr3aIUes20i6meI3fuV36VFupwfrTKaL7VXnsrK2fq5cRvyJLNzXucg0WAjPF RrAGLzY7nP1xeg1a0aeP+pdsqjqlPJom8OCWc1+6DWbg0jsC74WoesAqgBItODMB rsal1y/q+bPzpsnWjzHV8+1/EtZmSc8ZUGSJOPkfC7hObnfkl18h+1QtKTjZme4d H17gsBJr+opwJw/Zio2LMjQBOqlm3K1A4zFTh7wBC7He6KPQea1p2XAMgtvATtNe YLZATHZKTJyiqA== =vYOk -----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: 2023-09-17 User ID: AWS CLI Team <aws-cli@amazon.com> Key fingerprint: FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
-
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 <aws-cli@amazon.com>" imported gpg: Total number processed: 1 gpg: imported: 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 chamadoawscliv2.sig
. -
Verifique a assinatura, passando os nomes dos arquivos
.sig
e.zip
baixados como parâmetros para o comandogpg
.$
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 <aws-cli@amazon.com>" [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
.
Requisitos de instalação
-
A AWS CLI pode ser utilizada nas versões compatíveis com o a Apple macOS de 64 bits.
-
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.
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.
Requisitos de instalaçã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 Changelog da AWS CLI
-
Baixar e executar o instalador MSI da AWS CLI para Windows (64 bits)
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 msiexecno site de documentação da Microsoft. -
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 comandoaws --version
.C:\>
aws --version
aws-cli/2.4.5 Python/3.8.8 Windows/10 exe/AMD64 prompt/off
Se o Windows não conseguir localizar o programa, talvez seja necessário fechar e abrir a janela do prompt de comando novamente para atualizar o caminho ou Como adicionar a AWS CLI ao seu caminho.
Próximas etapas
Depois de concluir as etapas em Pré-requisitos para usar a AWS CLI versão 2 e instalar a AWS CLI, você deve utilizar Instalação rápida.