Installation, mise à jour et désinstallation de l’AWS CLI version 1 sous Linux - AWS Command Line Interface

Cette documentation concerne uniquement la version 1 de l’AWS CLI. Pour la documentation relative à la version 2 de l’AWS CLI, consultez le Guide de l’utilisateur de la version 2.

Installation, mise à jour et désinstallation de l’AWS CLI version 1 sous Linux

Vous pouvez installer l’AWS Command Line Interface (AWS CLI) version 1 et ses dépendances sur la plupart des distributions Linux en utilisant le gestionnaire de package pip ou le programme d’installation fourni.

Bien que le package awscli soit disponible dans les référentiels pour d’autres gestionnaires de package tels que apt et yum, ceux-ci ne sont pas produits, gérés ou pris en charge par AWS. Nous vous recommandons d’installer uniquement l’AWS CLI à partir des points de distribution AWS officiels, comme indiqué dans ce guide.

Prérequis

Vous devez également installer Python 3.8 ou version ultérieure. Pour obtenir des instructions sur l’installation, consultez la page Téléchargement de Python dans le Guide du débutant de Python.

Matrice de prise en charge des versions Python

Version de l’AWS CLI Version de Python prise en charge
1.39.0 – Version actuelle Python 3.9+
1.32.0 – 1.38.38 Python 3.8+
1.27.0 – 1.31.x Python 3.7+
1.20.0 – 1.26.x Python 3.6+
1.19.0 – 1.19.x Python 2.7+, Python 3.6+
1.17 – 1.18.x Python 2.7+, Python 3.4+
1.0 – 1.16.x Python 2.6 et versions antérieures, Python 3.3 et versions antérieures

Installation et désinstallation de l’AWS CLI version 1 sous Linux à l’aide du programme d’installation fourni

Sous Linux ou macOS, vous pouvez utiliser le programme d’installation fourni pour installer la version 1 de l’AWS CLI. Le programme d’installation fourni inclut toutes les dépendances et peut être utilisé hors connexion.

Note

Le programme d’installation fourni ne prend pas en charge l’installation dans des chemins contenant des espaces.

Installation de l’AWS CLI version 1 à l’aide du programme d’installation fourni avec sudo

Les étapes ci-dessous vous permettent d’installer l’AWS CLI version 1 à partir de la ligne de commande sur n’importe quelle build de Linux ou macOS.

Voici un résumé des commandes d’installation présentées ci-après que vous pouvez couper et coller pour les exécuter sous la forme d’un ensemble unique de commandes.

Pour obtenir la dernière version de l’AWS CLI, utilisez le bloc de commande suivant :

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

Pour une version spécifique de l’AWS CLI, ajoutez un tiret et le numéro de version au nom de fichier. Dans cet exemple, le nom de fichier pour la version 1.16.312 serait awscli-bundle-1.16.312.zip, ce qui entraînerait la commande suivante :

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

Exécutez les étapes suivantes à partir de la ligne de commande pour installer l’AWS CLI version 1 à l’aide du programme d’installation fourni.

Pour installer l’AWS CLI version 1 à l’aide du programme d’installation fourni
  1. Téléchargez le programme d’installation fourni pour l’AWS CLI version 1 à l’aide de l’une des méthodes suivantes.

    • Procédez au téléchargement à l’aide de la commande curl.

      Pour obtenir la dernière version de l’AWS CLI, utilisez le bloc de commande suivant :

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"

      Pour une version spécifique de l’AWS CLI, ajoutez un tiret et le numéro de version au nom de fichier. Dans cet exemple, le nom de fichier pour la version 1.16.312 serait awscli-bundle-1.16.312.zip, ce qui entraînerait la commande suivante :

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
    • Procédez au téléchargement à l’aide du lien direct.

      Pour la version la plus récente de l’AWS CLI : https://s3.amazonaws.com/aws-cli/awscli-bundle.zip

      Pour une version spécifique de l’AWS CLI, ajoutez un tiret et le numéro de version au nom de fichier. Dans cet exemple, le nom de fichier pour la version 1.16.312 serait awscli-bundle-1.16.312.zip, ce qui entraînerait l’URL suivante : https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip.

  2. Extrayez les fichiers du package. Si vous ne disposez pas de unzip pour extraire les fichiers, utilisez le gestionnaire de package intégré de votre distribution Linux pour l’installer.

    $ unzip awscli-bundle.zip
  3. Exécutez le programme d’installation. Le programme d’installation installe l’AWS CLI sous /usr/local/aws et crée le lien symbolique aws dans le répertoire /usr/local/bin. L’utilisation de l’option -b pour créer un lien symbolique évite d’avoir à spécifier le répertoire d’installation dans la variable utilisateur $PATH. Cela doit permettre à tous les utilisateurs d’appeler l’AWS CLI en entrant aws depuis n’importe quel répertoire.

    $ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

    Par défaut, le script d’installation s’exécute sous la version système par défaut de Python. Si vous avez installé une autre version de Python et souhaitez utiliser celle-ci pour installer l’AWS CLI, exécutez le script d’installation avec cette version dans le chemin d’accès absolu au fichier exécutable Python, comme suit.

    $ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
  4. Vérifiez que l’AWS CLI est installée correctement.

    $ aws --version aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    Si vous obtenez une erreur, consultez Résolution des erreurs liées à l’AWS CLI.

Installation de l’AWS CLI version 1 à l’aide du programme d’installation fourni sans sudo

Si vous ne disposez pas d’autorisations sudo ou si vous voulez installer l’AWS CLI uniquement pour l’utilisateur en cours, vous pouvez utiliser une version modifiée des commandes précédentes. Les deux premières commandes sont les mêmes.

Pour obtenir la dernière version de l’AWS CLI, utilisez le bloc de commande suivant :

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws

Pour une version spécifique de l’AWS CLI, ajoutez un tiret et le numéro de version au nom de fichier. Dans cet exemple, le nom de fichier pour la version 1.16.312 serait awscli-bundle-1.16.312.zip, ce qui entraînerait la commande suivante :

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws
Pour installer l’AWS CLI version 1 pour l’utilisateur actuel
  1. Téléchargez le programme d’installation fourni pour l’AWS CLI version 1 de l’une des manières suivantes.

    • Procédez au téléchargement à l’aide de la commande curl.

      Pour obtenir la dernière version de l’AWS CLI, utilisez le bloc de commande suivant :

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"

      Pour une version spécifique de l’AWS CLI, ajoutez un tiret et le numéro de version au nom de fichier. Dans cet exemple, le nom de fichier pour la version 1.16.312 serait awscli-bundle-1.16.312.zip, ce qui entraînerait la commande suivante :

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
    • Procédez au téléchargement à l’aide du lien direct.

      Pour la version la plus récente de l’AWS CLI : https://s3.amazonaws.com/aws-cli/awscli-bundle.zip

      Pour une version spécifique de l’AWS CLI, ajoutez un tiret et le numéro de version au nom de fichier. Dans cet exemple, le nom de fichier pour la version 1.16.312 serait awscli-bundle-1.16.312.zip, ce qui entraînerait l’URL suivante : https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip.

  2. Extrayez les fichiers du package en utilisant unzip. Si vous n’avez pas unzip, utilisez le gestionnaire de package intégré de votre distribution Linux pour l’installer.

    $ unzip awscli-bundle.zip
  3. Exécutez le programme d’installation. Le programme d’installation installe l’AWS CLI sous /usr/local/aws et crée le lien symbolique aws dans le répertoire /usr/local/bin. La commande utilise le paramètre -b pour spécifier le répertoire dans lequel le programme d’installation place le fichier de lien symbolique aws. Vous devez disposer d’autorisations d’écriture sur le dossier spécifié.

    $ ./awscli-bundle/install -b ~/bin/aws

    Cette opération installe l’AWS CLI dans l’emplacement par défaut (~/.local/lib/aws) et crée un lien symbolique (symlink) dans ~/bin/aws. Assurez-vous que ~/bin figure dans votre variable d’environnement PATH pour que le lien symbolique fonctionne.

    $ echo $PATH | grep ~/bin // See if $PATH contains ~/bin (output will be empty if it doesn't) $ export PATH=~/bin:$PATH // Add ~/bin to $PATH if necessary
  4. Assurez-vous que le répertoire de l’AWS CLI version 1 fait partie de votre variable PATH.

    1. Recherchez le script de profil de votre shell dans votre dossier utilisateur. Si vous n’êtes pas certain du shell utilisé, exécutez echo $SHELL.

      $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
      • Bash : .bash_profile, .profile ou .bash_login

      • Zsh : .zshrc

      • Tcsh : .tcshrc, .cshrc ou .login

    2. Ajoutez une commande d’exportation à la fin de votre script de profil similaire à l’exemple suivant.

      export PATH=~/.local/bin:$PATH

      Cette commande ajoute le chemin d’accès, ~/.local/bin dans cet exemple, devant la variable PATH actuelle.

    3. Rechargez le profil dans la session en cours pour appliquer ces modifications.

      $ source ~/.bash_profile
  5. Vérifiez que l’AWS CLI est installée correctement.

    $ aws --version aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    Si vous obtenez une erreur, consultez Résolution des erreurs liées à l’AWS CLI.

