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. # Installer 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 en suivant les instructions figurant dans[Étape 4 : installez le AWS CLI](prerequisites.md#prerequisites-install-cli). 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, consultez[Gestion des versions CLI  AWS SAM](manage-sam-cli-versions.md). **Est-ce la première fois que vous installez la AWS SAM CLI ?** Remplissez l'ensemble des [conditions préalables](prerequisites.md) de la section précédente avant de poursuivre. Cela inclut notamment les éléments suivants : Création d'un AWS compte. Configuration d'un accès sécurisé à AWS. Création d'un ID de clé d'accès et d'une clé d'accès secrète. Installation du AWS CLI. Configuration des AWS informations d'identification. **Topics** + [Installation de la CLI  AWS SAM](#install-sam-cli-instructions) + [Résolution des erreurs d'installation](#sam-cli-troubleshoot-install) + [Étapes suivantes](#install-sam-cli-next-steps) + [Facultatif : vérifier l'intégrité du AWS SAMCLI programme d'installation](reference-sam-cli-install-verify.md) ## 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](manage-sam-cli-versions.md#manage-sam-cli-versions-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](manage-sam-cli-versions.md#manage-sam-cli-versions-switch). Pour plus de détails, reportez-vous à la [version de publication : 1.121.0](https://github.com/aws/aws-sam-cli/releases). Pour l'installer AWS SAMCLI, suivez les instructions correspondant à votre système d'exploitation. ### Linux ------ #### [ x86\_64 - command line installer ] 1. Téléchargez le [fichier .zip de la CLI AWS SAM](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-x86_64.zip) dans un répertoire de votre choix. 1. **(Facultatif)** Vous pouvez vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, veuillez consulter [Facultatif : vérifier l'intégrité du AWS SAMCLI programme d'installation](reference-sam-cli-install-verify.md). 1. 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}} ``` 1. Installez la CLI  AWS SAM en 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 ``` 1. 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, {{}} ``` ------ #### [ arm64 - command line installer ] 1. Téléchargez le [fichier .zip de la CLI AWS SAM](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-linux-arm64.zip) dans un répertoire de votre choix. 1. **(Facultatif)** Vous pouvez vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, veuillez consulter [Facultatif : vérifier l'intégrité du AWS SAMCLI programme d'installation](reference-sam-cli-install-verify.md). 1. 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}} ``` 1. Installez la CLI  AWS SAM en 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 ``` 1. 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, {{}} ``` ------ ### macOS #### Étapes d'installation Utilisez le programme d'installation du package pour installer le AWS SAMCLI. En outre, le programme d'installation du package propose deux méthodes d'installation parmi lesquelles vous pouvez choisir : **interface graphique** et **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. **Note** AWS SAM La CLI ne prend pas en charge les versions de macOS antérieures à macOS 13.x. Effectuez une mise à niveau vers une version compatible de macOS ou installez la AWS SAM CLI avecHomebrew. ------ #### [ GUI - All users ] **Pour télécharger le programme d'installation du package et installer le AWS SAMCLI** **Note** Si vous avez déjà installé la CLI  AWS SAM via Homebrew ou pip, vous devez d'abord la désinstaller. Pour obtenir des instructions, veuillez consulter [Désinstallation de la CLI  AWS SAM](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 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](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Pour les Mac équipés d'Apple Silicon, choisissez arm64 — -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **Note** Vous avez la possibilité de vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, veuillez consulter [Facultatif : vérifier l'intégrité du AWS SAMCLI programme d'installation](reference-sam-cli-install-verify.md). 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). 1. Pour **Destination Select** (Sélection de destination), sélectionnez **Install for all users of this computer** (Installer pour tous les utilisateurs de cet ordinateur). 1. Dans **Type d'installation**, choisissez l'emplacement d'installation de la CLI  AWS SAM et appuyez sur **Installer**. L'emplacement par défaut recommandé est `/usr/local/aws-sam-cli`. **Note** Pour invoquer la CLI  AWS SAM avec 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. 1. La CLI  AWS SAM va 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 SAM est correctement installée et que votre lien symbolique est configuré en exécutant : ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ GUI - Current user ] **Pour télécharger et installer AWS SAMCLI** **Note** Si vous avez déjà installé la CLI  AWS SAM via Homebrew ou pip, vous devez d'abord la désinstaller. Pour obtenir des instructions, veuillez consulter [Désinstallation de la CLI  AWS SAM](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 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](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Pour les Mac équipés d'Apple Silicon, choisissez arm64 — -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **Note** Vous avez la possibilité de vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, veuillez consulter [Facultatif : vérifier l'intégrité du AWS SAMCLI programme d'installation](reference-sam-cli-install-verify.md). 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). 1. 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. 1. 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é. 1. 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). 1. Appuyez sur **Install** (Installer). 1. La CLI  AWS SAM va 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 SAM 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'**sudo**est 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 SAMCLI programme. Par exemple, `/Users/myUser/Desktop`. + {{path-to-symlink-directory}}— Votre variable d'`$PATH`environnement. L'emplacement par défaut est `/usr/local/bin`. **Pour vérifier la réussite de l'installation** + Vérifiez que la CLI  AWS SAM est correctement installée et que votre lien symbolique est configuré en exécutant : ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ Command line - All users ] **Pour télécharger et installer AWS SAMCLI** **Note** Si vous avez déjà installé la CLI  AWS SAM via Homebrew ou pip, vous devez d'abord la désinstaller. Pour obtenir des instructions, veuillez consulter [Désinstallation de la CLI  AWS SAM](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 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](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Pour les Mac équipés d'Apple Silicon, choisissez arm64 — -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **Note** Vous avez la possibilité de vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, veuillez consulter [Facultatif : vérifier l'intégrité du AWS SAMCLI programme d'installation](reference-sam-cli-install-verify.md). 1. 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 SAM avec 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 SAM est correctement installée et que votre lien symbolique est configuré en exécutant : ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ #### [ Command line - Current user ] **Pour télécharger et installer AWS SAMCLI** **Note** Si vous avez déjà installé la CLI  AWS SAM via Homebrew ou pip, vous devez d'abord la désinstaller. Pour obtenir des instructions, veuillez consulter [Désinstallation de la CLI  AWS SAM](manage-sam-cli-versions.md#manage-sam-cli-versions-uninstall). 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](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-x86_64.pkg) + **[Pour les Mac équipés d'Apple Silicon, choisissez arm64 — -arm64.pkg aws-sam-cli-macos](https://github.com/aws/aws-sam-cli/releases/latest/download/aws-sam-cli-macos-arm64.pkg)** **Note** Vous avez la possibilité de vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, veuillez consulter [Facultatif : vérifier l'intégrité du AWS SAMCLI programme d'installation](reference-sam-cli-install-verify.md). 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-directory}} par`/Users/myUser/Desktop`, le dossier `aws-sam-cli` du programme y sera installé. ``` choiceAttribute customLocation attributeSetting {{path-to-my-directory}} choiceIdentifier default ``` 1. 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. 1. 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 SAM 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'**sudo**est 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 SAMCLI programme. Par exemple, `/Users/myUser/Desktop`. + {{path-to-symlink-directory}}— Votre variable d'`$PATH`environnement. L'emplacement par défaut est `/usr/local/bin`. **Pour vérifier la réussite de l'installation** + Vérifiez que la CLI  AWS SAM est correctement installée et que votre lien symbolique est configuré en exécutant : ``` $ which sam /usr/local/bin/sam $ sam --version SAM CLI, {{}} ``` ------ ### Windows 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](https://github.com/aws/aws-sam-cli/releases/latest/download/AWS_SAM_CLI_64_PY3.msi). 1. **(Facultatif)** Vous pouvez vérifier l'intégrité du programme d'installation avant l'installation. Pour obtenir des instructions, veuillez consulter [Facultatif : vérifier l'intégrité du AWS SAMCLI programme d'installation](reference-sam-cli-install-verify.md). 1. 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, {{}} ``` 1. 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](https://learn.microsoft.com/en-us/windows/win32/fileio/maximum-file-path-limitation?tabs=powershell#enable-long-paths-in-windows-10-version-1607-and-later) dans la *documentation de développement d'applications Microsoft Windows*. 1. 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](https://git-scm.com/book/en/v2/Getting-Started-Installing-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 cette erreur, votre shell ne peut pas localiser l'exécutable CLI  AWS SAM dans le chemin d'accès. Vérifiez l'emplacement du répertoire dans lequel vous avez installé l'exécutable CLI  AWS SAM, puis vérifiez que le répertoire se trouve sur votre chemin d'accès. #### AWS SAMCLIerreur : « /lib64/libc.so.6 : version `GLIBC\_2.14' introuvable (requise par/.so.1) » usr/local/aws-sam-cli/dist/libz 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 CLI  AWS SAM](#install-sam-cli). ### macOS #### Échec de l'installation ![Image du programme d'installation de la CLI  AWS SAM affichant un message d'échec de l'installation](http://docs.aws.amazon.com/fr_fr/serverless-application-model/latest/developerguide/images/sam-cli-troubleshoot-install-macos-install-failed.jpg) Si vous installez la CLI  AWS SAM pour votre utilisateur et que vous avez sélectionné un répertoire d'installation pour lequel vous ne disposez pas d'autorisations d'écriture, cette erreur peut survenir. Essayez l'une des actions suivantes : 1. Sélectionnez un autre répertoire d'installation pour lequel vous disposez d'autorisations d'écriture. 1. Supprimez le programme d'installation. Ensuite, téléchargez-le et exécutez-le à nouveau. ## Étapes suivantes Pour en savoir plus sur la CLI  AWS SAM et pour commencer à créer vos propres applications sans serveur, veuillez consulter les ressources suivantes : + [Tutoriel : Déployer une application Hello World avec AWS SAM](serverless-getting-started-hello-world.md)— Step-by-step instructions pour télécharger, créer et déployer une application sans serveur de base. + [L' AWS SAM atelier complet](https://catalog.workshops.aws/complete-aws-sam/en-US) — Un atelier conçu pour vous enseigner les nombreuses fonctionnalités principales qu'il AWS SAM fournit. + [AWS SAM exemples d'applications et de modèles](https://serverlessland.com/patterns?framework=AWS+SAM) : exemples d'applications et de modèles créés par des auteurs de la communauté que vous pouvez tester plus avant.