Installer la   AWS SAM CLI

Installez la dernière version du AWS Serverless Application Model Interface de ligne de commande (AWS SAM CLI) sur les systèmes d'exploitation pris en charge.

Pour plus d'informations sur la gestion d'une version actuellement installée du AWS SAM CLI, y compris la procédure de mise à niveau, de désinstallation ou de gestion des versions nocturnes, voirGestion des versions CLI  AWS SAM.

Est-ce la première fois que vous installez le AWS SAM CLI?

Remplissez l'ensemble des conditions préalables de la section précédente avant de poursuivre. Cela consiste notamment à :

1. S'inscrire à un AWS .

2. Création d'un IAM utilisateur administratif.

3. Création d'un ID de clé d'accès et d'une clé d'accès secrète.

4. Installation de la   AWS CLI.

5. Configuration AWS informations d'identification.

Rubriques

• Installation de la   AWS SAM CLI
• Résolution des erreurs d'installation
• Étapes suivantes
• Facultatif : vérifiez l'intégrité du AWS SAM CLI installer (programme d'installation)

Installation de la   AWS SAM CLI

Note

À partir de septembre 2023, AWS ne maintiendra plus le AWS gérés Homebrew installateur pour AWS SAM CLI (aws/tap/aws-sam-cli). Si vous utilisez Homebrew pour installer et gérer le AWS SAM CLI, consultez les options suivantes :

• Pour continuer à utiliser Homebrew, vous pouvez utiliser le programme d'installation géré par la communauté. Pour de plus amples informations, veuillez consulter Gestion de la CLI  AWS SAM avec Homebrew.

• Nous vous recommandons d'utiliser l'une des méthodes d'installation de premier niveau décrites sur cette page. Avant d'utiliser l'une de ces méthodes, consultez Passer de Homebrew.

• Pour plus de détails, reportez-vous à la version de publication : 1.121.0.

Pour installer la   AWS SAM CLI, suivez les instructions correspondant à votre système d'exploitation.

Linux

x86_64 - command line installer

1. Télécharger le AWS SAM CLI fichier .zip dans le répertoire de votre choix.

2. (Facultatif) Vous pouvez vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, consultez Facultatif : vérifiez l'intégrité du AWS SAM CLI installer (programme d'installation).

3. Décompressez les fichiers d'installation dans le répertoire de votre choix. Voici un exemple avec utilisation du sous-répertoire sam-installation.

   Note

   Si votre système d'exploitation ne dispose pas de la commande unzip intégrée, utilisez un équivalent.

   $ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation

4. Installer la   AWS SAM CLI en exécutant l'installexécutable. L'exécutable se trouve dans le répertoire utilisé à l'étape précédente. Voici un exemple avec utilisation du sous-répertoire sam-installation :

   $ sudo ./sam-installation/install

5. Vérifiez l'installation.

   $ sam --version

   Pour confirmer la réussite de l'installation, vous devriez voir une sortie qui remplace le texte entre crochets suivant par la dernière version disponible :

    SAM CLI, <latest version>

arm64 - command line installer

1. Télécharger le AWS SAM CLI fichier .zip dans le répertoire de votre choix.

2. (Facultatif) Vous pouvez vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, consultez Facultatif : vérifiez l'intégrité du AWS SAM CLI installer (programme d'installation).

3. Décompressez les fichiers d'installation dans le répertoire de votre choix. Voici un exemple avec utilisation du sous-répertoire sam-installation.

   Note

   Si votre système d'exploitation ne dispose pas de la commande unzip intégrée, utilisez un équivalent.

   $ unzip aws-sam-cli-linux-arm64.zip -d sam-installation

4. Installer la   AWS SAM CLI en exécutant l'installexécutable. L'exécutable se trouve dans le répertoire utilisé à l'étape précédente. Voici un exemple avec utilisation du sous-répertoire sam-installation :

   $ sudo ./sam-installation/install

5. Vérifiez l'installation.

   $ sam --version

   Pour confirmer la réussite de l'installation, vous devriez voir un résultat comme celui-ci, mais qui remplace le texte entre crochets par la dernière version SAM CLI :

    SAM CLI, <latest version>

macOS

Étapes d'installation

Utilisez le programme d'installation du package pour installer le AWS SAM CLI. En outre, le programme d'installation du package propose deux méthodes d'installation parmi lesquelles vous pouvez choisir : GUIet la ligne de commande. Vous pouvez l'installer pour tous les utilisateurs ou uniquement pour votre utilisateur actuel. Pour effectuer l'installation pour tous les utilisateurs, l'autorisation de superutilisateur est requise.

