AWS CLIinstructions d'installation et de mise à jour Résolution des problèmesAWS CLIerreurs d'installation et de désinstallation Étapes suivantes

Installez ou mettez à jour la dernière version duAWS CLI

Cette rubrique décrit comment installer ou mettre à jour la dernière version duAWS Command Line Interface(AWS CLI) sur les systèmes d'exploitation pris en charge. Pour plus d'informations sur les dernières versions deAWS CLI, consultez leAWS CLIversion 2 ChangelogsurGitHub.

Pour installer une version antérieure duAWS CLI, voirInstaller les versions précédentes de la AWS CLI version 2. Pour les instructions de désinstallation, voirDésinstallez la AWS CLI version 2.

Important

Les versions 1 et 2 de l'AWS CLI utilisent le même nom de commande aws. Si vous avez déjà installéAWS CLIversion 1, voirMigrer de AWS CLI la version 1 vers la version 2.

Rubriques

AWS CLIinstructions d'installation et de mise à jour
Résolution des problèmesAWS CLIerreurs d'installation et de désinstallation
Étapes suivantes

AWS CLIinstructions d'installation et de mise à jour

Pour les instructions d'installation, développez la section correspondant à votre système d'exploitation.

Exigences d'installation et de mise à jour

Vous devez être en mesure d'extraire ou de « décompresser » le package téléchargé. Si votre système d'exploitation ne dispose pas de la commande unzip intégrée, utilisez un équivalent.
L’AWS CLI utilise glibc, groff et less. Ceux-ci sont inclus par défaut dans la plupart des distributions majeures de Linux.
Nous soutenons leAWS CLIsur les versions 64 bits des distributions récentes de CentOS, Fedora, Ubuntu, Amazon Linux 1, Amazon Linux 2 et Linux ARM.
AWS ne gérant pas les référentiels tiers, nous ne pouvons pas garantir qu'ils contiennent la dernière version de l’AWS CLI.

Installez ou mettez à jour leAWS CLI

Note

Si c'est la première fois que vous effectuez une mise à jour sur Amazon Linux, pour installer la dernière version duAWS CLI, vous devez désinstaller le préinstalléyumversion à l'aide de la commande suivante :


$ sudo yum remove awscli

Après leyuminstallation duAWS CLIest supprimé, suivez les instructions d'installation de Linux ci-dessous.

Pour mettre à jour votre installation actuelle deAWS CLI, téléchargez un nouveau programme d'installation à chaque mise à jour pour remplacer les versions précédentes. Procédez comme suit à partir de la ligne de commande pour installer l'AWS CLI sur Linux.

Nous fournissons les étapes dans un groupe facile à copier et coller selon que vous utilisez Linux 64 bits ou Linux ARM. Consultez les descriptions de chaque ligne dans les étapes suivantes.

Note

Pour mettre à jour votre installation actuelle duAWS CLI, ajoutez votre lien symbolique existant et les informations relatives au programme d'installation pour créer leinstallcommande avec--updateparamètre.


$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update

Téléchargez le fichier d'installation en utilisant une des manières suivantes :
Linux x86 (64-bit)
Utilisez lecurlcommande— Le-ooption indique le nom de fichier dans lequel le package téléchargé est écrit. Les options de l'exemple de commande suivant permettent de copier le fichier téléchargé dans le répertoire courant avec le nom local awscliv2.zip

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip" -o "awscliv2.zip"

Téléchargement depuis l'URL— Pour télécharger le programme d'installation avec votre navigateur, utilisez l'URL suivante :https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip
Linux ARM
Utilisez lecurlcommande— Le-ooption indique le nom de fichier dans lequel le package téléchargé est écrit. Les options de l'exemple de commande suivant permettent de copier le fichier téléchargé dans le répertoire courant avec le nom local awscliv2.zip

$ curl "https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip" -o "awscliv2.zip"

Téléchargement depuis l'URL— Pour télécharger le programme d'installation avec votre navigateur, utilisez l'URL suivante :https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip

(Facultatif) Vérification de l'intégrité du fichier zip que vous avez téléchargé

Si vous avez choisi de télécharger manuellement leAWS CLIpackage d'installation.zipdans les étapes ci-dessus, vous pouvez utiliser les étapes suivantes pour vérifier les signatures à l'aide duGnuPGoutil.

Les fichiers du package d'installation .zip de l'AWS CLI sont signés de manière chiffrée à l'aide de signatures PGP. En cas de dommage ou d'altération des fichiers, cette vérification échoue et vous ne devez pas poursuivre l'installation.

Téléchargez et installez la commande gpg à l'aide de votre gestionnaire de packages. Pour de plus amples informations sur GnuPG, veuillez consulter le site Web GnuPG.

Pour créer le fichier de clé publique, créez un fichier texte et collez le texte suivant.

Pour référence, les détails de la clé publique sont les suivants.


Key ID:           A6310ACC4672
Type:             RSA
Size:             4096/4096
Created:          2019-09-18
Expires:          2024-07-26
User ID:          AWS CLI Team <aws-cli@amazon.com>
Key fingerprint:  FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

Importez leAWS CLIclé publique avec la commande suivante, en remplaçantpublic-key-file-nameavec le nom de fichier de la clé publique que vous avez créée.


$ 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

Téléchargez le fichier de signature de l'AWS CLI du package que vous avez téléchargé. Celui-ci a le même chemin d'accès et le même nom que le fichier .zip auquel il correspond, mais son extension est .sig. Dans les exemples suivants, nous l'enregistrons dans le répertoire courant sous la forme d'un fichier nommé awscliv2.sig.
Linux x86 (64-bit)
Pour accéder à la dernière version duAWS CLI,utilisez le bloc de commande suivant :
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64.zip.sig
```
Pour une version spécifique duAWS CLI,ajoutez un tiret et le numéro de version au nom du fichier. Pour cet exemple, le nom de fichier de la version2,0,30seraitawscli-exe-linux-x86_64-2.0.30.zip.sigaboutissant à la commande suivante :
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-x86_64-2.0.30.zip.sig
```
Pour obtenir la liste des versions, consultez leAWS CLIversion 2 ChangelogsurGitHub.
Linux ARM
Pour accéder à la dernière version duAWS CLI,utilisez le bloc de commande suivant :
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64.zip.sig
```
Pour une version spécifique duAWS CLI,ajoutez un tiret et le numéro de version au nom du fichier. Pour cet exemple, le nom de fichier de la version2,0,30seraitawscli-exe-linux-aarch64-2.0.30.zip.sigaboutissant à la commande suivante :
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli-exe-linux-aarch64-2.0.30.zip.sig
```
Pour obtenir la liste des versions, consultez leAWS CLIversion 2 ChangelogsurGitHub.
Vérifiez la signature en transmettant les noms de fichiers .sig et .zip téléchargés sous forme de paramètres à la commande gpg.
```
$ gpg --verify awscliv2.sig awscliv2.zip
```
La sortie doit ressembler à ce qui suit :
```
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
```
Important
L'avertissement mentionné dans la sortie est attendu et n'indique pas de problème. Cet avertissement est dû au fait qu'il n'y a pas de chaîne de confiance entre votre clé PGP personnelle (si vous en avez une) et la clé PGP de l'AWS CLI. Pour de plus amples informations, consultez Web of trust.

Afficher plus

Afficher moins

Décompressez le programme d'installation. Si votre distribution Linux n'a pas de commande unzip intégrée, utilisez un équivalent pour procéder à la décompression. L'exemple de commande suivant décompresse le package et crée un répertoire nommé aws dans le répertoire courant.
```
$ unzip awscliv2.zip
```
Note
Lors de la mise à jour à partir d'une version précédente, leunzipinvite à remplacer les fichiers existants. Pour ignorer ces instructions, par exemple pour l'automatisation des scripts, utilisez-uindicateur de mise à jour pourunzip. Cet indicateur met automatiquement à jour les fichiers existants et en crée de nouveaux selon les besoins.
```
$ unzip -u awscliv2.zip
```
Exécutez le programme d'installation. La commande d'installation utilise un fichier nommé install dans le répertoire aws récemment décompressé. Par défaut, les fichiers sont tous installés dans /usr/local/aws-cli et un lien symbolique est créé dans /usr/local/bin. La commande inclut sudo pour accorder des autorisations d'écriture sur ces répertoires.
```
$ sudo ./aws/install
```
Vous pouvez effectuer l'installation sans sudo si vous spécifiez des répertoires sur lesquels vous disposez déjà d'autorisations en écriture. Utilisez les instructions suivantes pour la commande install de manière à spécifier l'emplacement d'installation :
- Assurez-vous que les chemins d'accès que vous fournissez aux paramètres -i et -b ne contiennent aucun nom de volume ou de répertoire incluant des espaces quelconques. Dans le cas contraire, l'installation échouera.
- --install-dirou-i— Cette option indique le répertoire dans lequel copier tous les fichiers.
  
  La valeur par défaut est /usr/local/aws-cli.
