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 Sie den AWS SAM CLI
Installieren Sie die neueste Version von AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAM CLI) auf unterstützten Betriebssystemen, indem Sie den Anweisungen in Schritt 1: Installieren Sie AWS CLI.
Für Informationen zur Verwaltung einer aktuell installierten Version von AWS SAM CLI, einschließlich Informationen zum Upgrade, zur Deinstallation oder zur Verwaltung nächtlicher Builds, finden Sie unter AWS SAMCLIVersionen verwalten.
Ist dies das erste Mal, dass Sie das installieren AWS SAM CLI?
Schließe alles ab Voraussetzungen im vorherigen Abschnitt, bevor Sie fortfahren. Dies umfasst:
-
Melde dich für eine an AWS Konto.
-
Einrichtung eines sicheren Zugriffs auf AWS.
-
Installation der AWS CLI.
-
Konfiguration AWS Anmeldeinformationen.
Installieren von AWS SAM CLI
Ab September 2023 AWS wird das nicht mehr aufrechterhalten AWS verwaltet Homebrew Installationsprogramm für den AWS SAM CLI (aws/tap/aws-sam-cli). Wenn du verwendest Homebrew um das zu installieren und zu verwalten AWS SAM CLI, siehe die folgenden Optionen:
Um das zu installieren AWS SAM CLI, folgen Sie den Anweisungen für Ihr Betriebssystem.
- x86_64 - command line installer
-
-
Laden Sie das herunter AWS SAM CLI .zip-Datei in ein Verzeichnis Ihrer Wahl.
-
(Fakultativ) Sie können die Integrität des Installationsprogramms vor der Installation überprüfen. Detaillierte Anweisungen finden Sie unter Optional: Überprüfen Sie die Integrität des AWS SAM CLI installer.
-
Entpacken Sie die Installationsdateien in ein Verzeichnis Ihrer Wahl. Das Folgende ist ein Beispiel unter Verwendung der sam-installation Unterverzeichnis.
Wenn Ihr Betriebssystem nicht über den integrierten unzip-Befehl verfügt, verwenden Sie ein Äquivalent.
$ unzip aws-sam-cli-linux-x86_64.zip -d sam-installation
-
Installieren Sie das AWS SAM CLI indem du den install ausführbar. Diese ausführbare Datei befindet sich in dem Verzeichnis, das im vorherigen Schritt verwendet wurde. Das Folgende ist ein Beispiel unter Verwendung der sam-installation Unterverzeichnis:
$ sudo ./sam-installation/install
-
Überprüfen Sie die Installation.
$ sam --version
Um eine erfolgreiche Installation zu bestätigen, sollten Sie eine Ausgabe sehen, die den folgenden Text in Klammern durch die neueste verfügbare Version ersetzt:
SAM CLI, <latest version>
- arm64 - command line installer
-
-
Laden Sie das herunter AWS SAM CLI .zip-Datei in ein Verzeichnis Ihrer Wahl.
-
(Fakultativ) Sie können die Integrität des Installationsprogramms vor der Installation überprüfen. Detaillierte Anweisungen finden Sie unter Optional: Überprüfen Sie die Integrität des AWS SAM CLI installer.
-
Entpacken Sie die Installationsdateien in ein Verzeichnis Ihrer Wahl. Das Folgende ist ein Beispiel unter Verwendung der sam-installation Unterverzeichnis.
Wenn Ihr Betriebssystem nicht über den integrierten unzip-Befehl verfügt, verwenden Sie ein Äquivalent.
$ unzip aws-sam-cli-linux-arm64.zip -d sam-installation
-
Installieren Sie das AWS SAM CLI indem du den install ausführbar. Diese ausführbare Datei befindet sich in dem Verzeichnis, das im vorherigen Schritt verwendet wurde. Das Folgende ist ein Beispiel unter Verwendung der sam-installation Unterverzeichnis:
$ sudo ./sam-installation/install
-
Überprüfen Sie die Installation.
$ sam --version
Um eine erfolgreiche Installation zu bestätigen, sollten Sie eine Ausgabe wie die folgende sehen, die jedoch den Text in Klammern durch die neueste SAM-CLI-Version ersetzt:
SAM CLI, <latest version>
Schritte zur Installation
Verwenden Sie das Paketinstallationsprogramm, um das zu installieren AWS SAM CLI. Darüber hinaus bietet das Paketinstallationsprogramm zwei Installationsmethoden, aus denen Sie wählen können: GUI und Befehlszeile. Sie können installieren für alle Benutzer oder nur dein aktueller Benutzer. Für die Installation für alle Benutzer ist eine Superuser-Autorisierung erforderlich.
AWS SAM CLI unterstützt keine macOS-Versionen, die älter als macOS 13.x sind. Führen Sie ein Upgrade auf eine unterstützte Version von macOS durch oder installieren Sie AWS SAM CLI mit Homebrew.
- GUI - All users
-
Um das Paketinstallationsprogramm herunterzuladen und das zu installieren AWS SAM CLI
Wenn Sie das zuvor installiert haben AWS SAM CLI durch Homebrew oder pip, du musst es zuerst deinstallieren. Detaillierte Anweisungen finden Sie unter Deinstallation des AWS SAMCLI.
-
Laden Sie das macOS herunter pkg in ein Verzeichnis deiner Wahl:
-
Führen Sie Ihre heruntergeladene Datei aus und folgen Sie den Anweisungen auf dem Bildschirm, um mit der Bearbeitung fortzufahren Einführung, Lies mich, und Lizenz Schritte.
-
Für Reiseziel Wählen, wählen Für alle Benutzer dieses Computers installieren.
-
Für Art der Installation, wählen Sie, wo der AWS SAM CLI wird installiert und drücke Installieren. Der empfohlene Standardspeicherort ist /usr/local/aws-sam-cli.
Um das aufzurufen AWS SAM CLI mit dem sam Befehl, das Installationsprogramm erstellt automatisch einen Symlink zwischen /usr/local/bin/sam und entweder /usr/local/aws-sam-cli/sam oder der Installationsordner, den Sie ausgewählt haben.
-
Der AWS SAM CLI wird installieren und Die Installation war erfolgreich Die Meldung wird angezeigt. Drücken Sie Schliessen.
Um eine erfolgreiche Installation zu überprüfen
-
Vergewissern Sie sich, dass AWS SAM CLI wurde ordnungsgemäß installiert und Ihr Symlink wird konfiguriert, indem Sie Folgendes ausführen:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- GUI - Current user
-
Um das herunterzuladen und zu installieren AWS SAM CLI
Wenn Sie das zuvor installiert haben AWS SAM CLI durch Homebrew oder pip, du musst es zuerst deinstallieren. Detaillierte Anweisungen finden Sie unter Deinstallation des AWS SAMCLI.
-
Laden Sie das macOS herunter pkg in ein Verzeichnis deiner Wahl:
-
Führen Sie Ihre heruntergeladene Datei aus und folgen Sie den Anweisungen auf dem Bildschirm, um mit der Bearbeitung fortzufahren Einführung, Lies mich, und Lizenz Schritte.
-
Für Reiseziel Wählen, wählen Nur für mich installieren. Wenn Sie diese Option nicht sehen, fahren Sie mit dem nächsten Schritt fort.
-
Für Art der Installation, gehen Sie wie folgt vor:
-
Wählen Sie, wo der AWS SAM CLI wird installiert. Der Standardspeicherort ist /usr/local/aws-sam-cli. Wählen Sie einen Speicherort aus, für den Sie Schreibberechtigungen haben. Um den Installationsort zu ändern, wählen Sie lokal und wähle deinen Standort. Drücken Sie Fortfahren wenn fertig.
-
Wenn Sie nicht die Option zur Auswahl hatten Nur für mich installieren wählen Sie im vorherigen Schritt Installationsort ändern > Nur für mich installieren und drücken Fahren Sie fort.
-
Drücken Installieren.
-
Das AWS SAM CLI wird installieren und Die Installation war erfolgreich Die Meldung wird angezeigt. Drücken Sie Schliessen.
Um einen Symlink zu erstellen
-
Um den aufzurufen AWS SAM CLI mit dem sam Befehl, Sie müssen manuell einen Symlink erstellen zwischen AWS SAM CLI Programm und dein $PATH. Erstellen Sie Ihren Symlink, indem Sie den folgenden Befehl ändern und ausführen:
$ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
-
sudo — Wenn Ihr Benutzer Schreibrechte hat für $PATH, sudo ist nicht erforderlich. Andernfalls ist sudo erforderlich.
-
path-to — Pfad zu dem Ort, an dem Sie das installiert haben AWS SAM CLI Programm. Beispiel, /Users/myUser/Desktop.
-
path-to-symlink-directory — Dein $PATH Umgebungsvariable. Der Standardspeicherort ist /usr/local/bin.
Um eine erfolgreiche Installation zu überprüfen
-
Vergewissern Sie sich, dass AWS SAM CLI wurde ordnungsgemäß installiert und Ihr Symlink wird konfiguriert, indem Sie Folgendes ausführen:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- Command line - All users
-
Um das herunterzuladen und zu installieren AWS SAM CLI
Wenn Sie das zuvor installiert haben AWS SAM CLI durch Homebrew oder pip, du musst es zuerst deinstallieren. Detaillierte Anweisungen finden Sie unter Deinstallation des AWS SAMCLI.
-
Laden Sie das macOS herunter pkg in ein Verzeichnis deiner Wahl:
-
Ändern Sie das Installationsskript und führen Sie es aus:
$ 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.
Um das aufzurufen AWS SAM CLI mit dem sam Befehl, das Installationsprogramm erstellt automatisch einen Symlink zwischen /usr/local/bin/sam und /usr/local/aws-sam-cli/sam.
Um eine erfolgreiche Installation zu überprüfen
-
Vergewissern Sie sich, dass AWS SAM CLI wurde ordnungsgemäß installiert und Ihr Symlink wird konfiguriert, indem Sie Folgendes ausführen:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- Command line - Current user
-
Um das herunterzuladen und zu installieren AWS SAM CLI
Wenn Sie das zuvor installiert haben AWS SAM CLI durch Homebrew oder pip, du musst es zuerst deinstallieren. Detaillierte Anweisungen finden Sie unter Deinstallation des AWS SAMCLI.
-
Laden Sie das macOS herunter pkg in ein Verzeichnis deiner Wahl:
-
Ermitteln Sie ein Installationsverzeichnis, für das Sie Schreibberechtigungen haben. Erstellen Sie dann eine xml Datei, die die Vorlage verwendet, und ändern Sie sie so, dass sie Ihrem Installationsverzeichnis entspricht. Das Verzeichnis muss bereits existieren.
Zum Beispiel, wenn Sie ersetzen path-to-my-directory mit /Users/myUser/Desktop, der aws-sam-cli Programmordner wird dort installiert.
<?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>
-
Speichere das xml Datei und überprüfen Sie, ob sie gültig ist, indem Sie Folgendes ausführen:
$ installer -pkg path-to-pkg-installer \
-target CurrentUserHomeDirectory \
-showChoicesAfterApplyingChangesXML path-to-your-xml-file
In der Ausgabe sollten die Einstellungen angezeigt werden, die auf das angewendet werden AWS SAM CLI Programm.
-
Führen Sie Folgendes aus, um das zu installieren AWS SAM CLI:
$ 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.
Um einen Symlink zu erstellen
-
Um den aufzurufen AWS SAM CLI mit dem sam Befehl, Sie müssen manuell einen Symlink erstellen zwischen AWS SAM CLI Programm und dein $PATH. Erstellen Sie Ihren Symlink, indem Sie den folgenden Befehl ändern und ausführen:
$ sudo ln -s /path-to/aws-sam-cli/sam /path-to-symlink-directory/sam
-
sudo — Wenn Ihr Benutzer Schreibrechte hat für $PATH, sudo ist nicht erforderlich. Andernfalls ist sudo erforderlich.
-
path-to — Pfad zu dem Ort, an dem Sie das installiert haben AWS SAM CLI Programm. Beispiel, /Users/myUser/Desktop.
-
path-to-symlink-directory — Dein $PATH Umgebungsvariable. Der Standardspeicherort ist /usr/local/bin.
Um eine erfolgreiche Installation zu überprüfen
-
Vergewissern Sie sich, dass AWS SAM CLI wurde ordnungsgemäß installiert und Ihr Symlink wird konfiguriert, indem Sie Folgendes ausführen:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
Windows Installer (MSI) -Dateien sind die Paketinstallationsdateien für das Windows-Betriebssystem.
Folgen Sie diesen Schritten, um das zu installieren AWS SAM CLI mit der MSI-Datei.
-
Laden Sie das herunter AWS SAM CLI 64 Bit.
-
(Fakultativ) Sie können die Integrität des Installationsprogramms vor der Installation überprüfen. Detaillierte Anweisungen finden Sie unter Optional: Überprüfen Sie die Integrität des AWS SAM CLI installer.
-
Überprüfen Sie die Installation.
Überprüfen Sie die Installation nach Abschluss der Installation, indem Sie eine neue Eingabeaufforderung öffnen oder PowerShell Eingabeaufforderung Sie sollten aufrufen können sam von der Befehlszeile aus.
sam --version
Nach erfolgreicher Installation des AWS SAM CLI, Sie sollten eine Ausgabe wie die folgende sehen:
SAM CLI, <latest version>
-
Aktivieren Sie lange Pfade (nur Windows 10 und neuer).
Das AWS SAM CLI könnte mit Dateipfaden interagieren, die die maximale Pfadbeschränkung von Windows überschreiten. Dies kann zu Fehlern beim Ausführen führen sam init aufgrund von Windows 10 MAX_PATH Einschränkungen. Um dieses Problem zu beheben, muss das neue Verhalten für lange Pfade konfiguriert werden.
Informationen zum Aktivieren langer Pfade finden Sie unter Aktivieren Sie lange Pfade in Windows 10, Version 1607 und höher in der Dokumentation zur Entwicklung von Microsoft Windows-Apps.
-
Installieren Sie Git.
Um Beispielanwendungen mit dem herunterzuladen sam init Befehl, Sie müssen auch Git installieren. Anweisungen dazu finden Sie unter Git installieren.
Problembehandlung bei Installationsfehlern
Linux
Docker-Fehler: „Es kann keine Verbindung zum Docker-Daemon hergestellt werden. Läuft der Docker-Daemon auf diesem Host?“
In einigen Fällen, um Berechtigungen für die zu erteilen ec2-user Um auf den Docker-Daemon zuzugreifen, müssen Sie möglicherweise Ihre Instanz neu starten. Wenn Sie diese Fehlermeldung erhalten, versuchen Sie, Ihre Instanz neu zu starten.
Shell-Fehler: „Befehl nicht gefunden“
Wenn Sie diesen Fehler erhalten, kann Ihre Shell den nicht finden AWS SAM CLI ausführbar im Pfad. Überprüfen Sie den Speicherort des Verzeichnisses, in dem Sie das installiert haben AWS SAM CLI ausführbar, und überprüfen Sie dann, ob sich das Verzeichnis in Ihrem Pfad befindet.
AWS SAM CLI Fehler: „/lib64/libc.so.6: Version `GLIBC_2.14' wurde nicht gefunden (erforderlich von/usr/local/aws-sam-cli/dist/libz.so.1)“
Wenn Sie diesen Fehler erhalten, verwenden Sie eine nicht unterstützte Version von Linux und die eingebaute Glibc-Version ist veraltet. Versuchen Sie eine der folgenden Möglichkeiten:
-
Aktualisieren Sie Ihren Linux-Host auf die 64-Bit-Version einer aktuellen Distribution von CentOS, Fedora, Ubuntu oder Amazon Linux 2.
-
Folgen Sie den Anweisungen für Installieren Sie den AWS SAM CLI.
macOS
Die Installation ist fehlgeschlagen
Wenn Sie das installieren AWS SAM CLI für Ihren Benutzer und ein Installationsverzeichnis ausgewählt haben, für das Sie keine Schreibrechte haben, könnte dieser Fehler auftreten. Versuchen Sie eine der folgenden Möglichkeiten:
-
Wählen Sie ein anderes Installationsverzeichnis aus, für das Sie Schreibberechtigungen haben.
-
Löschen Sie das Installationsprogramm. Laden Sie es dann herunter und führen Sie es erneut aus.
Nächste Schritte
Um mehr über das zu erfahren AWS SAM CLI und um mit der Entwicklung Ihrer eigenen serverlosen Anwendungen zu beginnen, lesen Sie die folgenden Informationen: