Instalar ou atualizar a versão mais recente da AWS CLI - AWS Command Line Interface

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

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.

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 Migrar da AWS CLI versão 1 para a AWS CLI versão 2.

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.

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

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

      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.

    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
    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
  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, 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:

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

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

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

      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
    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
  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, 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:

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

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 na documentação do snap.

    2. 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 na documentação do snap.

    3. Para verificar se o snap está instalado corretamente, execute o seguinte comando.

      $ snap version
  2. 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 aws-cli no site do Canonical Snapcraft.

  3. Verifique se o AWS CLI está instalado corretamente.

    $ aws --version aws-cli/2.17.20 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/2.4.5

    Se houver um erro, consulte Solução de problemas da AWS CLI.

Requisitos de instalação e atualização

  • A AWS CLI pode ser utilizada no macOS versões 10.15 e posterior. Para obter mais informações, consulte as atualizações da política de suporte do macOS para a 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.

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

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

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

    $ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
  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/. 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.

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

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

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 e instalar a AWS CLI, você deve utilizar Configuração da AWS CLI.