- --bin-dirou-b— Cette option indique que le principalawsle programme du répertoire d'installation est symboliquement lié au fichierawsdans le chemin spécifié. Vous devez disposer des autorisations en écriture sur le répertoire spécifié. La création d'un lien symbolique vers un répertoire se trouvant déjà dans votre chemin d'accès vous dispense d'ajouter le répertoire d'installation à la variable $PATH de l'utilisateur.
  
  La valeur par défaut est /usr/local/bin.
```
$ ./aws/install -i /usr/local/aws-cli -b /usr/local/bin
```
Note
Pour mettre à jour votre installation actuelle duAWS CLI, ajoutez votre lien symbolique existant et les informations relatives au programme d'installation pour créer leinstallcommande avec--updateparamètre.
```
$ sudo ./aws/install --bin-dir /usr/local/bin --install-dir /usr/local/aws-cli --update
```
Pour localiser le lien symbolique et le répertoire d'installation existants, procédez comme suit :
1. Utilisez la commande which pour rechercher votre lien symbolique. Cela vous indique le chemin à utiliser avec le paramètre --bin-dir.
  
  $ which aws /usr/local/bin/aws
2. Utilisez la commande ls pour rechercher le répertoire vers lequel votre lien symbolique pointe. Cela vous indique le chemin à utiliser avec le paramètre --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
Confirmez l'installation à l'aide de la commande suivante.
```
$ aws --version
aws-cli/2.10.0 Python/3.11.2 Linux/4.14.133-113.105.amzn2.x86_64 botocore/2.4.5
```
Si leawsla commande est introuvable, vous devrez peut-être redémarrer votre terminal ou suivre les instructions de résolution des problèmes dansRésoudre les erreurs AWS CLI.

Exigences d'installation et de mise à jour

Nous prenons en charge l'AWS CLI sur les versions de macOS 64 bits prises en charge par Apple.
AWS ne gérant pas les référentiels tiers, nous ne pouvons pas garantir qu'ils contiennent la dernière version de l’AWS CLI.

Installez ou mettez à jour leAWS CLI

Si vous effectuez une mise à jour vers la dernière version, utilisez la même méthode d'installation que celle utilisée pour la version actuelle. Vous pouvez installerAWS CLIsur macOS de la manière suivante.

GUI installer

Les étapes suivantes indiquent comment installer la dernière version duAWS CLIen utilisant l'interface utilisateur standard de macOS et votre navigateur.

Dans votre navigateur, téléchargez le macOSpkgfichier :https://awscli.amazonaws.com/AWSCLIV2.pkg
Lancez le fichier téléchargé et suivez les instructions qui s'affichent à l'écran. Vous pouvez choisir d'installer AWS CLI de la manière suivante :
- Pour tous les utilisateurs de l'ordinateur (nécessite sudo)
  - Vous pouvez installer dans n'importe quel dossier ou choisir le dossier par défaut recommandé, à savoir /usr/local/aws-cli.
  - Le programme d'installation crée automatiquement un lien symbolique à l'adresse /usr/local/bin/aws qui fait le lien avec le programme principal du dossier d'installation que vous avez choisi.
- Pour le seul utilisateur actuel (ne nécessite pas sudo)
  - Vous pouvez installer dans n'importe quel dossier sur lequel vous disposez d'une autorisation d'écriture.
  - En raison des autorisations utilisateur standard, une fois le programme d'installation terminé, vous devez créer manuellement un fichier de lien symbolique dans votre variable $PATH qui pointe vers les programmes aws et aws_completer en entrant les commandes suivantes à l'invite de commandes. Si votre variable $PATH inclut un dossier dans lequel vous pouvez écrire, vous pouvez exécuter la commande suivante sans sudo si vous spécifiez ce dossier comme chemin d'accès de la cible. Si vous n'avez pas de dossier accessible en écriture dans votre variable $PATH, vous devez utiliser sudo dans les commandes pour obtenir les autorisations d'écriture dans le dossier cible spécifié. L'emplacement par défaut d'un lien symbolique est /usr/local/bin/.
    
    $ 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
