Installieren vonAWS SAMCLI auf macOS - AWS Serverless Application Model

Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Installieren vonAWS SAMCLI auf macOS

Führen Sie die folgenden Schritte zur Installation und Konfiguration der Voraussetzungen für die Verwendung desAWS SAM-Befehlszeilenschnittstelle (-CLI) auf Ihrem macOS-Host:

  1. Erstellen Sie ein AWS-Konto.

  2. KonfigurationAWS Identity and Access Management(IAM) Berechtigungen undAWS-Anmeldeinformationen.

  3. Docker-Installation. Hinweis: Docker ist nur Voraussetzung, um Ihre Anwendung lokal zu testen oder die--use-containeroption

  4. Installieren Homebrew.

  5. Installieren Sie die AWS SAM-CLI.

Schritt 1: Erstellen eines AWS-Kontos

Wenn Sie noch keinAWSkonto, sieheaws.amazon.comund wähleErstellen einesAWSKontoaus. Detaillierte Anweisungen finden Sie unter .Wie erstelle und aktiviere ich ein neuesAWSKonto?

Schritt 2: Konfigurieren von IAM-Berechtigungen undAWSAnmeldedaten

Der IAM-Benutzer, mit dem Sie verwendenAWS SAMmuss über ausreichende Berechtigungen verfügen, um dies erforderlich zu machenAWSServiceanrufe und verwaltenAWSRessourcen schätzen. Die einfachste Möglichkeit, sicherzustellen, dass ein Benutzer über ausreichende Berechtigungen verfügt, besteht darin, ihm Administratorrechte zu erteilen. Weitere Informationen finden Sie unterErstellen Ihres ersten Administratorbenutzers und Ihrer ersten Administratorgruppe inimIAM User Guideaus.

Anmerkung

Wenn Sie Benutzern, die dasAWS Command Line Interface(AWS CLI), können Sie ihnen eingeschränkte Berechtigungssätze erteilen. Weitere Informationen finden Sie unter Permissions.

Darüber hinaus aktivieren Sie dieAWS SAMCLI zu machenAWSServiceanrufe müssen Sie einrichtenAWS-Anmeldeinformationen. Weitere Informationen finden Sie unter Einrichten vonAWSAnmeldedaten.

Schritt 3: Docker installieren (optional)

Anmerkung

Docker ist nur Voraussetzung für das lokale Testen Ihrer Anwendung und zum Erstellen von Bereitstellungspaketen mit dem--use-containerOption. Wenn Sie diese Funktionen nicht zunächst verwenden möchten, können Sie diesen Abschnitt überspringen oder Docker zu einem späteren Zeitpunkt installieren.

Docker ist eine Anwendung, die Container auf Ihren macOS-Computern ausführt.AWS SAMbietet eine lokale Umgebung, die ähnlich istAWS LambdaVerwenden als Docker-Container. Sie können diesen Container verwenden, um Ihre serverlosen Anwendungen zu erstellen, zu testen und zu debuggen.

So führen Sie serverlose Projekte und Funktionen lokal mit demAWS SAMCLI, Sie müssen Docker installiert haben und arbeiten. DieAWS SAMCLI verwendetDOCKER_HOST-Umgebungsvariable zur Kontaktaufnahme mit dem Docker-Daemon. Die folgenden Schritte beschreiben, wie Sie eine Docker-Installation installieren, konfigurieren und überprüfen, um mit derAWS SAMCLI.

  1. Docker-Installation

    DieAWS SAMCLI unterstützt Docker, der unter macOS Sierra 10.12 oder höher läuft. Weitere Informationen finden Sie unter DockerInstallieren Sie Docker Desktop für Macaus.

  2. Konfigurieren Sie Ihre gemeinsamen Laufwerke

    DieAWS SAMCLI setzt voraus, dass das Projektverzeichnis oder ein übergeordnetes Verzeichnis in einem freigegebenen Laufwerk aufgeführt ist. Informationen zum Teilen von Laufwerken unter macOS finden Sie untergemeinsame Nutzung von Dateienaus.

  3. Überprüfen der Installation

    Stellen Sie nach der Installation von Docker sicher, dass es funktioniert. Bestätigen Sie auch, dass Sie Docker-Befehle über die Befehlszeile ausführen können (z. B.docker ps) enthalten. Sie müssen keine Container installieren, holen oder ziehen -AWS SAMCLI macht dies bei Bedarf automatisch.