Désinstallation du programme d’installation fourni pour l’AWS CLI version 1

  1. Si vous avez installé l’AWS CLI à l’aide du programme d’installation fourni, suivez ces instructions. Le programme d’installation fourni ne place rien en dehors du répertoire d’installation, à l’exception du lien symbolique facultatif, de sorte que la désinstallation est aussi simple que la suppression de ces deux éléments.

    $ sudo rm -rf /usr/local/aws $ sudo rm -rf /usr/local/bin/aws
  2. (Facultatif) Supprimez le kit AWS SDK partagé et les informations des paramètres de l’AWS CLI du dossier .aws.

    Avertissement

    Ces paramètres de configuration et d’informations d’identification sont partagés entre tous les kit AWS SDK et l’AWS CLI. Si vous supprimez ce dossier, aucun kit AWS SDK présent dans votre système ne pourra y accéder.

    L’emplacement par défaut du dossier .aws varie selon les plateformes. Par défaut, le dossier se trouve dans ~/.aws/. Si votre compte utilisateur dispose des autorisations en écriture sur ce répertoire, il n’est pas nécessaire d’utiliser sudo.

    $ sudo rm -r ~/.aws/

Installation et désinstallation de l’AWS CLI version 1 à l’aide de pip

Installation de pip

Si vous n’avez pas encore installé pip, installez-le avec le script fourni par Python Packaging Authority. Exécutez pip --version pour savoir si votre version de Linux comprend déjà Python et pip. Si Python version 3 ou ultérieure est installé, nous vous recommandons d’utiliser la commande pip3.

  1. Utilisez la commande curl pour télécharger le script d’installation. La commande suivante utilise le paramètre -O (lettre majuscule O) pour spécifier que le fichier téléchargé doit être stocké dans le répertoire actuel en utilisant le même nom que celui utilisé sur l’hôte distant.

    $ curl -O https://bootstrap.pypa.io/get-pip.py
  2. Exécutez le script avec la commande python ou python3 pour télécharger et installer la version la plus récente de pip et des autres packages de prise en charge requis. Lorsque vous incluez le commutateur --user, le script pip s’installe dans le chemin d’accès ~/.local/bin.

    $ python3 get-pip.py --user
  3. Vérifiez que le répertoire qui contient pip fait partie de votre variable PATH.

    1. Recherchez le script de profil de votre shell dans votre dossier utilisateur. Si vous n’êtes pas certain du shell utilisé, exécutez echo $SHELL.

      $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
      • Bash : .bash_profile, .profile ou .bash_login

      • Zsh : .zshrc

      • Tcsh : .tcshrc, .cshrc ou .login

    2. Ajoutez une commande d’exportation à la fin de votre script de profil similaire à l’exemple suivant.

      export PATH=~/.local/bin:$PATH

      Cette commande ajoute le chemin d’accès, ~/.local/bin dans cet exemple, devant la variable PATH actuelle.

    3. Rechargez le profil dans la session en cours pour appliquer ces modifications.

      $ source ~/.bash_profile
  4. Pour vérifier que pip ou pip3 est installé correctement, exécutez la commande suivante.

    $ pip3 --version pip 24.0 from ~/.local/lib/python3.7/site-packages (python 3.7)