GUI - All users

Pour télécharger le programme d'installation du package et installer le AWS SAM CLI

Note

Si vous avez déjà installé le AWS SAM CLI à travers Homebrew or pip, vous devez d'abord le désinstaller. Pour obtenir des instructions, consultez Désinstallation de la CLI  AWS SAM.

1. Téléchargez le macOS pkg dans le répertoire de votre choix :

   • Pour les Mac équipés de processeurs Intel, choisissez x86_64 — -x86_64.pkg aws-sam-cli-macos

   • Pour les Mac équipés d'Apple Silicon, choisissez arm64 — -arm64.pkg aws-sam-cli-macos

   Note

   Vous avez la possibilité de vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, consultez Facultatif : vérifiez l'intégrité du AWS SAM CLI installer (programme d'installation).

2. Exécutez le fichier téléchargé et suivez les instructions qui s'affichent à l'écran pour suivre les étapes Introduction, Read Me (Lisez-moi) et License (Licence).

3. Pour Destination Select (Sélection de destination), sélectionnez Install for all users of this computer (Installer pour tous les utilisateurs de cet ordinateur).

4. Pour le type d'installation, choisissez l'endroit où AWS SAM CLI sera installé et appuyez sur Installer. L'emplacement par défaut recommandé est /usr/local/aws-sam-cli.

   Note

   Pour invoquer le AWS SAM CLI avec la sam commande, le programme d'installation crée automatiquement un lien symbolique entre /usr/local/bin/sam le dossier d'installation que vous avez choisi /usr/local/aws-sam-cli/sam ou le dossier d'installation que vous avez choisi.

5. Le AWS SAM CLI sera installé et le message « L'installation a réussi » s'affichera. Appuyez sur Close (Fermer).

Pour vérifier la réussite de l'installation

• Vérifiez que le AWS SAM CLI est correctement installé et que votre lien symbolique est configuré en exécutant :

  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>

GUI - Current user

Pour télécharger et installer le AWS SAM CLI

Note

Si vous avez déjà installé le AWS SAM CLI à travers Homebrew or pip, vous devez d'abord le désinstaller. Pour obtenir des instructions, consultez Désinstallation de la CLI  AWS SAM.

1. Téléchargez le macOS pkg dans le répertoire de votre choix :

   • Pour les Mac équipés de processeurs Intel, choisissez x86_64 — -x86_64.pkg aws-sam-cli-macos

   • Pour les Mac équipés d'Apple Silicon, choisissez arm64 — -arm64.pkg aws-sam-cli-macos

   Note

   Vous avez la possibilité de vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, consultez Facultatif : vérifiez l'intégrité du AWS SAM CLI installer (programme d'installation).

2. Exécutez le fichier téléchargé et suivez les instructions qui s'affichent à l'écran pour suivre les étapes Introduction, Read Me (Lisez-moi) et License (Licence).

3. Pour Destination Select (Sélection de destination), sélectionnez Install for me only (Installer pour moi uniquement). Si vous ne voyez pas cette option, passez à l'étape suivante.

4. Pour Installation Type (Type d'installation), procédez comme suit :

   1. Choisissez où AWS SAM CLI sera installé. L'emplacement par défaut est /usr/local/aws-sam-cli. Sélectionnez un emplacement pour lequel vous disposez d'autorisations d'écriture. Pour modifier l'emplacement d'installation, sélectionnez local et choisissez votre emplacement. Appuyez sur Continue (Continuer) lorsque vous avez terminé.

   2. Si vous n'avez pas eu la possibilité de choisir Install for me only (Installer pour moi uniquement) à l'étape précédente, sélectionnez Change Install Location (Modifier l'emplacement d'installation) > Install for me only et appuyez sur Continue (Continuer).

   3. Appuyez sur Install (Installer).

5. Le AWS SAM CLI sera installé et le message « L'installation a réussi » s'affichera. Appuyez sur Close (Fermer).

Pour créer un lien symbolique

• Pour invoquer le AWS SAM CLI avec la sam commande, vous devez créer manuellement un lien symbolique entre AWS SAM CLI programme et votre$PATH. Créez votre lien symbolique en modifiant et en exécutant la commande suivante :

  $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam

  • sudo — Si votre utilisateur dispose d'autorisations d'écriture pour$PATH, ce n'sudoest pas obligatoire. Dans le cas contraire, la valeur sudo est obligatoire.

  • path-to — Chemin d'accès à l'endroit où vous avez installé le AWS SAM CLI programme. Par exemple, /Users/myUser/Desktop.

  • path-to-symlink-directory — Votre variable d'$PATHenvironnement. L'emplacement par défaut est /usr/local/bin.

Pour vérifier la réussite de l'installation

• Vérifiez que le AWS SAM CLI est correctement installé et que votre lien symbolique est configuré en exécutant :

  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>

Command line - All users

Pour télécharger et installer le AWS SAM CLI

Note

Si vous avez déjà installé le AWS SAM CLI à travers Homebrew or pip, vous devez d'abord le désinstaller. Pour obtenir des instructions, consultez Désinstallation de la CLI  AWS SAM.

1. Téléchargez le macOS pkg dans le répertoire de votre choix :

   • Pour les Mac équipés de processeurs Intel, choisissez x86_64 — -x86_64.pkg aws-sam-cli-macos

   • Pour les Mac équipés d'Apple Silicon, choisissez arm64 — -arm64.pkg aws-sam-cli-macos

   Note

   Vous avez la possibilité de vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, consultez Facultatif : vérifiez l'intégrité du AWS SAM CLI installer (programme d'installation).

