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.
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
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.
(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
-
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
-
(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.
-----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
-
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
.
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.
-
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
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.
-
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
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
Para atualizar a instalação atual da AWS CLI, adicione as informações do symlink e instalador existentes para criar o comando install
com o parâmetro --update
.
$
sudo ./aws/install --bin-dir /usr/local/bin
--install-dir /usr/local/aws-cli
--update
Para localizar o diretório de instalação e o symlink existentes, execute as seguintes etapas:
-
Use o comando which
para encontrar o symlink. Isso fornece o caminho que deve ser usado com o parâmetro --bin-dir
.
$
which aws
/usr/local/bin
/aws
-
Use o comando ls
para encontrar o diretório para o qual o symlink aponta. Isso fornece o caminho que deve ser usado com o parâmetro --install-dir
.
$
ls -l /usr/local/bin/aws
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli
/v2/current/bin/aws
-
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.
(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
-
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
-
(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.
-----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
-
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
.
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
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.
-
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
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
Para atualizar a instalação atual da AWS CLI, adicione as informações do symlink e instalador existentes para criar o comando install
com o parâmetro --update
.
$
sudo ./aws/install --bin-dir /usr/local/bin
--install-dir /usr/local/aws-cli
--update
Para localizar o diretório de instalação e o symlink existentes, execute as seguintes etapas:
-
Use o comando which
para encontrar o symlink. Isso fornece o caminho que deve ser usado com o parâmetro --bin-dir
.
$
which aws
/usr/local/bin
/aws
-
Use o comando ls
para encontrar o diretório para o qual o symlink aponta. Isso fornece o caminho que deve ser usado com o parâmetro --install-dir
.
$
ls -l /usr/local/bin/aws
lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/aws -> /usr/local/aws-cli
/v2/current/bin/aws
-
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.
-
Se sua plataforma Linux ainda não estiver o snap
instalado, instale o snap
na sua plataforma.
-
Para obter informações sobre a instalação do snap
, consulte Instalar o daemon na documentação do snap.
-
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.
-
Para verificar se o snap
está instalado corretamente, execute o seguinte comando.
$
snap version
-
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
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.
-
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.
-
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:
É 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.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
-
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.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
-
-
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/
. 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
.
-
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
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.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.