Installation et mise à jour de l’AWS CLI version 1 à l’aide de pip

  1. Utilisez la commande pip ou pip3 pour installer ou mettre à jour l’AWS CLI. Si Python version 3 ou ultérieure est installé, nous vous recommandons d’utiliser la commande pip3. Le commutateur --user, pip installe l’AWS CLI sur ~/.local/bin.

    Pour obtenir la dernière version de l’AWS CLI, utilisez le bloc de commande suivant :

    $ pip3 install awscli --upgrade --user

    Pour une version spécifique de l’AWS CLI, ajoutez deux signes égal = et le numéro de version au nom de fichier. Dans cet exemple, le nom de fichier pour la version 1.16.312 serait ==1.16.312, ce qui entraînerait la commande suivante :

    $ pip3 install awscli==1.16.312 --upgrade --user
    Note

    Utilisez des règles de devis adaptées à votre terminal. Pour utiliser le caractère =, vous devrez peut-être utiliser des guillemets simples ou doubles pour vous échapper correctement. L’exemple suivant s’échappe à l’aide de guillemets simples :

    $ pip3 install 'awscli==1.16.312' --upgrade --user
  2. Vérifiez que l’AWS CLI est installée correctement.

    $ aws --version aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    Si vous obtenez une erreur, consultez Résolution des erreurs liées à l’AWS CLI.

Désinstallation de l’AWS CLI à l’aide de pip

  1. Si vous avez installé l’AWS CLI version 1 à l’aide de pip, vous devez également la désinstaller à l’aide de pip.

    $ pip uninstall awscli

    Si vous utilisez la version Python 2 ou 3, vous devrez peut-être utiliser la commande pip2 ou pip3. Utilisez la commande aws --version pour déterminer la version de Python associée à votre AWS CLI version 1 installée.

    $ pip3 uninstall awscli

    Vous devrez peut-être redémarrer votre fenêtre d’invite de commandes ou votre ordinateur pour supprimer tous les fichiers.

  2. (Facultatif) Supprimez le kit AWS SDK partagé et les informations des paramètres de l’AWS CLI du dossier .aws.

    Avertissement

    Ces paramètres de configuration et d’informations d’identification sont partagés entre tous les kit AWS SDK et l’AWS CLI. Si vous supprimez ce dossier, aucun kit AWS SDK présent dans votre système ne pourra y accéder.

    L’emplacement par défaut du dossier .aws varie selon les plateformes. Par défaut, le dossier se trouve dans ~/.aws/. Si votre compte utilisateur dispose des autorisations en écriture sur ce répertoire, il n’est pas nécessaire d’utiliser sudo.

    $ sudo rm -r ~/.aws/

Installation et désinstallation de l’AWS CLI version 1 à l’aide de Snapcraft

Installation de snap

Si vous n’avez pas encore installé snap, vous pouvez l’installer en suivant les instructions fournies par Canonical Snapcraft. Exécutez snap version pour savoir si votre version de Linux comprend déjà snap.

  1. Installez Snapcraft sur votre plateforme. Pour en savoir plus sur l’installation de Snapcraft, consultez Installation du démon dans la documentation Snap.

  2. Redémarrez votre système afin que vos variables PATH soient correctement mises à jour. Si vous rencontrez des problèmes d’installation, suivez les étapes décrites sur la page Fix common issues de la documentation Snap.

  3. Pour vérifier que snap est installé correctement, exécutez la commande suivante.

    $ snap version

