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 à :
-
Création d'un AWS compte.
-
Création d'un utilisateur IAM administrateur.
-
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.
Installation de la CLI AWS SAM
À 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
-
-
Téléchargez le fichier .zip de la CLI AWS SAM dans un répertoire de votre choix.
-
(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.
-
Décompressez les fichiers d'installation dans le répertoire de votre choix. Voici un exemple avec utilisation du sous-répertoire sam-installation
.
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
-
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
-
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
-
-
Téléchargez le fichier .zip de la CLI AWS SAM dans un répertoire de votre choix.
-
(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.
-
Décompressez les fichiers d'installation dans le répertoire de votre choix. Voici un exemple avec utilisation du sous-répertoire sam-installation
.
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
-
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
-
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.
Le programme d'installation du package est disponible dans les options x86_64 et arm64. Choisissez le package qui correspond à votre matériel Mac :
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 :
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
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
-
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).
-
Pour Destination Select (Sélection de destination), sélectionnez Install for all users of this computer (Installer pour tous les utilisateurs de cet ordinateur).
-
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
.
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.
-
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
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
-
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).
-
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.
-
Pour Installation Type (Type d'installation), procédez comme suit :
-
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é.
-
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).
-
Appuyez sur Install (Installer).
-
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'$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 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
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.
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
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
-
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é.
<?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>
-
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.
-
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'$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 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.
-
Téléchargez la CLI AWS SAM 64 bits.
-
(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.
-
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>
-
Activez les chemins d'accès longs (Windows 10 et versions ultérieures uniquement).
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.
-
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 :