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
**Topics**
+ [
## Aktualisierung des AWS SAMCLI
](#manage-sam-cli-versions-upgrade)
+ [
## Deinstallation des AWS SAMCLI
](#manage-sam-cli-versions-uninstall)
+ [
## Wechseln Sie von der Verwendung Homebrew zur Verwaltung von AWS SAMCLI
](#manage-sam-cli-versions-switch)
+ [
## Den AWS SAMCLI Nightly-Build verwalten
](#manage-sam-cli-versions-nightly-build)
+ [
## Installation des AWS SAMCLI in einer virtuellen Umgebung mit pip
](#manage-sam-cli-versions-install-virtual)
+ [
## Verwaltung des AWS SAMCLI mit Homebrew
](#manage-sam-cli-versions-homebrew)
+ [
## Fehlerbehebung
](#manage-sam-cli-versions-troubleshoot)
## Aktualisierung des AWS SAMCLI
### Linux
Um das AWS SAMCLI auf Linux zu aktualisieren, folgen Sie den Installationsanweisungen unter[Installation des AWS SAMCLI](install-sam-cli.md#install-sam-cli-instructions), fügen Sie jedoch die `--update` Option wie folgt zum Installationsbefehl hinzu:
```
sudo ./sam-installation/install --update
```
### macOS
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. Detaillierte Anweisungen finden Sie unter [Installation des AWS SAMCLI](install-sam-cli.md#install-sam-cli-instructions).
### Windows
Um das zu aktualisieren AWS SAMCLI, wiederholen Sie die Windows-Installationsschritte unter [Installieren Sie das AWS SAMCLI](install-sam-cli.md) erneut.
## Deinstallation des AWS SAMCLI
### Linux
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
```
1. Löschen Sie den Symlink.
```
sudo rm /usr/local/bin/sam
```
1. Löschen Sie das Installationsverzeichnis.
```
sudo rm -rf /usr/local/aws-sam-cli
```
### macOS
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.
1. */path-to*— Pfad zu dem Ort, an dem Sie das AWS SAMCLI Programm installiert haben. Der Standardspeicherort ist `/usr/local`.
1. 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.
1. *path-to-symlink-directory*— Ihre `$PATH` Umgebungsvariable. Der Standardspeicherort ist `/usr/local/bin`.
1. Stellen Sie sicher, dass das deinstalliert AWS SAMCLI ist, indem Sie Folgendes ausführen:
```
$ sam --version
command not found: sam
```
### Windows
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“.
1. Wählen Sie das Ergebnis mit dem Namen **AWS SAM Command Line Interface** und anschließend **Deinstallieren, um das Deinstallationsprogramm** zu starten.
1. 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 unter[Deinstallation einer Homebrew installierten CLI AWS SAM](#manage-sam-cli-versions-homebrew-uninstall), um die Homebrew verwaltete Version zu deinstallieren.
1. Folgen Sie den Anweisungen unter[Installieren Sie das AWS SAMCLI](install-sam-cli.md), 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.
#### Linux
Sie können die Nightly-Build-Version von AWS SAMCLI auf der Linux x86\$164-Plattform mit dem Paket-Installer installieren.
**Um den Nightly Build zu installieren AWS SAMCLI**
1. Laden Sie das Paketinstallationsprogramm aus [sam-cli-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)dem *aws-sam-cli GitHubRepository* herunter.
1. Folgen Sie den Schritten zur [Installation des AWS SAMCLI, um das](install-sam-cli.md) Nightly Build-Paket zu installieren.
#### macOS
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-nightly](https://github.com/aws/aws-sam-cli/releases/sam-cli-nightly/)dem *aws-sam-cli GitHubRepository* herunter.
1. Folgen Sie den Schritten zur [Installation des AWS SAMCLI, um das](install-sam-cli.md) Nightly Build-Paket zu installieren.
#### Windows
Die Nightly Build-Version von AWS SAMCLI ist über diesen Download-Link verfügbar: [AWS SAMCLINightly](https://github.com/aws/aws-sam-cli/releases/download/sam-cli-nightly/AWS_SAM_CLI_64_PY3.msi) Build. Um den Nightly Build unter Windows zu installieren, führen Sie dieselben Schritte aus wie in[Installieren Sie das AWS SAMCLI](install-sam-cli.md), 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` 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
```
1. 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
```
1. 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 SAMCLIEinstellung der Unterstützung für Python 3.7](important-notes.md#important-notes-2023-10-python).
**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
```
------
1. 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) >
```
------
1. Installieren Sie das AWS SAMCLI in Ihrer virtuellen Umgebung.
```
(venv) $ pip install --upgrade aws-sam-cli
```
1. Stellen Sie sicher, dass das AWS SAMCLI korrekt installiert ist.
```
(venv) $ sam --version
SAM CLI, version 1.94.0
```
1. 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, umgeleitet`aws-sam-cli`.
Wir empfehlen Ihnen, unsere unterstützten [Installations](install-sam-cli.md) - und [Upgrade-Methoden](#manage-sam-cli-versions-upgrade) 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](https://github.com/Homebrew/homebrew-core/issues)*.
**Um das zu installieren AWS SAMCLI**
1. Führen Sie Folgendes aus:
```
$ brew install aws-sam-cli
```
1. Ü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 der AWS SAMCLI Verwendung von 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
```
1. 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
```
1. Stellen Sie sicher, dass das deinstalliert AWS SAMCLI wurde:
```
$ which sam
sam not found
```
1. 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
```
1. Entfernen Sie die zwischengespeicherten Dateien für das AWS verwaltete Installationsprogramm:
```
$ brew cleanup aws/tap
```
1. Update Homebrew und alle Formeln:
```
$ brew update
```
1. Installieren Sie die von der Community verwaltete Version von: AWS SAMCLI
```
$ brew install aws-sam-cli
```
1. 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 unter[AWS SAMCLIProblembehandlung](sam-cli-troubleshooting.md).