Installation et mise à jour de l’AWS CLI version 1 à l’aide de snap

  1. Exécutez la commande snap install suivante pour l’AWS CLI version 1.

    $ snap install aws-cli --channel=v1/stable --classic

    En fonction de vos autorisations, vous pouvez avoir besoin d’ajouter sudo à votre commande.

    $ sudo snap install aws-cli --channel=v1/stable --classic
  2. Vérifiez que l’AWS CLI est installée correctement.

    $ aws --version aws-cli/1.40.41 Python/3.11.6 Linux/5.10.205-195.807.amzn2.x86_64 botocore/1.18.6

    Si vous obtenez une erreur, consultez Résolution des erreurs liées à l’AWS CLI.

Désinstallation de l’AWS CLI à l’aide de snap

  1. Si vous avez installé l’AWS CLI version 1 à l’aide de snap, vous devez également la désinstaller à l’aide de snap.

    $ snap remove aws-cli

    Vous devrez peut-être redémarrer votre fenêtre d’invite de commandes ou votre ordinateur pour supprimer tous les fichiers.

  2. (Facultatif) Supprimez le kit AWS SDK partagé et les informations des paramètres de l’AWS CLI du dossier .aws.

    Avertissement

    Ces paramètres de configuration et d’informations d’identification sont partagés entre tous les kit AWS SDK et l’AWS CLI. Si vous supprimez ce dossier, aucun kit AWS SDK présent dans votre système ne pourra y accéder.

    L’emplacement par défaut du dossier .aws varie selon les plateformes. Par défaut, le dossier se trouve dans ~/.aws/. Si vous disposez des autorisations en écriture sur ce répertoire, vous n’avez pas besoin d’utiliser sudo.

    $ sudo rm -r ~/.aws/

Ajout du fichier exécutable de l’AWS CLI version 1 à votre chemin de ligne de commande

Après avoir effectué l’installation à l’aide de pip ou snap, vous devrez peut-être ajouter le fichier exécutable aws à la variable d’environnement PATH de votre système d’exploitation.

Vous pouvez vérifier quel dossier pip a installé l’AWS CLI en exécutant la commande suivante.

$ which aws /home/username/.local/bin/aws

Vous pouvez référencer ceci comme ~/.local/bin/ car /home/username correspond à ~ dans Linux.

Si vous avez omis le commutateur --user et que vous ne l’avez donc pas installé en mode utilisateur, l’exécutable peut se situer dans le dossier bin de votre installation Python. Si vous ne savez pas où est installé Python, exécutez cette commande.

$ which python /usr/local/bin/python

La sortie peut être le chemin d’accès vers un lien symbolique, et non le fichier exécutable. Exécutez ls -al pour voir vers où il pointe.

$ ls -al /usr/local/bin/python /usr/local/bin/python -> ~/.local/Python/3.6/bin/python3.6

pip installe les programmes dans le dossier qui contient l’application Python. Ajoutez ce dossier à votre variable PATH.

Pour modifier votre variable PATH
  1. Recherchez le script de profil de votre shell dans votre répertoire utilisateur. Si vous n’êtes pas certain du shell utilisé, exécutez echo $SHELL.

    $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
    • Bash.bash_profile, .profile ou .bash_login

    • Zsh.zshrc

    • Tcsh.tcshrc, .cshrc ou .login

  2. Ajoutez une commande d’exportation à votre script de profil.

    export PATH=~/.local/bin:$PATH

    Cette commande ajoute un chemin d’accès, ~/.local/bin dans cet exemple, à la variable PATH actuelle.

  3. Chargez le profil mis à jour dans votre session en cours.

    $ source ~/.bash_profile

Résolution des erreurs d’installation et de désinstallation de l’AWS CLI

Si vous rencontrez des problèmes après l’installation ou la désinstallation de l’AWS CLI, consultez Résolution des erreurs liées à l’AWS CLI pour connaître les étapes de résolution de problèmes. Pour connaître les étapes de résolution de problèmes les plus pertinentes, consultez Erreurs de type Commande introuvable, La commande « aws --version » renvoie une version différente de celle que vous avez installée et La commande « aws --version » renvoie une version après la désinstallation de l’AWS CLI.