AWS SAMCLIVersionen verwalten - 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.

AWS SAMCLIVersionen verwalten

Verwalten Sie Ihre Versionen der AWS Serverless Application Model Befehlszeilenschnittstelle (AWS SAMCLI) durch Upgrade, Downgrade und Deinstallation. Optional können Sie den Nightly Build herunterladen und installieren. AWS SAMCLI

Aktualisierung des AWS SAMCLI

Um das AWS SAMCLI auf Linux zu aktualisieren, folgen Sie den Installationsanweisungen unterInstallieren von AWS SAM CLI, fügen Sie jedoch die --update Option wie folgt zum Installationsbefehl hinzu:

sudo ./sam-installation/install --update

Die AWS SAMCLI muss mit derselben Methode aktualisiert werden, mit der sie installiert wurde. Wir empfehlen, dass Sie das Paketinstallationsprogramm verwenden, um das zu installieren und zu aktualisieren AWS SAMCLI.

Um das AWS SAMCLI mit dem Paketinstallationsprogramm zu aktualisieren, installieren Sie die neueste Paketversion. Anweisungen finden Sie unter Installieren von AWS SAM CLI.

Um das zu aktualisieren AWS SAMCLI, wiederholen Sie die Windows-Installationsschritte unter Installiere das AWS SAM CLI erneut.

Deinstallation des AWS SAMCLI

Um das AWS SAMCLI unter Linux zu deinstallieren, müssen Sie den Symlink und das Installationsverzeichnis löschen, indem Sie die folgenden Befehle ausführen:

  1. Suchen Sie den Symlink und die Installationspfade.

    • Suchen Sie den Symlink mit dem which folgenden Befehl:

      which sam

      Die Ausgabe zeigt den Pfad, in dem sich die AWS SAM Binärdateien befinden, zum Beispiel:

       /usr/local/bin/sam
    • Suchen Sie mit dem folgenden Befehl nach dem Verzeichnis, auf das der ls Symlink verweist:

      ls -l /usr/local/bin/sam

      Im folgenden Beispiel lautet /usr/local/aws-sam-cli das Installationsverzeichnis.

       lrwxrwxrwx 1 ec2-user ec2-user 49 Oct 22 09:49 /usr/local/bin/sam -> /usr/local/aws-sam-cli/current/bin/sam
  2. Löschen Sie den Symlink.

    sudo rm /usr/local/bin/sam
  3. Löschen Sie das Installationsverzeichnis.

    sudo rm -rf /usr/local/aws-sam-cli

Deinstallieren Sie AWS SAMCLI das mit derselben Methode, mit der es installiert wurde. Wir empfehlen, dass Sie das Paketinstallationsprogramm verwenden, um das zu installieren AWS SAMCLI.

Wenn Sie das AWS SAMCLI mit dem Paketinstallationsprogramm installiert haben, gehen Sie zur Deinstallation wie folgt vor.

Um das zu deinstallieren AWS SAMCLI
  1. Entfernen Sie das AWS SAMCLI Programm, indem Sie Folgendes ändern und ausführen:

    $ sudo rm -rf /path-to/aws-sam-cli
    1. sudo — Wenn Ihr Benutzer Schreibberechtigungen für den Ort hat, an dem AWS SAMCLI das Programm installiert ist, sudo ist dies nicht erforderlich. Andernfalls ist sudo erforderlich.

    2. /path-to — Pfad zu dem Ort, an dem Sie das Programm installiert haben. AWS SAMCLI Der Standardspeicherort ist /usr/local.

  2. Entfernen Sie das, AWS SAMCLI $PATH indem Sie Folgendes ändern und ausführen:

    $ sudo rm -rf /path-to-symlink-directory/sam
    1. sudo — Wenn Ihr Benutzer Schreibberechtigungen hat$PATH, sudo ist dies nicht erforderlich. Andernfalls ist sudo erforderlich.

    2. path-to-symlink-directory— Ihre $PATH Umgebungsvariable. Der Standardspeicherort ist /usr/local/bin.

  3. Stellen Sie sicher, dass das deinstalliert AWS SAMCLI ist, indem Sie Folgendes ausführen:

    $ sam --version command not found: sam

Gehen Sie folgendermaßen vor, um das AWS SAMCLI mithilfe der Windows-Einstellungen zu deinstallieren:

  1. Suchen Sie im Startmenü nach „Programme hinzufügen oder entfernen“.

  2. Wählen Sie das Ergebnis mit dem Namen AWS SAM Command Line Interface und anschließend Deinstallieren, um das Deinstallationsprogramm zu starten.

  3. Bestätigen Sie, dass Sie das AWS SAMCLI deinstallieren möchten.

Wechseln Sie von der Verwendung Homebrew zur Verwaltung von AWS SAMCLI

Wenn Sie Homebrew die Installation und Aktualisierung von verwenden AWS SAMCLI, empfehlen wir die Verwendung einer AWS unterstützten Methode. Folgen Sie diesen Anweisungen, um zu einer unterstützten Methode zu wechseln.

Um von der Verwendung von zu wechseln Homebrew
  1. Folgen Sie den Anweisungen unterDeinstallation einer Homebrew installierten CLI AWS SAM, um die Homebrew verwaltete Version zu deinstallieren.

  2. Folgen Sie den Anweisungen unterInstalliere das AWS SAM CLI, um die AWS SAM CLI mit einer unterstützten Methode zu installieren.

Den AWS SAMCLI Nightly-Build verwalten

Sie können den AWS SAMCLI Nightly Build herunterladen und installieren. Er enthält eine Vorabversion des AWS SAMCLI Codes, die möglicherweise weniger stabil ist als die Produktionsversion. Nach der Installation können Sie den Nightly Build mit dem sam-nightly Befehl verwenden. Sie können sowohl die Produktions- als auch die Nightly-Build-Version von gleichzeitig installieren und verwenden. AWS SAMCLI

Anmerkung

Der Nightly-Build enthält keine Vorabversion des Build-Images. Aus diesem Grund wird beim Erstellen Ihrer serverlosen Anwendung mit dieser --use-container Option die neueste Produktionsversion des Build-Images verwendet.

Installation des AWS SAMCLI Nightly-Builds

Folgen Sie diesen Anweisungen, um den AWS SAMCLI Nightly-Build zu installieren.

Sie können die Nightly-Build-Version von AWS SAMCLI auf der Linux x86_64-Plattform mit dem Paket-Installer installieren.

Um den Nightly Build zu installieren AWS SAMCLI
  1. Laden Sie das Paketinstallationsprogramm aus sam-cli-nightlydem aws-sam-cli GitHubRepository herunter.

  2. Folgen Sie den Schritten zur Installation des AWS SAMCLI, um das Nightly Build-Paket zu installieren.

Sie können die Nightly Build-Version von AWS SAMCLI on macOS mit dem Nightly Build Package Installer installieren.

Um den Nightly Build zu installieren AWS SAMCLI
  1. Laden Sie das Paketinstallationsprogramm für Ihre Plattform aus sam-cli-nightlydem aws-sam-cli GitHubRepository herunter.

  2. Folgen Sie den Schritten zur Installation des AWS SAMCLI, um das Nightly Build-Paket zu installieren.

Die Nightly Build-Version von AWS SAMCLI ist über diesen Download-Link verfügbar: AWS SAMCLINightly Build. Um den Nightly Build unter Windows zu installieren, führen Sie dieselben Schritte aus wie inInstalliere das AWS SAM CLI, verwenden Sie jedoch stattdessen den Download-Link für den Nightly Build.

Führen Sie den Befehl aus, um zu überprüfen, ob Sie die Nightly Build-Version installiert haben. sam-nightly --version Die Ausgabe dieses Befehls hat zum Beispiel das 1.X.Y.dev<YYYYMMDDHHmm> folgende Format:

SAM CLI, version 1.20.0.dev202103151200

Wechseln Sie vom Homebrew Paketinstallationsprogramm

Wenn Sie den AWS SAMCLI Nightly-Build Homebrew zur Installation und zum Upgrade verwenden und zur Verwendung des Paketinstallationsprogramms wechseln möchten, gehen Sie wie folgt vor.

Um vom Homebrew Paket-Installer zu wechseln
  1. Deinstallieren Sie den Homebrew installierten AWS SAMCLI Nightly Build.

    $ brew uninstall aws-sam-cli-nightly
  2. Stellen Sie sicher, dass der AWS SAMCLI Nightly Build deinstalliert wurde, indem Sie Folgendes ausführen:

    $ sam-nightly --version zsh: command not found: sam-nightly
  3. Folgen Sie den Schritten im vorherigen Abschnitt, um den AWS SAMCLI Nightly Build zu installieren.

Installation des AWS SAMCLI in einer virtuellen Umgebung mit pip

Wir empfehlen, das native Paketinstallationsprogramm zu verwenden, um das zu installieren AWS SAMCLI. Wenn Sie es verwenden müssenpip, empfehlen wir Ihnen, das AWS SAMCLI in einer virtuellen Umgebung zu installieren. Dies gewährleistet eine saubere Installationsumgebung und eine isolierte Umgebung, falls Fehler auftreten.

Anmerkung

Ab dem 24. Oktober 2023 stellt AWS SAM CLI das den Support für Python 3.7 ein. Weitere Informationen hierzu finden Sie unter AWS SAM CLI Einstellung der Unterstützung für Python 3.7.

Um das AWS SAMCLI in einer virtuellen Umgebung zu installieren
  1. Erstellen Sie aus einem Startverzeichnis Ihrer Wahl eine virtuelle Umgebung und geben Sie ihr einen Namen.

    Linux / macOS
    $ mkdir project $ cd project $ python3 -m venv venv
    Windows
    > mkdir project > cd project > py -3 -m venv venv
  2. Aktivieren Sie die virtuelle Umgebung

    Linux / macOS
    $ . venv/bin/activate

    Die Eingabeaufforderung ändert sich und zeigt Ihnen, dass Ihre virtuelle Umgebung aktiv ist.

    (venv) $
    Windows
    > venv\Scripts\activate

    Die Aufforderung ändert sich und zeigt Ihnen, dass Ihre virtuelle Umgebung aktiv ist.

    (venv) >
  3. Installieren Sie das AWS SAMCLI in Ihrer virtuellen Umgebung.

    (venv) $ pip install --upgrade aws-sam-cli
  4. Stellen Sie sicher, dass das AWS SAMCLI korrekt installiert ist.

    (venv) $ sam --version SAM CLI, version 1.94.0
  5. Sie können den Befehl deactivate verwenden, um die virtuelle Umgebung zu beenden. Wenn Sie eine neue Sitzung starten, müssen Sie die Umgebung erneut aktivieren.

Verwaltung des AWS SAMCLI mit Homebrew

Anmerkung

Ab September 2023 AWS wird das AWS verwaltete Homebrew Installationsprogramm für AWS SAMCLI (aws/tap/aws-sam-cli) nicht mehr verwaltet. Um die Nutzung fortzusetzenHomebrew, können Sie das von der Community verwaltete Installationsprogramm (aws-sam-cli) verwenden. Ab September 2023 wird jeder Homebrew Befehl, auf den verwiesen aws/tap/aws-sam-cli wird, umgeleitetaws-sam-cli.

Wir empfehlen Ihnen, unsere unterstützten Installations - und Upgrade-Methoden zu verwenden.

Installation des AWS SAMCLI mit Homebrew

Anmerkung

Diese Anweisungen verwenden das von der Community verwaltete AWS SAMCLI Homebrew Installationsprogramm. Weitere Unterstützung finden Sie im Homebrew-Core-Repository.

Um das zu installieren AWS SAMCLI
  1. Führen Sie Folgendes aus:

    $ brew install aws-sam-cli
  2. Überprüfen Sie die Installation:

    $ sam --version

    Nach erfolgreicher Installation von sollten Sie eine Ausgabe wie die folgende sehen: AWS SAMCLI

    SAM CLI, version 1.94.0

Aktualisierung AWS SAMCLI des Homebrew

Führen Sie den folgenden Befehl ausHomebrew, um die AWS SAMCLI Verwendung zu aktualisieren:

$ brew upgrade aws-sam-cli

Deinstallation einer Homebrew installierten CLI AWS SAM

Wenn das mit installiert AWS SAMCLI wurdeHomebrew, gehen Sie wie folgt vor, um es zu deinstallieren.

Um das zu deinstallieren AWS SAMCLI
  1. Führen Sie Folgendes aus:

    $ brew uninstall aws-sam-cli
  2. Stellen Sie sicher, dass das deinstalliert AWS SAMCLI ist, indem Sie Folgendes ausführen:

    $ sam --version command not found: sam

Wechseln Sie zum von der Community verwalteten Homebrew Installationsprogramm

Wenn Sie das AWS verwaltete Homebrew Installationsprogramm (aws/tap/aws-sam-cli) verwenden und es vorziehen, es weiterhin zu verwendenHomebrew, empfehlen wir, zum von der Community verwalteten Homebrew Installationsprogramm (aws-sam-cli) zu wechseln.

Um in einem einzigen Befehl zu wechseln, führen Sie den folgenden Befehl aus:

$ brew uninstall aws-sam-cli && brew untap aws/tap && brew cleanup aws/tap && brew update && brew install aws-sam-cli

Folgen Sie diesen Anweisungen, um jeden Befehl einzeln auszuführen.

Um zum von der Community verwalteten Homebrew Installationsprogramm zu wechseln
  1. Deinstallieren Sie die AWS verwaltete Homebrew Version von AWS SAMCLI:

    $ brew uninstall aws-sam-cli
  2. Stellen Sie sicher, dass das deinstalliert AWS SAMCLI wurde:

    $ which sam sam not found
  3. Entfernen Sie den AWS verwalteten AWS SAMCLI Wasserhahn:

    $ brew untap aws/tap

    Wenn Sie eine Fehlermeldung wie die folgende erhalten, fügen Sie die --force Option hinzu und versuchen Sie es erneut.

    Error: Refusing to untap aws/tap because it contains the following installed formulae or casks:
    aws-sam-cli-nightly
  4. Entfernen Sie die zwischengespeicherten Dateien für das AWS verwaltete Installationsprogramm:

    $ brew cleanup aws/tap
  5. Update Homebrew und alle Formeln:

    $ brew update
  6. Installieren Sie die von der Community verwaltete Version von: AWS SAMCLI

    $ brew install aws-sam-cli
  7. Stellen Sie sicher, dass AWS SAMCLI das erfolgreich installiert wurde:

    $ sam --version SAM CLI, version 1.94.0

Fehlerbehebung

Falls Sie bei der Installation oder Verwendung von auf Fehler stoßen AWS SAMCLI, finden Sie weitere Informationen unterAWS SAMCLIProblembehandlung.