Installation du kitAWS SAMCLI sur macOS - 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 du kitAWS SAMCLI sur macOS

Procédez comme suit pour installer et configurer les conditions préalables à l'utilisation de l'kitAWS SAMInterface de ligne de commande (CLI) sur votre hôte macOS :

  1. Créez un compte AWS.

  2. ConfigurationAWS Identity and Access Management(IAM) etAWSInformations d'identification .

  3. Installez Docker. Remarque : Docker est une condition préalable uniquement pour tester votre application localement ou utiliser l'outil--use-containeroption

  4. Installer Homebrew.

  5. Installez l'interface de ligne de commande AWS SAM.

Étape 1 : Création d'un compte AWS

Si vous ne disposez pas déjà d'unAWS, voiraws.amazon.comet choisissezCréation d'unAWSCompte. Pour obtenir les instructions complètes, consultez .Quelle est la marche à suivre pour créer et activer un nouveauAWSUn compte ?

Étape 2 : Configurez les autorisations IAM etAWScredentials

L'utilisateur IAM que vous utilisez avecAWS SAMdoit avoir des autorisations suffisantes pour rendre nécessaireAWSappels de service et gestionAWSAWS. Le moyen le plus simple de s'assurer qu'un utilisateur dispose d'autorisations suffisantes consiste à lui accorder des privilèges d'administrateur. Pour de plus amples informations, veuillez consulterCréation de votre premier groupe et utilisateur administrateur IAMdans leGuide de l'utilisateur IAM.

Note

Si vous ne souhaitez pas accorder de privilèges d'administrateur aux utilisateurs qui utilisent leAWS Command Line Interface(AWS CLI), vous pouvez leur accorder des ensembles d'autorisations restreints. Pour plus d'informations, consultez Permissions.

En outre, pour activer leAWS SAMCLI à faireAWSAppels de service, vous devez configurerAWSInformations d'identification . Pour plus d'informations, consultez Configuration d'AWScredentials.

Étape 3 : Installez Docker (facultatif)

Note

Docker est une condition préalable uniquement pour tester votre application localement et pour créer des packages de déploiement à l'aide de l'outil--use-container. Si vous ne prévoyez pas d'utiliser ces fonctionnalités au départ, vous pouvez ignorer cette section ou installer Docker ultérieurement.

Docker est une application qui exécute des conteneurs sur vos machines macOS.AWS SAMfournit un environnement local similaire àAWS LambdaÀ utiliser comme conteneur Docker. Vous pouvez utiliser ce conteneur pour construire, tester et déboguer vos applications sans serveur.

Pour exécuter des projets et des fonctions sans serveur localement avec l'outilAWS SAMCLI, Docker doit être installé et fonctionnel. La .AWS SAML'interface de ligne de commandeDOCKER_HOSTpour contacter le démon Docker. Les étapes suivantes décrivent l'installation, la configuration et la vérification d'une installation Docker pour qu'elle fonctionne avec le kitAWS SAMINTERFACE DE LIGNE DE COMMANDE.

  1. Installez Docker

    La .AWS SAML'interface de ligne de commande prend en charge Docker s'exécutant sur macOS Sierra 10.12 ou version ultérieure. Pour installer Docker, consultez ci-dessous.Installer Docker Desktop pour Mac.

  2. Configurer vos lecteurs partagés

    La .AWS SAML'interface de ligne de commande requiert que le répertoire du projet, ou tout répertoire parent, soit répertorié dans un lecteur partagé. Pour partager des lecteurs sur macOS, consultezPartage de fichiers.

  3. Vérifier l'installation

    Une fois Docker installé, vérifiez qu'il fonctionne. Confirmez également que vous pouvez exécuter des commandes Docker à partir de la ligne de commande (par exemple,docker ps). Vous n'avez pas besoin d'installer, de récupérer ou de tirer un conteneur, le kitAWS SAML'interface de ligne de commande le fait automatiquement selon les besoins.

Si vous rencontrez des problèmes lors de l'installation de Docker, consultez leJournaux et dépannageSection duGuide d'installation de DockerPour obtenir des conseils de dépannage supplémentaires.

Étape 4 : Installer Homebrew

L'approche recommandée pour l'installation deAWS SAML'interface de ligne de commande sur macOS consiste à utiliser leHomebrewGestionnaire de packages. Pour plus d'informations surHomebrew, voir,HomebrewDocumentation.

Pour installerHomebrew, vous devez d'abord installer Git. Pour de plus amples informations sur Git, consultez.Documentation Git. Git est disponible sur de nombreux systèmes d'exploitation différents, y compris macOS. Pour obtenir des instructions sur l'installation de Git sur votre système d'exploitation particulier, consultezInstallation de Git.

Une fois que vous avez installé Git avec succès, exécutez ce qui suit pour installerHomebrew, en vous assurant de suivre les invites :

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

Vérifiez que .Homebrewest installé :

brew --version

Elle doit générer une sortie comme suit lors de l'installation réussie deHomebrew :

 
 Homebrew 2.5.7
 Homebrew/homebrew-core (git revision 1be3ad; last commit 2020-10-29)
 Homebrew/homebrew-cask (git revision a0cf3; last commit 2020-10-29)
        

Étape 5 : Installer leAWS SAMCLI

Suivez ces étapes pour installer l'AWS SAMUtilisation de l'CLIHomebrew :

brew tap aws/tap brew install aws-sam-cli

Vérifiez l'installation :

sam --version

Elle doit générer une sortie comme suit après l'installation réussie de l'AWS SAMINTERFACE DE LIGNE DE COMMANDE :

 
 SAM CLI, version 1.15.0

Vous êtes maintenant prêt à démarrer le développement.

Upgrading

Pour mettre à jourAWS SAMCLI, utilisation deHomebrew, exécutez la commande suivante :

brew upgrade aws-sam-cli

Uninstalling

Pour désinstaller leAWS SAMCLI, utilisation deHomebrew, exécutez la commande suivante :

brew uninstall aws-sam-cli

Construction de nuit

Une construction nocturne duAWS SAML'interface de ligne de commande est disponible pour vous permettre d'installer. Une fois installé, vous pouvez utiliser la construction nocturne à l'aide de l'sam-nightlyCommande de l' Vous pouvez installer et utiliser à la fois les versions de production et de construction nocturne duAWS SAMCLI à la fois.

La version nocturne contient une version pré-sortie deAWS SAMCode CLI qui peut être moins stable que la version de production. Notez que la construction nocturne ne contient pas de version pré-version de l'image de construction, donc la construction d'une application sans serveur avec le--use-containerutilise la dernière version de production de l'image de construction.

Pour installer la version de construction nocturne duAWS SAMCLI, exécutez les commandes suivantes :

brew tap aws/tap brew install aws-sam-cli-nightly

Pour vérifier que vous avez installé la version de construction nocturne, exécutez la commandesam-nightly --versionCommande de l' Le résultat de cette commande est sous la forme1.X.Y.dev<YYYYMMDDHHmm>, par exemple :

SAM CLI, version 1.20.0.dev202103151200

Étapes suivantes

Vous êtes maintenant prêt à créer vos propres applications sans serveur à l'aide deAWS SAM ! Si vous souhaitez commencer avec des exemples d'applications sans serveur, choisissez l'un des liens suivants :