Instalar versões anteriores à AWS CLI versão 2 - AWS Command Line Interface
Solução de problemas de erros de instalação e desinstalação da AWS CLIPróximas etapas

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 no GitHub.

Instruções de instalação da AWS CLI versão 2:

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 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 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 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 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_64-2.0.30.zip, resultando no seguinte link: 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 da 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

  2. (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 .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.

    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.

    2. 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
ZqFYbwUJCv/cOgAKCRCmMQrMRnJHXKYuEAC+wtZ611qQtOl0t5spM9SWZuszbcyA
0xBAJq2pncnp6wdCOkuAPu4/R3UCIoD2C49MkLj9Y0Yvue8CCF6OIJ8L+fKBv2DI
yWZGmHL0p9wa/X8NCKQrKxK1gq5PuCzi3f3SqwfbZuZGeK/ubnmtttWXpUtuU/Iz
VR0u/0sAy3j4uTGKh2cX7XnZbSqgJhUk9H324mIJiSwzvw1Ker6xtH/LwdBeJCck
bVBdh3LZis4zuD4IZeBO1vRvjot3Oq4xadUv5RSPATg7T1kivrtLCnwvqc6L4LnF
0OkNysk94L3LQSHyQW2kQS1cVwr+yGUSiSp+VvMbAobAapmMJWP6e/dKyAUGIX6+
2waLdbBs2U7MXznx/2ayCLPH7qCY9cenbdj5JhG9ibVvFWqqhSo22B/URQE/CMrG
+3xXwtHEBoMyWEATr1tWwn2yyQGbkUGANneSDFiTFeoQvKNyyCFTFO1F2XKCcuDs
19nj34PE2TJilTG2QRlMr4D0NgwLLAMg2Los1CK6nXWnImYHKuaKS9LVaCoC8vu7
IRBik1NX6SjrQnftk0M9dY+s0ZbAN1gbdjZ8H3qlbl/4TxMdr87m8LP4FZIIo261
Eycv34pVkCePZiP+dgamEiQJ7IL4ZArio9mv6HbDGV6mLY45+l6/0EzCwkI5IyIf
BfWC9s/USgxchg==
=ptgS
-----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:          2025-07-24
User ID:          AWS CLI Team <aws-cli@amazon.com>
Key fingerprint:  FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

    3. 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

    4. 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 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 no GitHub.

    5. 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 <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.

  3. 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

  4. 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:

    1. 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

    2. 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

  5. Confirme a instalação com o comando a seguir. 

    $ aws --version
aws-cli/2.19.1 Python/3.11.6 Linux/5.10.205-195.807.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 a solução de problemas em Solução de problemas da AWS CLI.

(Opcional) Verificar a integridade do arquivo zip baixado

Se você optar por baixar manualmente o pacote do instalador .zip da AWS CLI versão 2 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 versão 2 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.

  2. 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
ZqFYbwUJCv/cOgAKCRCmMQrMRnJHXKYuEAC+wtZ611qQtOl0t5spM9SWZuszbcyA
0xBAJq2pncnp6wdCOkuAPu4/R3UCIoD2C49MkLj9Y0Yvue8CCF6OIJ8L+fKBv2DI
yWZGmHL0p9wa/X8NCKQrKxK1gq5PuCzi3f3SqwfbZuZGeK/ubnmtttWXpUtuU/Iz
VR0u/0sAy3j4uTGKh2cX7XnZbSqgJhUk9H324mIJiSwzvw1Ker6xtH/LwdBeJCck
bVBdh3LZis4zuD4IZeBO1vRvjot3Oq4xadUv5RSPATg7T1kivrtLCnwvqc6L4LnF
0OkNysk94L3LQSHyQW2kQS1cVwr+yGUSiSp+VvMbAobAapmMJWP6e/dKyAUGIX6+
2waLdbBs2U7MXznx/2ayCLPH7qCY9cenbdj5JhG9ibVvFWqqhSo22B/URQE/CMrG
+3xXwtHEBoMyWEATr1tWwn2yyQGbkUGANneSDFiTFeoQvKNyyCFTFO1F2XKCcuDs
19nj34PE2TJilTG2QRlMr4D0NgwLLAMg2Los1CK6nXWnImYHKuaKS9LVaCoC8vu7
IRBik1NX6SjrQnftk0M9dY+s0ZbAN1gbdjZ8H3qlbl/4TxMdr87m8LP4FZIIo261
Eycv34pVkCePZiP+dgamEiQJ7IL4ZArio9mv6HbDGV6mLY45+l6/0EzCwkI5IyIf
BfWC9s/USgxchg==
=ptgS
-----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:          2025-07-24
User ID:          AWS CLI Team <aws-cli@amazon.com>
Key fingerprint:  FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

  3. 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

  4. 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 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 no GitHub.

  5. 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 <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

  • 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 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.

  2. 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+L 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.

  3. 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.19.1 Python/3.11.6 Darwin/23.3.0 botocore/2.4.5

    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.

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 no GitHub.

  2. 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.

  3. 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.19.1 Python/3.11.6 Darwin/23.3.0 botocore/2.4.5

    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.

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.

    <?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
  <array>
    <dict>
      <key>choiceAttribute</key>
      <string>customLocation</string>
      <key>attributeSetting</key>
      <string>/Users/myusername</string>
      <key>choiceIdentifier</key>
      <string>default</string>
    </dict>
  </array>
</plist>

  2. 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 no GitHub.

  3. 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

  4. 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.

  5. 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.19.1 Python/3.11.6 Darwin/23.3.0 botocore/2.4.5

    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.

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 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 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.

    • 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 

      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 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 no GitHub.

  2. 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.19.1 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.

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 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, O comando “aws --version” retorna uma versão diferente da que você instalou e O comando “aws --version” retorna uma versão após a desinstalação da AWS CLI.

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 Configuração da AWS CLI.