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

Gehen Sie folgendermaßen vor, um die Voraussetzungen für die Verwendung derAWS SAMCommand 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 keine habenAWSkonto, sieheaws.amazon.comund wähleErstellen einesAWSKontoaus. Detaillierte Anweisungen finden Sie unter .Wie erstelle und aktiviere ich ein neuesAWSKonto?

Schritt 2: Konfigurieren Sie IAM-Berechtigungen undAWSReferenzen

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 unter Erstellen Ihres ersten IAM-Admin-Benutzers und Ihrer ersten IAM-Gruppe im IAM-Benutzerhandbuch.

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 Berechtigungen.

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

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.

Anmerkung

Wir unterstützen offiziell Docker Desktop, aber ab SAM CLI Version 1.47.0 können Sie Alternativen verwenden, solange sie die Docker-Laufzeit verwenden.

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 verwendet dieDOCKER_HOST-Umgebungsvariablen 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. Um Docker zu installieren, lesen Sie nachInstallieren 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 außerdem, dass Sie Docker-Befehle über die Befehlszeile ausführen können (z.docker ps) enthalten. Sie müssen keine Container installieren, abrufen oder ziehen - dieAWS SAMCLI macht dies bei Bedarf automatisch.

Wenn bei der Installation von Docker Probleme auftreten, lesen Sie dieProtokolle und Fehlerbehebung-Abschnitt imDocker-InstallationsanleitungFür zusätzliche Tipps zur Fehlerbehebung.

Schritt 4: Installieren Homebrew

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

So installieren SieHomebrew, Sie müssen zuerst Git installieren. Weitere Informationen über Git finden Sie unterGit-Dokumentationaus. Git ist auf vielen verschiedenen Betriebssystemen verfügbar, darunter 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 von sollte eine Ausgabe wie die folgende aussehen.Homebrew:

 
 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 verwendenHomebrew:

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

Überprüfen Sie die Installation:

sam --version

Nach erfolgreicher Installation des sollte eine Ausgabe wie die folgende aussehen.AWS SAMCLI:

 
 SAM CLI, version 1.35.0

Sie sind jetzt bereit, um mit der Entwicklung zu beginnen.

Upgrades

So upgraden Sie dasAWS SAMCLI verwendenHomebrewFühren Sie den folgenden Befehl aus:

brew upgrade aws-sam-cli

Deinstallieren

So deinstallieren Sie denAWS SAMCLI verwendenHomebrewFühren Sie den folgenden Befehl aus:

brew uninstall aws-sam-cli

Nightly BUILD

Ein nächtlicher Build desAWS SAMCLI steht Ihnen zur Installation zur Verfügung. Einmal installiert, können Sie den Nightly Build verwenden, indem Sie diesam-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 ist in der Form1.X.Y.dev<YYYYMMDDHHmm>, zum Beispiel:

SAM CLI, version 1.20.0.dev202103151200

Nächste Schritte

Sie können jetzt 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: