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

Cette documentation concerne AWS CLI uniquement la version 1 du.

Nous avons annoncé la sortie end-of-support de la AWS CLI version 1. Nous vous recommandons de migrer vers la AWS CLI version 2. Pour les dates, les détails supplémentaires et les informations sur la façon de migrer, consultez l'annonce. Pour la documentation relative à la version 2 du AWS CLI, consultez le guide de l'utilisateur de la version 2.

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

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

Vous pouvez installer la version 1 AWS Command Line Interface (AWS CLI) et ses dépendances sur la plupart des distributions Linux à l'aide du gestionnaire de pip packages ou du programme d'installation fourni.

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

Conditions préalables

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

AWS CLI version 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

Installez et désinstallez la 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.

Installez la AWS CLI version 1 à l'aide du programme d'installation fourni avec sudo

Les étapes suivantes vous permettent d'installer la AWS CLI version 1 à partir de la ligne de commande sur n'importe quelle version de Linux ou de 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 la dernière version de 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 AWS CLI, ajoutez un tiret et le numéro de version au nom du fichier. Dans cet exemple, le nom de fichier de la version 1.16.312 entraînerait la commande suivante : awscli-bundle-1.16.312.zip

$ 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

Suivez ces étapes depuis la ligne de commande pour installer la AWS CLI version 1 à l'aide du programme d'installation fourni.

Pour installer la AWS CLI version 1 à l'aide du programme d'installation fourni
  1. Téléchargez le programme d'installation intégré de la AWS CLI version 1 en utilisant l'une des méthodes suivantes.

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

      Pour la dernière version de 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 AWS CLI, ajoutez un tiret et le numéro de version au nom du fichier. Dans cet exemple, le nom de fichier de la version 1.16.312 entraînerait la commande suivante : awscli-bundle-1.16.312.zip

      $ 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 AWS CLI, ajoutez un tiret et le numéro de version au nom du fichier. Dans cet exemple, le nom de fichier de la version 1.16.312 awscli-bundle-1.16.312.zip donnerait 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 le fichier AWS CLI at /usr/local/aws et crée le lien symbolique aws dans le /usr/local/bin répertoire. 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 devrait permettre à tous les utilisateurs d'appeler le 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 version alternative de Python et que vous souhaitez utiliser cette version pour l'installer AWS CLI, exécutez le script d'installation avec cette version par le chemin absolu vers l'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 qu'ils AWS CLI sont correctement installés.

    $ 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 au AWS CLI.

Installez la AWS CLI version 1 à l'aide du programme d'installation fourni sans sudo

Si vous n'avez pas d'sudoautorisations ou si vous souhaitez installer la commande AWS CLI uniquement pour l'utilisateur actuel, vous pouvez utiliser une version modifiée des commandes précédentes. Les deux premières commandes sont les mêmes.

Pour la dernière version de 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 AWS CLI, ajoutez un tiret et le numéro de version au nom du fichier. Dans cet exemple, le nom de fichier de la version 1.16.312 entraînerait la commande suivante : awscli-bundle-1.16.312.zip

$ 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 la AWS CLI version 1 pour l'utilisateur actuel
  1. Téléchargez le programme d'installation intégré de la AWS CLI version 1 de l'une des manières suivantes.

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

      Pour la dernière version de 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 AWS CLI, ajoutez un tiret et le numéro de version au nom du fichier. Dans cet exemple, le nom de fichier de la version 1.16.312 entraînerait la commande suivante : awscli-bundle-1.16.312.zip

      $ 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 AWS CLI, ajoutez un tiret et le numéro de version au nom du fichier. Dans cet exemple, le nom de fichier de la version 1.16.312 donnerait awscli-bundle-1.16.312.zip 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 le fichier AWS CLI at /usr/local/aws et crée le lien symbolique aws dans le /usr/local/bin répertoire. 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

    Cela installe le AWS CLI à l'emplacement par défaut (~/.local/lib/aws) et crée un lien symbolique (lien symbolique) à. ~/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. Vérifiez le répertoire dans lequel la AWS CLI version 1 fait partie de votre PATH variable.

    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 qu'ils AWS CLI sont correctement installés.

    $ 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 au AWS CLI.

Désinstallez le programme d'installation intégré de la AWS CLI version 1

  1. Si vous l'avez installé 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 AWS SDK partagé et AWS CLI les informations de paramètres dans le .aws dossier.

    Avertissement

    Ces paramètres de configuration et d'identification sont partagés entre tous AWS SDKs les AWS CLI. Si vous supprimez ce dossier, il ne sera plus accessible aux AWS SDKs personnes encore présentes sur votre système.

    L'emplacement par défaut du .aws dossier 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/

Installez et désinstallez la AWS CLI version 1 à l'aide de pip

Installation de pip

Si vous n’avez pas encore installé pip, faites-le en utilisant 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)

Installez et mettez à jour la 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 --user commutateur pip installe le dessus AWS CLI . ~/.local/bin

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

    $ pip3 install awscli --upgrade --user

    Pour une version spécifique de AWS CLI, ajoutez deux signes égaux = et le numéro de version au nom du fichier. Dans cet exemple, le nom de fichier de la version 1.16.312 entraînerait la commande suivante : ==1.16.312

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

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

    $ pip3 install 'awscli==1.16.312' --upgrade --user
  2. Vérifiez qu'ils AWS CLI sont correctement installés.

    $ 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 au AWS CLI.

Désinstallez le pip AWS CLI à l'aide

  1. Si vous avez installé la AWS CLI version 1 à l'aide depip, vous devez également la désinstaller à l'aide depip.

    $ pip uninstall awscli

    Si vous utilisez la version Python 2 ou 3, vous devrez peut-être utiliser la commande pip2 ou pip3. Utilisez la aws --version commande 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 AWS SDK partagé et AWS CLI les informations de paramètres dans le .aws dossier.

    Avertissement

    Ces paramètres de configuration et d'identification sont partagés entre tous AWS SDKs les AWS CLI. Si vous supprimez ce dossier, il ne sera plus accessible aux AWS SDKs personnes encore présentes sur votre système.

    L'emplacement par défaut du .aws dossier 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/

Installez et désinstallez la AWS CLI version 1 à l'aide de Snapcraft

Installation de snap

Si vous n’avez pas encore installé snap, suivez 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

Installez et mettez à jour la AWS CLI version 1 à l'aide de Snap

  1. Exécutez la snap install commande suivante pour la 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 qu'ils AWS CLI sont correctement installés.

    $ 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 au AWS CLI.

Désinstallez le Snap AWS CLI à l'aide de

  1. Si vous avez installé la AWS CLI version 1 à l'aide desnap, vous devez également la désinstaller à l'aide desnap.

    $ 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 AWS SDK partagé et AWS CLI les informations de paramètres dans le .aws dossier.

    Avertissement

    Ces paramètres de configuration et d'identification sont partagés entre tous AWS SDKs les AWS CLI. Si vous supprimez ce dossier, il ne sera plus accessible aux AWS SDKs personnes encore présentes sur votre système.

    L'emplacement par défaut du .aws dossier 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/

Ajoutez l'exécutable de la AWS CLI version 1 au chemin de votre 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 dans quel dossier l'a pip installé 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 AWS CLI d'installation et de désinstallation

Si vous rencontrez des problèmes après l'installation ou la désinstallation du AWS CLI, consultez les étapes de résolution Résolution des erreurs liées au AWS CLI des 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 avoir désinstallé le AWS CLI.