2. Modifiez et exécutez le script d'installation :

   $ sudo installer -pkg path-to-pkg-installer/name-of-pkg-installer -target /
   installer: Package name is AWS SAM CLI
   installer: Upgrading at base path /
   installer: The upgrade was successful.

   Note

   Pour invoquer le AWS SAM CLI avec la sam commande, le programme d'installation crée automatiquement un lien symbolique entre /usr/local/bin/sam et/usr/local/aws-sam-cli/sam.

Pour vérifier la réussite de l'installation

• Vérifiez que le AWS SAM CLI est correctement installé et que votre lien symbolique est configuré en exécutant :

  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>

Command line - Current user

Pour télécharger et installer le AWS SAM CLI

Note

Si vous avez déjà installé le AWS SAM CLI à travers Homebrew or pip, vous devez d'abord le désinstaller. Pour obtenir des instructions, consultez Désinstallation de la CLI  AWS SAM.

1. Téléchargez le macOS pkg dans le répertoire de votre choix :

   • Pour les Mac équipés de processeurs Intel, choisissez x86_64 — -x86_64.pkg aws-sam-cli-macos

   • Pour les Mac équipés d'Apple Silicon, choisissez arm64 — -arm64.pkg aws-sam-cli-macos

   Note

   Vous avez la possibilité de vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, consultez Facultatif : vérifiez l'intégrité du AWS SAM CLI installer (programme d'installation).

2. Déterminez le répertoire d'installation pour lequel vous disposez d'autorisations d'écriture. Créez ensuite un fichier xml à l'aide du modèle et modifiez-le pour qu'il reflète votre répertoire d'installation. Le répertoire doit déjà exister.

   Par exemple, si vous remplacez path-to-my-directory avec/Users/myUser/Desktop, le dossier aws-sam-cli du programme y sera installé.

   <?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>path-to-my-directory</string>
         <key>choiceIdentifier</key>
         <string>default</string>
       </dict>
     </array>
   </plist>

3. Enregistrez le fichier xml et vérifiez sa validité en procédant ainsi :

   $ installer -pkg path-to-pkg-installer \
   -target CurrentUserHomeDirectory \
   -showChoicesAfterApplyingChangesXML path-to-your-xml-file

   La sortie doit afficher les préférences qui seront appliquées au AWS SAM CLI programme.

4. Exécutez ce qui suit pour installer AWS SAM CLI:

   $ installer -pkg path-to-pkg-installer \
   -target CurrentUserHomeDirectory \
   -applyChoiceChangesXML path-to-your-xml-file
   
   # Example output
   installer: Package name is AWS SAM CLI
   installer: choices changes file 'path-to-your-xml-file' applied
   installer: Upgrading at base path base-path-of-xml-file
   installer: The upgrade was successful.

Pour créer un lien symbolique

• Pour invoquer le AWS SAM CLI avec la sam commande, vous devez créer manuellement un lien symbolique entre AWS SAM CLI programme et votre$PATH. Créez votre lien symbolique en modifiant et en exécutant la commande suivante :

  $ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam

  • sudo — Si votre utilisateur dispose d'autorisations d'écriture pour$PATH, ce n'sudoest pas obligatoire. Dans le cas contraire, la valeur sudo est obligatoire.

  • path-to — Chemin d'accès à l'endroit où vous avez installé le AWS SAM CLI programme. Par exemple, /Users/myUser/Desktop.

  • path-to-symlink-directory — Votre variable d'$PATHenvironnement. L'emplacement par défaut est /usr/local/bin.

Pour vérifier la réussite de l'installation

• Vérifiez que le AWS SAM CLI est correctement installé et que votre lien symbolique est configuré en exécutant :

  $ which sam
  /usr/local/bin/sam
  $ sam --version
  SAM CLI, <latest version>

Windows

Les fichiers Windows Installer (MSI) sont les fichiers d'installation du package pour le système d'exploitation Windows.

Procédez comme suit pour installer le AWS SAM CLI en utilisant le MSI fichier.

1. Téléchargez le AWS SAM CLI 64 bits.

2. (Facultatif) Vous pouvez vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, consultez Facultatif : vérifiez l'intégrité du AWS SAM CLI installer (programme d'installation).

3. Vérifiez l'installation.

   Une fois l'installation terminée, vérifiez-la en ouvrant une nouvelle invite de commande ou une nouvelle PowerShell invite. Vous devriez être en mesure d'appeler sam à partir de la ligne de commande.

   sam --version

   Après une installation réussie du AWS SAM CLI, vous devriez voir un résultat semblable à ce qui suit :

   SAM CLI, <latest version>

4. Activez les chemins d'accès longs (Windows 10 et versions ultérieures uniquement).

   Important

   Le AWS SAM CLI peut interagir avec des chemins de fichiers qui dépassent la limite maximale de chemin fixée par Windows. Cela peut provoquer des erreurs lors de l'exécution sam init en raison des MAX_PATH limitations de Windows 10. Pour résoudre ce problème, vous devez configurer le comportement des nouveaux chemins d'accès longs.

   Pour activer les chemins d'accès longs, veuillez consulter la rubrique Activer les chemins longs dans Windows 10, version 1607 et ultérieures dans la documentation de développement d'applications Microsoft Windows.

5. Installez Git.

   Pour télécharger des exemples d'applications à l'aide de la commande sam init, vous devez également installer Git. Pour obtenir des instructions, veuillez consulter Installation de Git.

Résolution des erreurs d'installation

Linux

Erreur Docker : « Impossible de se connecter au Démon Docker. Le démon docker fonctionne-t-il sur cet hôte ? »

Dans certains cas, pour autoriser ec2-user à accéder au démon Docker, vous devrez peut-être redémarrer votre instance. Si vous recevez cette erreur, essayez de redémarrer votre instance.

Erreur shell : « commande introuvable »

Si vous recevez ce message d'erreur, votre shell ne peut pas localiser le AWS SAM CLI exécutable dans le chemin. Vérifiez l'emplacement du répertoire dans lequel vous avez installé AWS SAM CLI exécutable, puis vérifiez que le répertoire se trouve sur votre chemin.

AWS SAM CLI erreur : « /lib64/libc.so.6 : version « GLIBC _2.14 » introuvable (requise par /usr/local/ /dist/libz.so.1) » aws-sam-cli

Si vous recevez cette erreur, vous utilisez une version non prise en charge de Linux et la version glibc intégrée est obsolète. Essayez l'une des actions suivantes :

• Mettez à niveau votre hôte Linux vers la version 64 bits d'une distribution récente de CentOS, Fedora, Ubuntu ou Amazon Linux 2.

• Suivez les instructions ci-dessous pour Installer la   AWS SAM CLI.

macOS

Échec de l'installation

Si vous installez le AWS SAM CLI pour votre utilisateur et que vous avez sélectionné un répertoire d'installation pour lequel vous n'avez pas d'autorisation d'écriture, cette erreur peut se produire. Essayez l'une des actions suivantes :

1. Sélectionnez un autre répertoire d'installation pour lequel vous disposez d'autorisations d'écriture.

2. Supprimez le programme d'installation. Ensuite, téléchargez-le et exécutez-le à nouveau.

Étapes suivantes

Pour en savoir plus sur le AWS SAM CLI et pour commencer à créer vos propres applications sans serveur, consultez ce qui suit :

• Tutoriel : Déployer une application Hello World avec AWS SAM— tep-by-step Instructions pour télécharger, créer et déployer une application sans serveur de base.

• Le complet AWS SAM Atelier — Un atelier conçu pour vous enseigner de nombreuses fonctionnalités majeures AWS SAM fournit.

• AWS SAM exemples d'applications et de modèles  : exemples d'applications et de modèles créés par des auteurs de la communauté que vous pouvez tester plus avant.