Installieren desAWS SAMCLI unter 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 desAWS SAMCLI unter macOS

Führen Sie die folgenden Schritte aus, um die Voraussetzungen für die Verwendung derAWS SAMBefehlszeilenschnittstelle (Command Line Interface, 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 keinAWS-Konto finden Sie unteraws.amazon.comund wählen SieErstellen einesAWSKonto. Detaillierte Anweisungen finden Sie unter .Wie erstelle und aktiviere ich eine neueAWS-Konto?

Schritt 2: Konfigurieren von IAM-Berechtigungen undAWSAnmeldedaten

Der IAM-Benutzer, den Sie mitAWS SAMmuss über ausreichende Berechtigungen verfügen, um notwendig zu machenAWSService-Aufrufe undAWSRessourcen schätzen. Die einfachste Möglichkeit, sicherzustellen, dass ein Benutzer über ausreichende Berechtigungen verfügt, besteht darin, ihnen Administratorrechte zu erteilen. Weitere Informationen finden Sie unterErstellen Ihres ersten Administratorbenutzers und Ihrer ersten AdministratorgruppeimIAM-Benutzerhandbuch.

Anmerkung

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

Darüber hinaus können Sie dieAWS SAMUm zu erstellenAWS-Dienstaufrufe müssen SieAWS-Anmeldeinformationen. Weitere Informationen finden Sie unter Einrichten vonAWSAnmeldedaten.

Schritt 3: Installieren von Docker (optional)

Anmerkung

Docker ist nur eine Voraussetzung für das lokale Testen Ihrer Anwendung und für das Erstellen von Bereitstellungspaketen mit der--use-container-Option. Wenn Sie diese Funktionen zunächst nicht 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 SAMstellt eine lokale Umgebung bereit, die ähnlich wieAWS LambdaUm als Docker-Container zu verwenden. Sie können diesen Container verwenden, um serverlose Anwendungen zu erstellen, zu testen und zu debuggen.

Um serverlose Projekte und Funktionen lokal mit derAWS SAMCLI, müssen Sie Docker installiert haben und funktionieren. DieAWS SAMVerwenden der CLIDOCKER_HOSTUm den Docker-Daemon zu kontaktieren. In den folgenden Schritten wird beschrieben, wie Sie eine Docker-Installation installieren, konfigurieren und überprüfen, um mit derAWS SAMCLI.

  1. Docker-Installation

    DieAWS SAMCLI unterstützt Docker unter macOS Sierra 10.12 oder höher. Informationen zur Installation von Docker finden Sie unterDocker Desktop für Mac installieren.

  2. Konfigurieren Sie Ihre freigegebenen Laufwerke

    DieAWS SAMCLI erfordert, dass das Projektverzeichnis oder ein übergeordnetes Verzeichnis in einem freigegebenen Laufwerk aufgeführt ist. Informationen zum Freigeben von Laufwerken unter macOS finden Sie unterGemeinsame Nutzung von Dateien.

  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, abrufen oder ziehen.AWS SAMCLI erledigt dies bei Bedarf automatisch.

Wenn bei der Installation von Docker Probleme auftreten, schlagen Sie dieProtokolle und Fehlerbehebung-Abschnitt imDocker-InstallationshandbuchWeitere Tipps zur -Fehlerbehebung.

Schritt 4: Installieren Homebrew

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

So installieren SieHomebrewZuerst müssen Sie Git installieren. Weitere Informationen über Git finden Sie unterGit-Dokumentation. Git ist auf vielen verschiedenen Betriebssystemen verfügbar, einschließlich macOS. Anweisungen zum Installieren von Git auf Ihrem Betriebssystem finden Sie unterInstallieren von Git.

Nachdem Sie Git erfolgreich installiert haben, führen Sie Folgendes aus, umHomebrew, stellen Sie sicher, dass Sie die Eingabeaufforderungen befolgen:

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

Muss gegeben sein:Homebrewist installiert:

brew --version

Sie sollten eine Ausgabe wie die folgende aussehen, wenn Sie eine erfolgreiche 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

Führen Sie zur Installation derAWS SAMVerwenden der CLIHomebrew:

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

Überprüfen der Installation:

sam --version

Sie sollten eine Ausgabe wie die folgende aussehen, nachdem Sie die erfolgreich installiert haben.AWS SAMCLI:

 
 SAM CLI, version 1.15.0

Sie können jetzt entwickeln.

Upgrading

So upgraden Sie dasAWS SAMVerwenden der CLIHomebrewFühren Sie den folgenden Befehl aus:

brew upgrade aws-sam-cli

Uninstalling

So deinstallieren Sie denAWS SAMVerwenden der CLIHomebrewFühren Sie den folgenden Befehl aus:

brew uninstall aws-sam-cli

Nightly build

Ein nächtlicher Build desAWS SAMCLI steht für Sie zur Installation zur Verfügung. Nach der Installation können Sie den nächtlichen Build mithilfe dersam-nightly-Befehl. Sie können sowohl die Produktions- als auch die nächtliche Build-Version desAWS SAM-CLI gleichzeitig ist möglich.

Der nächtliche Build enthält eine Vorabversion 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 daher eine serverlose Anwendung mit dem--use-containerverwendet die neueste Produktionsversion des Build-Images.

Um die nächtliche Build-Version desAWS SAMFühren Sie zur Befehlszeilenschnittstelle die folgenden Befehle aus:

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

Um zu überprüfen, ob Sie die nächtliche Build-Version installiert haben, führen Sie diesam-nightly --version-Befehl. Die Ausgabe dieses Befehls ist wie folgt:1.X.Y.dev<YYYYMMDDHHmm>Beispiel:

SAM CLI, version 1.20.0.dev202103151200

Nächste Schritte

Sie sind jetzt bereit, um Ihre eigenen serverlosen Anwendungen mit zu erstellenAWS SAM! Wenn Sie mit Beispielanwendungen ohne Server beginnen möchten, wählen Sie einen der folgenden Links aus: