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 der AWS SAMCLI
Installieren Sie die neueste Version der - AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAMCLI) auf unterstützten Betriebssystemen.
Informationen zur Verwaltung einer aktuell installierten Version von AWS SAMCLI, einschließlich Upgrades, Deinstallationen oder Verwaltung von nächtlichen Builds, finden Sie unter Verwalten von AWS SAMCLI Versionen.
Installieren Sie das zum ersten MalAWS SAM CLI?
Erfüllen Sie alle Voraussetzungen im vorherigen Abschnitt, bevor Sie fortfahren. Dies umfasst:
-
Registrierung für ein - AWS Konto.
-
Erstellen eines administrativen IAM-Benutzers.
-
Erstellen einer Zugriffsschlüssel-ID und eines geheimen Zugriffsschlüssels.
-
Installieren der AWS CLI.
-
Konfigurieren von AWS Anmeldeinformationen.
Installieren der AWS SAMCLI
Ab September 2023 AWS wird das AWS verwaltete Homebrew Installationsprogramm für die AWS SAMCLI () nicht mehr pflegenaws/tap/aws-sam-cli. Wenn Sie verwendenHomebrew, um zu installieren und zu verwalten AWS SAMCLI, sehen Sie sich die folgenden Optionen an:
-
Um weiterhin zu verwendenHomebrew, können Sie das von der Community verwaltete Installationsprogramm verwenden. Weitere Informationen finden Sie unter Verwalten der AWS SAMCLI mit Homebrew.
-
Wir empfehlen, eine der Installationsmethoden eines Drittanbieters zu verwenden, die auf dieser Seite dokumentiert sind. Bevor Sie eine dieser Methoden verwenden, lesen Sie Wechseln von Homebrew.
Um die zu installieren AWS SAMCLI, folgen Sie den Anweisungen für Ihr Betriebssystem.
- arm64 - command line installer
-
-
Laden Sie die AWS SAMZIPCLI-Datei in ein Verzeichnis Ihrer Wahl herunter.
-
(Optional) Sie können die Integrität des Installationsprogramms vor der Installation überprüfen. Anweisungen finden Sie unter Überprüfen der Integrität des AWS SAMCLI Installationsprogramms.
-
Entpacken Sie die Installationsdateien in ein Verzeichnis Ihrer Wahl. Im Folgenden finden Sie ein Beispiel für die Verwendung des sam-installation Unterverzeichnisses .
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 die , AWS SAMCLI indem Sie die install ausführbare Datei ausführen. Diese ausführbare Datei befindet sich im Verzeichnis , das im vorherigen Schritt verwendet wurde. Im Folgenden finden Sie ein Beispiel für die Verwendung des sam-installation Unterverzeichnisses :
$ 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 eckigen Text durch die neueste SAM-CLI-Version ersetzt:
SAM CLI, <latest version>
- x86_64 - command line installer
-
-
Laden Sie die AWS SAMZIPCLI-Datei in ein Verzeichnis Ihrer Wahl herunter.
-
(Optional) Sie können die Integrität des Installationsprogramms vor der Installation überprüfen. Anweisungen finden Sie unter Überprüfen der Integrität des AWS SAMCLI Installationsprogramms.
-
Entpacken Sie die Installationsdateien in ein Verzeichnis Ihrer Wahl. Im Folgenden finden Sie ein Beispiel für die Verwendung des sam-installation Unterverzeichnisses .
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 die , AWS SAMCLI indem Sie die install ausführbare Datei ausführen. Diese ausführbare Datei befindet sich im Verzeichnis , das im vorherigen Schritt verwendet wurde. Im Folgenden finden Sie ein Beispiel für die Verwendung des sam-installation Unterverzeichnisses :
$ 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 eckigen Text durch die neueste verfügbare Version ersetzt:
SAM CLI, <latest version>
Installieren Sie die AWS SAMCLI mit ihrem Paketinstallationsprogramm.
Das Paketinstallationsprogramm ist in den arm64 Optionen x86_64 und verfügbar. Wählen Sie das Paket aus, das zu Ihrer Mac Hardware passt:
Weitere Informationen finden Sie unter Mac Computer mit Apple Silicon .
Verwenden des Paketinstallationsprogramms
Das Paketinstallationsprogramm verfügt über zwei Installationsmethoden, aus denen Sie wählen können:
Sie können für alle Benutzer oder nur für Ihren aktuellen Benutzer installieren. Um für alle Benutzer zu installieren, ist eine Superuser-Autorisierung erforderlich.
Installationsschritte
Installieren Sie mit AWS SAMCLI einer der folgenden Optionen.
- GUI - All users
-
So laden Sie das Paketinstallationsprogramm herunter
Wenn Sie das zuvor AWS SAMCLI über Homebrew oder installiert habenpip, müssen Sie es zuerst deinstallieren. Anweisungen finden Sie unter Deinstallieren der AWS SAMCLI.
So überprüfen Sie das Paketinstallationsprogramm (optional)
So installieren Sie die AWS SAMCLI
-
Führen Sie Ihre heruntergeladene Datei aus und folgen Sie den Anweisungen auf dem Bildschirm, um mit den Schritten Einführung , Read Me und Lizenz fortzufahren.
-
Wählen Sie für Destination Select die Option Installieren für alle Benutzer dieses Computers aus.
-
Wählen Sie unter Installationstyp aus, wo die installiert werden AWS SAMCLI soll, und drücken Sie Installieren. Der empfohlene Standardspeicherort ist /usr/local/aws-sam-cli.
Um die AWS SAMCLI mit dem sam Befehl aufzurufen, erstellt das Installationsprogramm automatisch einen Symlink zwischen /usr/local/bin/sam und /usr/local/aws-sam-cli/sam oder dem ausgewählten Installationsordner.
-
Die AWS SAMCLI wird installiert und die Meldung Die Installation war erfolgreich wird angezeigt. Drücken Sie Schließen.
So überprüfen Sie eine erfolgreiche Installation
-
Stellen Sie sicher, dass der ordnungsgemäß installiert AWS SAMCLI ist und dass Ihr Symlink konfiguriert ist, indem Sie Folgendes ausführen:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- GUI - Current user
-
So laden Sie das Paketinstallationsprogramm herunter
Wenn Sie das zuvor AWS SAMCLI über Homebrew oder installiert habenpip, müssen Sie es zuerst deinstallieren. Anweisungen finden Sie unter Deinstallieren der AWS SAMCLI.
So überprüfen Sie das Paketinstallationsprogramm (optional)
So installieren Sie die AWS SAMCLI
-
Führen Sie Ihre heruntergeladene Datei aus und folgen Sie den Anweisungen auf dem Bildschirm, um mit den Schritten Einführung , Read Me und Lizenz fortzufahren.
-
Wählen Sie für Destination Select die Option Nur für mich installieren aus. Wenn diese Option nicht angezeigt wird, fahren Sie mit dem nächsten Schritt fort.
-
Gehen Sie für den Installationstyp wie folgt vor:
-
Wählen Sie aus, wo die installiert werden AWS SAMCLI soll. 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 dann Ihren Standort aus. Drücken Sie auf Weiter, wenn Sie fertig sind.
-
Wenn Sie im vorherigen Schritt nicht die Option Nur für mich installieren erhalten haben, wählen Sie Installationsort ändern > Nur für mich installieren und klicken Sie auf Weiter.
-
Drücken Sie Installieren.
-
Die AWS SAMCLI wird installiert und die Meldung Die Installation war erfolgreich wird angezeigt. Drücken Sie Schließen.
So erstellen Sie einen Symlink
-
Um die AWS SAMCLI mit dem sam Befehl aufzurufen, müssen Sie manuell einen Symlink zwischen dem AWS SAMCLI Programm und Ihrem erstellen$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 über Schreibberechtigungen für verfügt$PATH, sudo ist nicht erforderlich. Andernfalls ist sudo erforderlich.
-
path-to – Pfad zu dem Ort, an dem Sie das AWS SAMCLI Programm installiert haben. Beispiel: /Users/myUser/Desktop
-
path-to-symlink-directory – Ihre $PATH Umgebungsvariable. Der Standardspeicherort ist /usr/local/bin.
So überprüfen Sie eine erfolgreiche Installation
-
Stellen Sie sicher, dass der ordnungsgemäß installiert AWS SAMCLI ist und dass Ihr Symlink konfiguriert ist, indem Sie Folgendes ausführen:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- Command line - All users
-
So laden Sie das Paketinstallationsprogramm herunter
Wenn Sie das zuvor AWS SAMCLI über Homebrew oder installiert habenpip, müssen Sie es zuerst deinstallieren. Anweisungen finden Sie unter Deinstallieren der AWS SAMCLI.
So überprüfen Sie das Paketinstallationsprogramm (optional)
So installieren Sie die AWS SAMCLI
-
Ä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 die AWS SAMCLI mit dem sam Befehl aufzurufen, erstellt das Installationsprogramm automatisch einen Symlink zwischen /usr/local/bin/sam und /usr/local/aws-sam-cli/sam.
So überprüfen Sie eine erfolgreiche Installation
-
Stellen Sie sicher, dass der ordnungsgemäß installiert AWS SAMCLI ist und dass Ihr Symlink konfiguriert ist, indem Sie Folgendes ausführen:
$ which sam
/usr/local/bin/sam
$ sam --version
SAM CLI, <latest version>
- Command line - Current user
-
So laden Sie das Paketinstallationsprogramm herunter
Wenn Sie das zuvor AWS SAMCLI über Homebrew oder installiert habenpip, müssen Sie es zuerst deinstallieren. Anweisungen finden Sie unter Deinstallieren der AWS SAMCLI.
So überprüfen Sie das Paketinstallationsprogramm (optional)
So installieren Sie die AWS SAMCLI
-
Bestimmen Sie ein Installationsverzeichnis, für das Sie Schreibberechtigungen haben. Erstellen Sie dann mithilfe der Vorlage eine -xmlDatei und ändern Sie sie so, dass sie Ihrem Installationsverzeichnis entspricht. Das Verzeichnis muss bereits vorhanden sein.
Wenn Sie beispielsweise durch ersetzenpath-to-my-directory/Users/myUser/Desktop, wird der aws-sam-cli Programmordner 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>
-
Speichern Sie die 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
Die Ausgabe sollte die Einstellungen anzeigen, die auf das AWS SAMCLI Programm angewendet werden.
-
Führen Sie die folgenden Schritte aus, um die zu installieren AWS SAMCLI:
$ 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.
So erstellen Sie einen Symlink
-
Um die AWS SAMCLI mit dem sam Befehl aufzurufen, müssen Sie manuell einen Symlink zwischen dem AWS SAMCLI Programm und Ihrem erstellen$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 über Schreibberechtigungen für verfügt$PATH, sudo ist nicht erforderlich. Andernfalls ist sudo erforderlich.
-
path-to – Pfad zu dem Ort, an dem Sie das AWS SAMCLI Programm installiert haben. Beispiel: /Users/myUser/Desktop
-
path-to-symlink-directory – Ihre $PATH Umgebungsvariable. Der Standardspeicherort ist /usr/local/bin.
So überprüfen Sie eine erfolgreiche Installation
-
Stellen Sie sicher, dass der ordnungsgemäß installiert AWS SAMCLI ist und dass Ihr Symlink konfiguriert ist, 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.
Gehen Sie wie folgt vor, um mithilfe der MSI-Datei AWS SAMCLI zu installieren.
-
Laden Sie die AWS SAMCLI 64-Bit- herunter.
-
(Optional) Sie können die Integrität des Installationsprogramms vor der Installation überprüfen. Anweisungen finden Sie unter Überprüfen der Integrität des AWS SAMCLI Installationsprogramms.
-
Überprüfen Sie die Installation.
Nachdem Sie die Installation abgeschlossen haben, überprüfen Sie sie, indem Sie eine neue Eingabeaufforderung oder PowerShell Eingabeaufforderung öffnen. Sie sollten in der Lage sein, sam über die Befehlszeile aufzurufen.
sam --version
Nach erfolgreicher Installation der sollten AWS SAMCLISie eine Ausgabe wie die folgende sehen:
SAM CLI, <latest version>
-
Aktivieren Sie lange Pfade (nur Windows 10 und höher).
Die AWS SAMCLI kann mit Dateipfaden interagieren, die die maximale Windows-Pfadbeschränkung überschreiten. Dies kann sam init aufgrund von Windows 10-MAX_PATHEinschränkungen zu Fehlern führen, wenn ausgeführt wird. Um dieses Problem zu beheben, muss das neue Verhalten für lange Pfade konfiguriert werden.
Informationen zum Aktivieren von langen Pfaden finden Sie unter Aktivieren von langen Pfaden in Windows 10, Version 1607 und höher in der Microsoft Windows App-Entwicklungsdokumentation.
-
Installieren Sie Git.
Um Beispielanwendungen mit dem sam init Befehl herunterzuladen, müssen Sie auch Git installieren. Anweisungen finden Sie unter Installieren von Git.
Fehlerbehebung
Wenn bei der Installation der Probleme auftreten AWS SAMCLI, finden Sie weitere Informationen unter Installationsfehler.
Nächste Schritte
Weitere Informationen zu AWS SAMCLI und zum Erstellen Ihrer eigenen Serverless-Anwendungen finden Sie im Folgenden:
