Installation, Aktualisierung und Deinstallation von AWS CLI Version 1 unter macOS - AWS Command Line Interface

Diese Dokumentation bezieht sich ausschließlich auf Version 1 der AWS CLI. Eine Dokumentation zu Version 2 der AWS CLI finden Sie im Benutzerhandbuch für Version 2.

Installation, Aktualisierung und Deinstallation von AWS CLI Version 1 unter macOS

Sie können die AWS Command Line Interface (AWS CLI) Version 1 und ihre Abhängigkeiten unter macOS installieren, indem Sie das gebündelte Installationsprogramm oder pip verwenden.

Voraussetzungen

Bevor Sie die AWS CLI Version 1 unter macOS installieren können, vergewissern Sie sich, dass Python 3.7 oder höher installiert ist. Installationsanweisungen finden Sie auf der Seite „ Python herunterladen im Python-Anfängerhandbuch.

Warnung

Python 2.7 ist durch die Grundlage für Python-Softwareab dem 1. Januar 2020 veraltet. Ab AWS CLI Version 1.20.0 ist eine Mindestversion von Python 3.6 erforderlich.

Um AWS CLI Version 1 mit einer älteren Version von Python zu nutzen, müssen Sie eine frühere Version von AWS CLI Version 1 installieren. Um AWS CLI Version 1, Python-Version mit Matrix-Support anzuzeigen, siehe Anforderungen an Python-Versionen.

Installieren, Aktualisieren und Deinstallieren der AWS CLI Version 1 unter macOS mit dem gebündelten Installationsprogramm

Unter Linux oder macOS können Sie Version 1 der AWS Command Line Interface (AWS CLI) mithilfe des gebündelten Installationsprogramms installieren. Das gebündelte Installationsprogramm enthält alle Abhängigkeiten und kann offline verwendet werden.

Das gebündelte Installationsprogramm unterstützt keine Installation in Pfaden, die Leerzeichen enthalten.

Installieren der AWS CLI Version 1 unter Verwendung des gebündelten Installationspakets mit sudo

Mit den folgenden Schritten können Sie die AWS CLI Version 1 über die Befehlszeile auf jedem oder macOS-Build installieren.

Im Folgenden finden Sie eine Zusammenfassung der Installationsbefehle, die Sie ausschneiden und einfügen können, um sie als einzelnen Befehlssatz auszuführen.

Installieren Sie die neueste Version des AWS CLI mit dem folgenden Befehlsblock.

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

Für eine spezifische Version von AWS CLI, fügen Sie einen Bindestrich und die Versionsnummer an den Dateinamen an. In diesem Beispiel würde der Dateiname für Version 1.16.312 awscli-bundle-1.16.312.zip sein, daraus resultiert der folgende Befehl

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
So installieren Sie die AWS CLI Version 1 mit dem gebündelten Installationspaket
  1. Laden Sie das gebündelte AWS CLI-Installationsprogramm Version 1 auf eine der folgenden Arten herunter.

    • Download über den curl-Befehl.

      Installieren Sie die neueste Version des AWS CLI mit dem folgenden Befehlsblock.

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"

      Für eine spezifische Version von AWS CLI, fügen Sie einen Bindestrich und die Versionsnummer an den Dateinamen an. In diesem Beispiel würde der Dateiname für Version 1.16.312 awscli-bundle-1.16.312.zip sein, daraus resultiert der folgende Befehl

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
    • Download über den direkten Link.

      Für die neueste Version der AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.zip

      Für eine spezifische Version von AWS CLI, fügen Sie einen Bindestrich und die Versionsnummer an den Dateinamen an. In diesem Beispiel würde der Dateiname für Version 1.16.312 awscli-bundle-1.16.312.zip sein, daraus resultiert die folgende URL https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip

  2. Extrahieren (entpacken) Sie die Dateien aus dem Paket. Wenn Sie nicht über unzip verfügen, verwenden Sie den integrierten Paket-Manager der macOS-Verteilung, um es zu installieren.

    $ unzip awscli-bundle.zip
  3. Führen Sie das Installationsprogramm aus. Das Installationsprogramm installiert die AWS CLI unter /usr/local/aws und erstellt den Symlink aws im Ordner /usr/local/bin. Durch die Verwendung der Option -b zum Erstellen eines symbolischen Links entfällt die Notwendigkeit, den Installationsordner in der $PATH-Variablen des Benutzers anzugeben. Somit können alle Benutzer die AWS CLI aufrufen, indem sie von einem beliebigen Verzeichnis aus aws eingeben.

    $ sudo ./awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws

    Standardmäßig wird das Installationsskript unter der Standard-Systemversion von Python ausgeführt. Wenn Sie eine alternative Version von Python installiert haben und diese zum Installieren der AWS CLI verwenden möchten, führen Sie das Installationsskript mit dieser Version aus, indem Sie den absoluten Pfad der ausführbaren Python-Datei verwenden.

    $ sudo /usr/local/bin/python3.7 awscli-bundle/install -i /usr/local/aws -b /usr/local/bin/aws
  4. Überprüfen Sie, ob die AWS CLI ordnungsgemäß installiert wurde.

    $ aws --version aws-cli/1.27.69 Python/3.11.2 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

    Wenn Sie eine Fehlermeldung erhalten, finden Sie weitere Informationen unter Beheben von Fehlern in der AWS CLI.

Installieren der AWS CLI Version 1 unter Verwendung des gebündelten Installationspakets ohne sudo

Wenn Sie nicht über sudo-Berechtigungen verfügen oder die AWS CLI nur für den aktuellen Benutzer installieren möchten, können Sie eine modifizierte Version der vorherigen Befehle verwenden. Die ersten beiden Befehle sind identisch.

Installieren Sie die neueste Version des AWS CLI mit dem folgenden Befehlsblock.

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws

Für eine spezifische Version von AWS CLI, fügen Sie einen Bindestrich und die Versionsnummer an den Dateinamen an. In diesem Beispiel würde der Dateiname für Version 1.16.312 awscli-bundle-1.16.312.zip sein, daraus resultiert der folgende Befehl

$ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip" unzip awscli-bundle.zip ./awscli-bundle/install -b ~/bin/aws
So installieren Sie die AWS CLI Version 1 für den aktuellen Benutzer
  1. Laden Sie das gebündelte AWS CLI-Installationsprogramm Version 1 mit einer der folgenden Methoden herunter.

    • Download über den curl-Befehl.

      Installieren Sie die neueste Version des AWS CLI mit dem folgenden Befehlsblock.

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle.zip" -o "awscli-bundle.zip"

      Für eine spezifische Version von AWS CLI, fügen Sie einen Bindestrich und die Versionsnummer an den Dateinamen an. In diesem Beispiel würde der Dateiname für Version 1.16.312 awscli-bundle-1.16.312.zip sein, daraus resultiert der folgende Befehl

      $ curl "https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip" -o "awscli-bundle.zip"
    • Download über den direkten Link.

      Für die neueste Version der AWS CLI: https://s3.amazonaws.com/aws-cli/awscli-bundle.zip

      Für eine spezifische Version von AWS CLI, fügen Sie einen Bindestrich und die Versionsnummer an den Dateinamen an. In diesem Beispiel würde der Dateiname für Version 1.16.312 awscli-bundle-1.16.312.zip sein, daraus resultiert die folgende URL https://s3.amazonaws.com/aws-cli/awscli-bundle-1.16.312.zip

  2. Extrahieren Sie die Dateien aus dem Paket. Wenn Sie nicht über unzip verfügen, verwenden Sie den integrierten Paket-Manager der Linux-Verteilung, um es zu installieren.

    $ unzip awscli-bundle.zip
  3. Führen Sie das Installationsprogramm aus. Das Installationsprogramm installiert die AWS CLI unter /usr/local/aws und erstellt den Symlink aws im Verzeichnis /usr/local/bin. Der Befehl verwendet den -b-Parameter, um das Verzeichnis anzugeben, in dem das Installationsprogramm die aws-Symlink-Datei ablegt. Sie müssen über Schreibberechtigungen für das angegebene Verzeichnis verfügen.

    $ ./awscli-bundle/install -b ~/bin/aws

    Damit wird die AWS CLI am Standardspeicherort installiert (~/.local/lib/aws) und es wird ein symbolischer Link (Symlink) unter ~/bin/aws erstellt. Stellen Sie sicher, dass ~/bin in Ihrer $PATH-Umgebungsvariablen enthalten ist, damit der Symlink funktioniert.

    $ echo $PATH | grep ~/bin // See if $PATH contains ~/bin (output will be empty if it doesn't) $ export PATH=~/bin:$PATH // Add ~/bin to $PATH if necessary
  4. Stellen Sie sicher, dass der Ordner, in dem die AWS CLI Version 1 installiert ist, Teil Ihrer $PATH-Variablen ist.

    1. Suchen Sie das Profilskript für die Shell in Ihrem Benutzerordner. Wenn Sie nicht sicher sind, welche Shell Sie haben, führen Sie echo $SHELL aus.

      $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
      • Bash.bash_profile, .profile oder .bash_login

      • Zsh.zshrc

      • Tcsh.tcshrc, .cshrc oder .login.

    2. Fügen Sie einen Exportbefehl an das Ende Ihres Profilskripts hinzu und orientieren Sie sich dabei an folgendem Beispiel.

      export PATH=~/.local/bin:$PATH

      Dieser Befehl fügt den Pfad ~/.local/bin in diesem Beispiel vor der bestehenden PATH-Variablen ein.

    3. Laden Sie das Profil erneut in Ihre aktuelle Sitzung, damit die Änderungen wirksam werden.

      $ source ~/.bash_profile
  5. Überprüfen Sie, ob die AWS CLI ordnungsgemäß installiert wurde.

    $ aws --version aws-cli/1.27.69 Python/3.11.2 Linux/4.14.133-113.105.amzn2.x86_64 botocore/1.13

    Wenn Sie eine Fehlermeldung erhalten, finden Sie weitere Informationen unter Beheben von Fehlern in der AWS CLI.

Deinstallieren des gebündelten AWS CLI-Installationsprogramms Version 1

  1. Das gebündelte Installationsprogramm packt alles in das Installationsverzeichnis mit Ausnahme des optionalen Symlinks. Zur Deinstallation müssen Sie nur diese beiden Elemente löschen.

    $ sudo rm -rf /usr/local/aws $ sudo rm /usr/local/bin/aws
  2. (Optional) Entfernen Sie das freigegebene AWS-SDK und die AWS CLI-Einstellungsinformationen im Ordner .aws.

    Warnung

    Diese Einstellungen für Konfiguration und Anmeldeinformationen werden für alle freigegeben AWS-SDKs und die AWS CLI gemeinsam genutzt. Wenn Sie diesen Ordner entfernen, kann von keinen AWS-SDKs aus, die sich noch auf Ihrem System befinden, auf diese Einstellungen zugegriffen werden.

    Der Standardspeicherort des Ordners .aws unterscheidet sich je nach Plattform, standardmäßig befindet sich der Ordner in ~/.aws/. Wenn Ihr Benutzer über Schreibberechtigungen für dieses Verzeichnis verfügt, müssen Sie sudo nicht verwenden.

    $ sudo rm ~/.aws/

Installieren, Aktualisieren und Deinstallieren der AWS CLI Version 1 mithilfe von pip

Sie können pip direkt zur Installation der AWS CLI verwenden.

Installieren von pip

Wenn Sie pip noch nicht installiert haben, können Sie es mit dem Skript installieren, das von der Python Packaging Authority bereitgestellt wird. Führen Sie pip --version aus, um zu überprüfen, ob Ihre Version von Linux bereits Python und pip enthält. Wir empfehlen Ihnen, den pip3-Befehl zu verwenden, wenn Sie Python-Version 3 oder höher installiert haben.

  1. Laden Sie das Installationsskript mit dem Befehl curl herunter. Der folgende Befehl verwendet den Parameter -O (Großbuchstabe „O“), um anzugeben, dass die heruntergeladene Datei im aktuellen Ordner unter Verwendung desselben Namens auf dem Remote-Host gespeichert werden soll.

    $ curl -O https://bootstrap.pypa.io/get-pip.py
  2. Führen Sie das Skript mit dem python- oder python3-Befehl aus, um die aktuelle Version von pip und andere erforderliche Supportpakete herunterzuladen. Wenn Sie den Schalter --user einschließen, installiert das Skript pip im Pfad ~/.local/bin.

    $ python3 get-pip.py --user

Installieren und Aktualisieren der AWS CLI mithilfe von pip

  1. Verwenden Sie den pip- oder pip3-Befehl, um die AWS CLI zu installieren. Wir empfehlen Ihnen, bei Verwendung von Python-Version 3 oder höher den pip3-Befehl zu verwenden.

    Installieren Sie die neueste Version des AWS CLI mit dem folgenden Befehlsblock.

    $ pip3 install awscli --upgrade --user

    Fügen Sie für eine spezifische Version der AWS CLI zwei Gleichheitszeichen = und die Versionsnummer an den Dateinamen an. In diesem Beispiel würde der Dateiname für Version 1.16.312 ==1.16.312 lauten, daraus resultiert der folgende Befehl

    $ pip3 install awscli==1.16.312 --upgrade --user
    Anmerkung

    Verwenden Sie geeignete Anführungszeichenregeln für Ihr Terminal. Um das Zeichen = verwenden zu können, müssen Sie möglicherweise einfache oder doppelte Anführungszeichen zur korrekten Maskierung verwenden. Im folgenden Beispiel werden einfache Anführungszeichen zur Maskierung verwendet:

    $ pip3 install 'awscli==1.16.312' --upgrade --user
  2. Überprüfen Sie, ob die AWS CLI ordnungsgemäß installiert wurde.

    $ aws --version aws-cli/1.27.69 Python/3.11.2 Darwin/18.7.0 botocore/1.13

    Wenn das Programm nicht gefunden wird, fügen Sie es dem Befehlszeilenpfad hinzu.

Hinzufügen der ausführbaren AWS CLI-Datei Version 1 zum macOS-Befehlszeilenpfad

Nach der Installation mit pip müssen Sie möglicherweise das Programm aws zur PATH-Umgebungsvariablen des Betriebssystems hinzufügen. Der Speicherort des Programms hängt davon ab, wo Python installiert ist.

Beispiel Installationsspeicherort der AWS CLI – macOS mit Python 3.6 und pip (Benutzermodus)
~/Library/Python/3.7/bin

Geben Sie anstelle der Version in dem Beispiel oben Ihre Python-Version an.

Wenn Sie nicht wissen, wo Python installiert ist, führen Sie which python aus

$ which python /usr/local/bin/python

Die Ausgabe ist möglicherweise der Pfad zu einem Symlink, nicht das tatsächliche Programm. Führen Sie ls -al aus, um festzustellen, wohin dieser verweist.

$ ls -al /usr/local/bin/python ~/Library/Python/3.7/bin/python3.7

pip installiert Programme in demselben Ordner, der auch die Python-Anwendung enthält. Fügen Sie diesen Ordner Ihrer PATH-Variablen hinzu.

So ändern Sie die Variable PATH
  1. Suchen Sie das Profilskript der Shell in Ihrem Benutzerverzeichnis. Wenn Sie nicht sicher sind, welche Shell Sie haben, führen Sie echo $SHELL aus.

    $ ls -a ~ . .. .bash_logout .bash_profile .bashrc Desktop Documents Downloads
    • Bash.bash_profile, .profile oder .bash_login

    • Zsh.zshrc

    • Tcsh.tcshrc, .cshrc oder .login

  2. Fügen Sie dem Profilskript einen Exportbefehl hinzu.

    export PATH=~/.local/bin:$PATH

    Dieser Befehl fügt der aktuellen PATH-Variablen einen Pfad, in diesem Beispiel ~/.local/bin, hinzu.

  3. Laden Sie hochgeladene Profil in Ihre aktuelle Sitzung.

    $ source ~/.bash_profile

Deinstallieren der AWS CLI mithilfe von pip

  1. Wenn Sie die AWS CLI Version 1 mithilfe von pip installiert haben, müssen Sie auch mit pip deinstallieren.

    $ pip uninstall awscli

    Wenn Sie Version Python 2 oder 3 verwenden, müssen Sie möglicherweise den Befehl pip2 oder pip3 verwenden. Verwenden Sie den aws --version-Befehl, um die Python-Version zu ermitteln, die Ihrer installierten AWS CLI-Version 1 zugeordnet ist.

    $ pip3 uninstall awscli

    Möglicherweise müssen Sie das Eingabeaufforderungsfenster oder den Computer neu starten, um alle Dateien zu entfernen.

  2. (Optional) Entfernen Sie das freigegebene AWS-SDK und die AWS CLI-Einstellungsinformationen im Ordner .aws.

    Warnung

    Diese Einstellungen für Konfiguration und Anmeldeinformationen werden für alle freigegeben AWS-SDKs und die AWS CLI gemeinsam genutzt. Wenn Sie diesen Ordner entfernen, kann von keinen AWS-SDKs aus, die sich noch auf Ihrem System befinden, auf diese Einstellungen zugegriffen werden.

    Der Standardspeicherort des Ordners .aws unterscheidet sich je nach Plattform, standardmäßig befindet sich der Ordner in ~/.aws/. Wenn Ihr Benutzer über Schreibberechtigungen für dieses Verzeichnis verfügt, müssen Sie sudo nicht verwenden.

    $ sudo rm ~/.aws/

Beheben von Fehlern beim Installieren und Deinstallieren der AWS CLI

Wenn nach der Installation oder Deinstallation der AWS CLI Fehler auftreten, finden Sie unter Beheben von Fehlern in der AWS CLI Informationen zur Fehlerbehebung. Die wichtigsten Maßnahmen zur Fehlerbehebung finden Sie unter Fehler aufgrund eines nicht gefundenen Befehls, Der Befehl „aws --version“ gibt eine andere als die installierte Version zurück und Der Befehl „aws --version“ gibt nach der Deinstallation der AWS CLI eine Version zurück.