Note
Vous pouvez afficher les journaux de débogage pour l'installation en appuyant sur Cmd+L n'importe où dans le programme d'installation. Un volet du journal s'ouvre alors qui vous permet de filtrer et d'enregistrer le journal. Le fichier journal est également automatiquement enregistré dans /var/log/install.log.
Pour vérifier que le shell peut rechercher et exécuter la commande aws dans votre variable $PATH, utilisez les commandes suivantes.
```
$ which aws
/usr/local/bin/aws 
$ aws --version
aws-cli/2.10.0 Python/3.11.2 Darwin/18.7.0 botocore/2.4.5
```
Si leawsla commande est introuvable, vous devrez peut-être redémarrer votre terminal ou suivre les instructions de résolution des problèmes dansRésoudre les erreurs AWS CLI.

Command line installer - All users

Si vous disposez des autorisations sudo, vous pouvez installer l'AWS CLI pour tous les utilisateurs sur l'ordinateur. Nous fournissons les étapes dans un groupe facile à copier et coller. Consultez les descriptions de chaque ligne dans les étapes suivantes.


$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
$ sudo installer -pkg AWSCLIV2.pkg -target /

Vous pouvez télécharger le fichier à l'aide de la commande curl. L'option -o spécifie le nom de fichier dans lequel le package téléchargé est écrit. Dans cet exemple, le fichier est écrit dans AWSCLIV2.pkg du dossier actuel.
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
```
Exécutez le programme installer macOS standard, en spécifiant le fichier .pkg téléchargé comme source. Utilisez le paramètre -pkg pour spécifier le nom du package à installer et le paramètre -target / pour spécifier l'unité sur laquelle le package doit être installé. Les fichiers sont installés dans /usr/local/aws-cli, et un lien symbolique est automatiquement créé dans /usr/local/bin. Vous devez inclure sudo dans la commande pour accorder les autorisations d'écriture à ces dossiers.
```
$ sudo installer -pkg ./AWSCLIV2.pkg -target /
```
Une fois l'installation terminée, les journaux de débogage sont écrits dans /var/log/install.log.
Pour vérifier que le shell peut rechercher et exécuter la commande aws dans votre variable $PATH, utilisez les commandes suivantes.
```
$ which aws
/usr/local/bin/aws 
$ aws --version
aws-cli/2.10.0 Python/3.11.2 Darwin/18.7.0 botocore/2.4.5
```
Si leawsla commande est introuvable, vous devrez peut-être redémarrer votre terminal ou suivre les instructions de résolution des problèmes dansRésoudre les erreurs AWS CLI.

Command line - Current user

Pour spécifier dans quel dossierAWS CLIest installé dans, vous devez créer un fichier XML avec n'importe quel nom de fichier. Ce fichier est un fichier au format XML qui ressemble à l'exemple suivant. Laissez toutes les valeurs comme indiqué, à l'exception du chemin /Users/myUsername de la ligne 9 que vous devez remplacer par le chemin d'accès au dossier dans lequel vous voulez installer l'AWS CLI. Le dossier doit déjà exister, sinon la commande échoue. L'exemple XML suivant, nomméchoices.xml, indique le programme d'installation pour installerAWS CLIdans le dossier/Users/myusername, où il crée un dossier nommé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>
```
Téléchargez le programme d'installation pkg à l'aide de la commande curl. L'option -o spécifie le nom de fichier dans lequel le package téléchargé est écrit. Dans cet exemple, le fichier est écrit dans AWSCLIV2.pkg du dossier actuel.
```
$ curl "https://awscli.amazonaws.com/AWSCLIV2.pkg" -o "AWSCLIV2.pkg"
```
Exécutez le programme installer macOS standard avec les options suivantes :
- Spécifiez le nom du package à installer à l'aide du paramètre -pkg.
- Spécifiez l'installation sur unutilisateur actuel uniquementen réglant le-targetparamètre pourCurrentUserHomeDirectory.
- Spécifiez le chemin d'accès (relatif au dossier actuel) et le nom du fichier XML que vous avez créé dans le paramètre -applyChoiceChangesXML.
L'exemple suivant installe l'AWS CLI dans le dossier /Users/myusername/aws-cli.
```
$ installer -pkg AWSCLIV2.pkg \
            -target CurrentUserHomeDirectory \
            -applyChoiceChangesXML choices.xml
```
Les autorisations utilisateur standard n'autorisant généralement pas l'écriture dans les dossiers de votre variable $PATH, le programme d'installation de ce mode n'essaie pas d'ajouter les liens symboliques aux programmes aws et aws_completer. Pour que l'AWS CLI s'exécute correctement, vous devez créer manuellement les liens symboliques une fois le programme d'installation terminé. Si votre variable $PATH inclut un dossier dans lequel vous pouvez écrire et que vous spécifiez ce dossier comme chemin d'accès de la cible, vous pouvez exécuter la commande suivante sans sudo. Si vous ne disposez pas d'un dossier accessible en écriture dans votre variable $PATH, vous devez utiliser sudo pour les autorisations d'écriture dans le dossier cible spécifié. L'emplacement par défaut d'un lien symbolique est /usr/local/bin/. Remplacerfolder/installedavec le chemin qui mène à votreAWS CLIinstallation.
```
$ 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
```
Une fois l'installation terminée, les journaux de débogage sont écrits dans /var/log/install.log.
Pour vérifier que le shell peut rechercher et exécuter la commande aws dans votre variable $PATH, utilisez les commandes suivantes.
```
$ which aws
/usr/local/bin/aws 
$ aws --version
aws-cli/2.10.0 Python/3.11.2 Darwin/18.7.0 botocore/2.4.5
```
Si leawsla commande est introuvable, vous devrez peut-être redémarrer votre terminal ou suivre les instructions de résolution des problèmes dansRésoudre les erreurs AWS CLI.

Exigences d'installation et de mise à jour

Nous soutenons leAWS CLIsur les versions de Windows 64 bits prises en charge par Microsoft.
Droits d'administrateur pour installer le logiciel

Installez ou mettez à jour leAWS CLI

Pour mettre à jour votre installation actuelle deAWS CLIsous Windows, téléchargez un nouveau programme d'installation à chaque mise à jour pour remplacer les versions précédentes.AWS CLIest régulièrement mis à jour. Pour connaître la date de sortie de la dernière version, consultez leAWS CLIversion 2 ChangelogsurGitHub.

Téléchargez et exécutez leAWS CLIProgramme d'installation MSI pour Windows (64 bits) :

https://awscli.amazonaws.com/AWSCLIV2.msi

Vous pouvez également exécuter lemsiexeccommande pour exécuter le programme d'installation MSI.
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi
```
Pour différents paramètres pouvant être utilisés avecmsiexec, voirmsiexecsur leMicrosoft Docssite Web. Par exemple, vous pouvez utiliser/qndrapeau pour une installation silencieuse.
```
C:\> msiexec.exe /i https://awscli.amazonaws.com/AWSCLIV2.msi /qn
```
Pour confirmer l'installation, ouvrez le menu Démarrer, recherchez cmd pour ouvrir une fenêtre d'invite de commandes et, à l'invite de commandes, utilisez la commande aws --version.
```
C:\> aws --version
aws-cli/2.10.0 Python/3.11.2 Windows/10 exe/AMD64 prompt/off
```
Si Windows ne trouve pas le programme, vous devrez peut-être fermer puis rouvrir la fenêtre d'invite de commande pour actualiser le chemin, ou suivre les instructions de résolution des problèmes dansRésoudre les erreurs AWS CLI.

Résolution des problèmesAWS CLIerreurs d'installation et de désinstallation

Si vous rencontrez des problèmes après l'installation ou la désinstallation duAWS CLI, voirRésoudre les erreurs AWS CLIpour les étapes de résolution des problèmes. Pour connaître les étapes de résolution des problèmes les plus pertinentes, voirErreurs de commande non trouvées,La commande « aws --version » renvoie une version différente de celle que vous avez installée, etLa commande « aws --version » renvoie une version après la désinstallation du AWS CLI.

Étapes suivantes

Une fois l'installation réussie, vous pouvez supprimer en toute sécurité vos fichiers d'installation téléchargés. Après avoir effectué les étapes dePrérequis pour utiliser la version 2 AWS CLIet en installant leAWS CLI, vous devez effectuer uneConfiguration de l'AWS CLI.

Avertissement JavaScript est désactivé ou n'est pas disponible dans votre navigateur.

Pour que vous puissiez utiliser la documentation AWS, Javascript doit être activé. Vous trouverez des instructions sur les pages d'aide de votre navigateur.

Conventions de rédaction

Prérequis

Parutions précédentes