Wenn bei der Installation von Docker Probleme auftreten, sehen Sie dieProtokolle und Fehlerbehebung-Abschnitt imDocker-InstallationsanleitungFür weitere Tipps zur -Fehlerbehebung.

Schritt 4: Installieren Homebrew

Der empfohlene Ansatz für die Installation desAWS SAMCLI unter macOS ist die Verwendung desHomebrewPackage Manager. Weitere Informationen zu Homebrew finden Sie in der Homebrew-Dokumentation.

So installieren SieHomebrewInstallieren, muss zunächst Git installiert werden. Weitere Informationen zu Git finden Sie unterGit-Dokumentationaus. Git ist auf vielen verschiedenen Betriebssystemen verfügbar, einschließlich macOS. Anweisungen zur Installation von Git auf Ihrem bestimmten Betriebssystem finden Sie unterInstallieren von Gitaus.

Nachdem Sie Git erfolgreich installiert haben, führen Sie Folgendes aus, um sie zu installierenHomebrewund befolgen Sie unbedingt die Anweisungen:

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

Muss gegeben sein:Homebrewist installiert:

brew --version

Bei erfolgreicher Installation vonHomebrew:

 
 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)
        

Schritt 5: Installieren desAWS SAMCLI

Gehen Sie folgendermaßen vor, um dieAWS SAMCLI Verwenden von CLIHomebrew:

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

Überprüfen Sie die Installation:

sam --version

Sie sollten eine Ausgabe wie die Folgende sehen, nachdem Sie die erfolgreiche Installation desAWS SAMCLI:

 
 SAM CLI, version 1.15.0

Jetzt können Sie mit der Entwicklung beginnen.

Upgrading

So upgraden Sie dasAWS SAMCLI, Verwenden von CLIHomebrewFühren Sie den folgenden Befehl aus:

brew upgrade aws-sam-cli

Uninstalling

So deinstallieren Sie denAWS SAMCLI, Verwenden von CLIHomebrewFühren Sie den folgenden Befehl aus:

brew uninstall aws-sam-cli

Nächtliche Bauart

Ein nächtlicher Build desAWS SAMCLI steht Ihnen zur Installation zur Verfügung. Nach der Installation können Sie den nächtlichen Build mithilfe dersam-nightlybefehl. Sie können sowohl die Produktions- als auch die nächtliche Build-Version desAWS SAMCLI gleichzeitig.

Der Nightly Build enthält eine Pre-Release-Version vonAWS SAMCLI-Code, der möglicherweise weniger stabil ist als die Produktionsversion. Beachten Sie, dass der nächtliche Build keine Vorabversion des Build-Images enthält. Erstellen Sie also eine serverlose Anwendung mit dem--use-containerverwendet die neueste Produktionsversion des Build-Images.

So installieren Sie die Nightly Build-Version desAWS SAMCLI, Führen Sie die folgenden Befehle aus:

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

Um zu überprüfen, ob Sie die Nightly Build-Version installiert haben, führen Sie diesam-nightly --versionbefehl. Die Ausgabe dieses Befehls erfolgt in der Form1.X.Y.dev<YYYYMMDDHHmm>, Beispiel:

SAM CLI, version 1.20.0.dev202103151200

Nächste Schritte

Nun können Sie mit dem Erstellen Ihrer eigenen serverlosen Anwendungen mitAWS SAM! Wenn Sie mit serverlosen Beispielanwendungen beginnen möchten, wählen Sie einen der folgenden Links aus: