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

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 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. Procédez à l’extraction (décompression) des fichiers du package. Si vous ne disposez pas de unzip, utilisez le gestionnaire de package intégré de votre distribution macOS 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 dossier /usr/local/bin. L’utilisation de l’option -b pour créer un lien symbolique évite d’avoir à spécifier le dossier d’installation dans la variable $PATH de l’utilisateur. 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 l’utiliser 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 au AWS CLI.

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 à 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 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 des autorisations en écriture sur le répertoire 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 dossier dans lequel l’AWS CLI version 1 est installée 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 au AWS CLI.

1. Le programme d’installation fourni place tous les éléments dans le répertoire d’installation, à l’exception du lien symbolique facultatif. Pour procéder à la désinstallation, il vous suffit de supprimer ces deux éléments

   $ sudo rm -rf /usr/local/aws
   $ sudo rm /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 ~/.aws/

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

1. Utilisez la commande pip ou pip3 pour installer l’AWS CLI. Si Python version 3 ou ultérieure est installé, nous vous recommandons d’utiliser la commande pip3.

   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 Darwin/23.3.0 botocore/1.18.6

   Si le programme est introuvable, ajoutez-le à votre chemin de ligne de commande.

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

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 -rf ~/.aws/