Installation de la CLI  AWS SAM - AWS Serverless Application Model

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 de la CLI  AWS SAM

Installez la dernière version de l'interface de ligne de AWS Serverless Application Model commande (AWS SAMCLI) sur les systèmes d'exploitation pris en charge.

Pour plus d'informations sur la gestion d'une version actuellement installée du AWS SAMCLI, notamment sur la mise à niveau, la désinstallation ou la gestion des versions nocturnes, consultezGestion des versions CLI AWS SAM.

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

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

  1. Création d'un AWS compte.

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

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

  4. Installation du AWS CLI.

  5. Configuration des AWS informations d'identification.

Installation de la CLI  AWS SAM

Note

À compter de septembre 2023, le programme d'Homebrewinstallation AWS géré pour le AWS SAMCLI (aws/tap/aws-sam-cli) ne AWS sera plus maintenu. Si vous avez l'Homebrewhabitude d'installer et de gérer le AWS SAMCLI, 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 l'installer AWS SAMCLI, suivez les instructions correspondant à votre système d'exploitation.

arm64 - command line installer
  1. Téléchargez le fichier .zip de la CLI AWS SAM dans un 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, veuillez consulter Vérifier l'intégrité du programme d'installation de la CLI AWS SAM.

  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. Installez la CLI  AWS SAMen lançant l'exécutable install. 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 de la CLI SAM :

     SAM CLI, <latest version>
x86_64 - command line installer
  1. Téléchargez le fichier .zip de la CLI AWS SAM dans un 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, veuillez consulter Vérifier l'intégrité du programme d'installation de la CLI AWS SAM.

  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. Installez la CLI  AWS SAMen lançant l'exécutable install. 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>

Installez la CLI  AWS SAMà l'aide du programme d'installation de packages.

Note

Le programme d'installation du package est disponible dans les options x86_64 et arm64. Choisissez le package qui correspond à votre matériel Mac :

  • x86_64 : grâce à la commande pour exécuter Macs les processeurs de Intel.

  • arm64 : grâce à la commande pour exécuter Macs le silicium Apple.

Pour en savoir plus, consultez la section Ordinateurs Mac avec le silicium Apple.

Utilisation du package d'installation

Le package d'installation vous propose de choisir entre deux méthodes d'installation :

  1. GUI

  2. Ligne de commande

Vous pouvez effectuer l'installation pour tous les utilisateurs ou uniquement pour votre utilisateur actuel. Pour effectuer l'installation pour tous les utilisateurs, l'autorisation de superutilisateur est requise.

Étapes d'installation

Installez la CLI  AWS SAMà l'aide de l'une des options suivantes.

GUI - All users
Pour télécharger le programme d'installation de packages
Note

Si vous avez déjà installé la CLI  AWS SAMvia Homebrew ou pip, vous devez d'abord la désinstaller. Pour obtenir des instructions, veuillez consulter Désinstallation de la CLI AWS SAM.

Pour vérifier le programme d'installation de packages (facultatif)
Pour installer la CLI  AWS SAM
  1. 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).

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

  3. Dans Type d'installation, choisissez l'emplacement d'installation de la CLI  AWS SAMet appuyez sur Installer. L'emplacement par défaut recommandé est /usr/local/aws-sam-cli.

    Note

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

  4. La CLI  AWS SAMva s'installer et le message L'installation s'est déroulée avec succès s'affichera. Appuyez sur Close (Fermer).

Pour vérifier la réussite de l'installation
  • Vérifiez que la CLI  AWS SAMest correctement installée 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 le programme d'installation de packages
Note

Si vous avez déjà installé la CLI  AWS SAMvia Homebrew ou pip, vous devez d'abord la désinstaller. Pour obtenir des instructions, veuillez consulter Désinstallation de la CLI AWS SAM.

Pour vérifier le programme d'installation de packages (facultatif)
Pour installer la CLI  AWS SAM
  1. 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).

  2. 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.

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

    1. Choisissez l'emplacement d'installation de la CLI  AWS SAM. 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).

  4. La CLI  AWS SAMva s'installer et le message L'installation s'est déroulée avec succès s'affichera. Appuyez sur Close (Fermer).

Pour créer un lien symbolique
  • Pour invoquer la CLI  AWS SAMà l'aide de la commande sam, vous devez créer manuellement un lien symbolique entre le programme CLI  AWS SAMet 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, sudo n'est pas obligatoire. Dans le cas contraire, la valeur sudo est obligatoire.

    • path-to : chemin d'accès vers l'emplacement d'installation du programme CLI  AWS SAM. 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 la CLI  AWS SAMest correctement installée 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 le programme d'installation de packages
Note

Si vous avez déjà installé la CLI  AWS SAMvia Homebrew ou pip, vous devez d'abord la désinstaller. Pour obtenir des instructions, veuillez consulter Désinstallation de la CLI AWS SAM.

Pour vérifier le programme d'installation de packages (facultatif)
Pour installer la CLI  AWS SAM
  • 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 la CLI  AWS SAMavec la commande sam, 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 la CLI  AWS SAMest correctement installée 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 le programme d'installation de packages
Note

Si vous avez déjà installé la CLI  AWS SAMvia Homebrew ou pip, vous devez d'abord la désinstaller. Pour obtenir des instructions, veuillez consulter Désinstallation de la CLI AWS SAM.

Pour vérifier le programme d'installation de packages (facultatif)
Pour installer la CLI  AWS SAM
  1. 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-directorypar/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>
  2. 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 réponse générée doit afficher les préférences qui seront appliquées au programme CLI  AWS SAM.

  3. Exécutez ce qui suit pour installer AWS SAMCLI :

    $ 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 la CLI  AWS SAMà l'aide de la commande sam, vous devez créer manuellement un lien symbolique entre le programme CLI  AWS SAMet 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, sudo n'est pas obligatoire. Dans le cas contraire, la valeur sudo est obligatoire.

    • path-to : chemin d'accès vers l'emplacement d'installation du programme CLI  AWS SAM. 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 la CLI  AWS SAMest correctement installée et que votre lien symbolique est configuré en exécutant :

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

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

Procédez comme suit pour installer la CLI  AWS SAMà l'aide du fichier MSI.

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

    Note

    Si vous utilisez une version 32 bits de Windows, consultez Installation de l'CLIAWS SAM sur Windows 32 bits.

  2. (Facultatif) Vous pouvez vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, veuillez consulter Vérifier l'intégrité du programme d'installation de la CLI AWS SAM.

  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

    Une fois l'installation réussie du AWS SAMCLI, vous devriez voir le résultat suivant :

    SAM CLI, <latest version>
  4. Activez les chemins d'accès longs (Windows 10 et versions ultérieures uniquement).

    Important

    Ils AWS SAMCLI peuvent interagir avec des chemins de fichiers qui dépassent la limite de chemin maximale de 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 problèmes

Si vous rencontrez des problèmes lors de l'installation du AWS SAMCLI, consultezErreurs d'installation.

Étapes suivantes

Pour en savoir plus sur la CLI  AWS SAMet pour commencer à créer vos propres applications sans serveur, veuillez consulter les ressources suivantes :