DEV Community

Filipe Almeida Guimaraes for AWS Community Builders

Posted on • Edited on

1

Como instalar ou atualizar o seu AWS CLI corretamente usando o Ubuntu 22.04 no WSL2 (Windows 11)

Nessa documentação você terá acesso ao processo de instalação e atualização do AWS CLI sendo feito via terminal em uma distribuição Ubuntu 22.04 executada via WSL 2.0 no Windows 11

Sumário:

  • Instalação do AWS CLI;

  • Atualização do AWS CLI;

  • Deleção do AWS CLI;

Instalação do AWS CLI

O processo de instalação do AWS CLI é extremamente simples e a documentação oficial da AWS no entrega os comandos necessários, são eles:

curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
sudo ./aws/install
Enter fullscreen mode Exit fullscreen mode

O comando curl baixa o binário compactado em um zip file;
O comando unzip extrai esse binário do zip no diretório /aws (Se você não tiver o unzip instalado, basta executar o comando: sudo apt install unzip -y;
O comando sudo ./aws/install instala o aws-cli no seu terminal;

Para verificar se a instalação aconteceu corretamente, basta executar o comando:

aws --version
Enter fullscreen mode Exit fullscreen mode

Você verá a versão do CLI instalado como retorno no seu terminal:

Saída do comando mostrando a versão instalado do aws-cli no seu terminal

Atualização do AWS CLI

Caso o seu aws-cli esteja desatualizado, o processo de atualização também é consideravelmente simples. Abaixo estão os passos:

Execute o comando abaixo para baixar o binário mais recente do AWS CLI e extraia o arquivo:

curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"
unzip awscliv2.zip
Enter fullscreen mode Exit fullscreen mode

Após baixar e extrair o arquivo, você verá o seguinte no seu terminal:

Execute o comando ls -l para listar o conteudo do seu diretório

Você poderá deletar o arquivo .zip depois de extraído, se desejar. Para deletar, basta executar o comando:

rm awscliv2.zip
Enter fullscreen mode Exit fullscreen mode

Para atualizar finalmente o aws-cli, execute o comando which aws para verificar o local de instalação do aws-cli e usar essa saída no próximo comando que executaremos. Normalmente o resultado é: /usr/local/bin

Se o seu local for diferente você precisa informá-lo no comando de instalação abaixo no parâmetro **bin-dir. *O parâmetro **instal-dir* indica o local de instalação do aws-cli e deve ser deixado dessa forma. O comando final ficaria da seguinte forma:

sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
Enter fullscreen mode Exit fullscreen mode

Após a execução do comando, o aws-cli mais recente será instalado no seu terminal. Para conferir, basta executar o comando:

aws --version
Enter fullscreen mode Exit fullscreen mode

Executando o comando novamente, você verá que a versão mais recente do AWS CLI foi instalada em seu terminal

Antes: Versão 2.15.40

Saída do comando mostrando a versão instalado do aws-cli no seu terminal antes do update

Depois: Versão 2.17.13

Saída do comando mostrando a versão instalado do aws-cli no seu terminal depois do update

Troubleshooting:

Caso após executar e conferir toda a sequência de comandos, o seu aws-cli não for atualizado, você pode remover explicitamente o aws-cli e depois instalá-lo novamente. Para o processo de deleção do AWS CLI no Ubuntu, siga os passos abaixo:

Deleção do AWS CLI do seu terminal

Localize os symlinks abaixo:

which aws
which aws_completer
Enter fullscreen mode Exit fullscreen mode

Você terá uma saída como a mostrada abaixo:

Remova os dois symlinks:

sudo rm /usr/local/bin/aws
sudo rm /usr/local/bin/aws_completer
Enter fullscreen mode Exit fullscreen mode

Encontre o diretório de instalação do aws-cli. Observe que ao executar os comandos abaixo, o diretório de instalação do aws-cli está no mesmo caminho tanto para o aws quanto para o aws_completer: /usr/local/aws-cli/…

ls -l /usr/local/bin/aws
ls -l /usr/local/bin/aws_completer
Enter fullscreen mode Exit fullscreen mode

O resultado é:

Removendo o diretório /usr/local/aws-cli/ você já removerá todos os arquivo e diretórios subsequentes:

sudo rm -rf /usr/local/aws-cli
Enter fullscreen mode Exit fullscreen mode

Opcional: Delete os arquivos de configuração do aws-cli. Os arquivos nesse diretório armazenam as configurações de credenciais usadas no seu terminal

sudo rm -rf ~/.aws/
Enter fullscreen mode Exit fullscreen mode

Execute o comando abaixo para verificar se o aws-cli foi removido com sucesso:

aws --version
Enter fullscreen mode Exit fullscreen mode

Se a saída for que o comando não é reconhecido, o aws-cli foi desinstalado corretamente. Agora é só seguir os passos de instalação para instalá-lo novamente!

Para manusear corretamente a(s) sua(s) conta(s) na AWS, você precisará agora configurar corretamente as suas credenciais programáticas e a melhor forma de fazer isso é através dos perfis de CLI. Para entender mais sobre esse assunto, veja esse meu artigo:

Links uteis:

Image of Datadog

The Essential Toolkit for Front-end Developers

Take a user-centric approach to front-end monitoring that evolves alongside increasingly complex frameworks and single-page applications.

Get The Kit

Top comments (0)

Best Practices for Running  Container WordPress on AWS (ECS, EFS, RDS, ELB) using CDK cover image

Best Practices for Running Container WordPress on AWS (ECS, EFS, RDS, ELB) using CDK

This post discusses the process of migrating a growing WordPress eShop business to AWS using AWS CDK for an easily scalable, high availability architecture. The detailed structure encompasses several pillars: Compute, Storage, Database, Cache, CDN, DNS, Security, and Backup.

Read full post

👋 Kindness is contagious

Please leave a ❤️ or a friendly comment on this post if you found it helpful!

Okay