Instruções de instalação e atualização da AWS CLI Solução de problemas de erros de instalação e desinstalação da AWS CLI Próximas etapas

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 versão 2.

Tópicos

Instruções de instalação e atualização da AWS CLI
Solução de problemas de erros de instalação e desinstalação da AWS CLI
Próximas etapas

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

Instalar ou atualizar a AWS CLI

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.

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.

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

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.

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

$ 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

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

Baixe e instale o comando gpg usando o gerenciador de pacotes. Para obter mais informações sobre a GnuPG, consulte o site da GnuPG.

Para criar o arquivo de chave pública, crie um arquivo de texto e cole o texto a seguir.

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

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.

Mostrar mais

Mostrar menos

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
```
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
Confirme a instalação com o comando a seguir.
```
$ aws --version
aws-cli/2.10.0 Python/3.11.2 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 a solução de problemas em Solução de problemas de erros da AWS CLI.

Requisitos de instalação e atualizaçã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.

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.

No navegador, baixe o arquivo pkg do macOS: https://awscli.amazonaws.com/AWSCLIV2.pkg
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.
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.10.0 Python/3.11.2 Darwin/18.7.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 de erros 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 /

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"
```
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.
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.10.0 Python/3.11.2 Darwin/18.7.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 de erros da AWS CLI.

Command line - Current user

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>
```
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"
```
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
```
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.
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.10.0 Python/3.11.2 Darwin/18.7.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 de erros 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.

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
```
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.10.0 Python/3.11.2 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 de erros 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 de erros 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 Instalação rápida.

Atenção O Javascript está desativado ou não está disponível no seu navegador.

Para usar a documentação da AWS, o Javascript deve estar ativado. Consulte as páginas de Ajuda do navegador para obter instruções.

Convenções do documento

Pré-requisitos

Versões anteriores