Warum aus der Quelle erstellen?Schnelle Schritte Schritt 1: Einrichten aller Anforderungen Schritt 2: Konfiguration der AWS CLI -Quellinstallation Schritt 3: Erstellen der AWS CLI Schritt 4: Installieren der AWS CLI Schritt 5: Überprüfen der AWS CLI -Installation Workflow-Beispiele Behebung von AWS CLI Installations- und Deinstallationsfehlern Nächste Schritte

Erstellen und installieren Sie das AWS CLI aus dem Quellcode

In diesem Thema wird beschrieben, wie Sie die neueste Version der AWS Command Line Interface (AWS CLI) auf unterstützten Betriebssystemen aus der Quelle installieren oder aktualisieren.

Informationen zu den neuesten Versionen von AWS CLI finden Sie im Changelog für AWS CLI Version 2. GitHub

Wichtig

AWS CLI Die Versionen 1 und 2 verwenden denselben aws Befehlsnamen. Wenn Sie AWS CLI Version 1 bereits installiert haben, finden Sie weitere Informationen unterMigrieren von AWS CLI-Version 1 zu Version 2.

Themen

Warum aus der Quelle erstellen?
Schnelle Schritte
Schritt 1: Einrichten aller Anforderungen
Schritt 2: Konfiguration der AWS CLI -Quellinstallation
Schritt 3: Erstellen der AWS CLI
Schritt 4: Installieren der AWS CLI
Schritt 5: Überprüfen der AWS CLI -Installation
Workflow-Beispiele
Behebung von AWS CLI Installations- und Deinstallationsfehlern
Nächste Schritte

Warum aus der Quelle erstellen?

Das AWS CLI ist als vorgefertigtes Installationsprogramm für die meisten Plattformen und Umgebungen sowie als Docker-Image verfügbar.

Im Allgemeinen decken diese Installationsprogramme die meisten Anwendungsfälle ab. Die Anweisungen für die Installation aus der Quelle sollen bei den Anwendungsfällen helfen, die unsere Installationsprogramme nicht abdecken. Einige dieser Anwendungsfälle sind:

Die vordefinierten Installationsprogramme unterstützen Ihre Umgebung nicht. Beispielsweise wird ARM 32-Bit von den vordefinierten Installationsprogrammen nicht unterstützt.
Die vordefinierten Installationsprogramme haben Abhängigkeiten, die Ihrer Umgebung fehlen. Zum Beispiel verwendet Alpine Linux musl, aber die aktuellen Installationsprogramme erfordern glibc, sodass die vordefinierten Installationsprogramme nicht sofort funktionieren.
Die vordefinierten Installationsprogramme benötigen Ressourcen, auf die Ihre Umgebung den Zugriff beschränkt. Beispielsweise gewähren sicherheitsgeschützte Systeme möglicherweise keine Berechtigungen für gemeinsam genutzten Speicher. Dies ist für das eingefrorene aws-Installationsprogramm jedoch erforderlich.
Die vordefinierten Installationsprogramme sind oft ein Hindernis für die Maintainer in Paketmanagern, da die vollständige Kontrolle über den Erstellungsprozess von Code und Paketen bevorzugt wird. Das Erstellen aus dem Quellcode ermöglicht Distributionsbetreuern einen optimierten Prozess, um die Daten auf dem neuesten Stand zu halten. AWS CLI Durch die Aktivierung von Maintainern stehen Kunden mehr up-to-date Versionen von zur Verfügung, AWS CLI wenn sie über einen Paketmanager eines Drittanbieters wie, und installieren. brew yum apt
Kunden, die AWS CLI Funktionen patchen, müssen das AWS CLI aus dem Quellcode erstellen und installieren. Dies ist besonders wichtig für Community-Mitglieder, die Änderungen, die sie an der Quelle vorgenommen haben, testen möchten, bevor sie die Änderung zum AWS CLI GitHub Repository beitragen.

Schnelle Schritte

Anmerkung

Es wird davon ausgegangen, dass alle Codebeispiele aus dem Stammverzeichnis des Quellverzeichnisses ausgeführt werden.

Um den Quelltext zu erstellen und AWS CLI zu installieren, folgen Sie den Schritten in diesem Abschnitt. Die AWS CLI nutzt GNU Autotools zur Installation aus der Quelle. Im einfachsten Fall AWS CLI kann das aus dem Quellcode installiert werden, indem die standardmäßigen Beispielbefehle im Stammverzeichnis des AWS CLI GitHub Repositorys ausgeführt werden.

Richten Sie alle Anforderungen für Ihre Umgebung ein. Dies beinhaltet die Möglichkeit, von GNU Autotools generierte Dateien auszuführen, wobei Python 3.8 oder höher installiert ist.
Navigieren Sie in Ihrem Terminal zur obersten Ebene des AWS CLI Quellordners und führen Sie den ./configure Befehl aus. Dieser Befehl überprüft das System auf alle erforderlichen Abhängigkeiten und generiert eine Makefile für den Aufbau und die Installation auf der AWS CLI Grundlage der erkannten und angegebenen Konfigurationen.
Linux and macOS
Das folgende ./configure Befehlsbeispiel legt die Build-Konfiguration für die AWS CLI Verwendung der Standardeinstellungen fest.
```
$ ./configure
```
Windows PowerShell
Bevor Sie Befehle ausführen, die MSYS2 aufrufen, müssen Sie Ihr aktuelles Arbeitsverzeichnis sichern:
```
PS C:\> $env:CHERE_INVOKING = 'yes'
```
Verwenden Sie dann das folgende ./configure Befehlsbeispiel, um die Build-Konfiguration für die AWS CLI Verwendung Ihres lokalen Pfads zu Ihrer ausführbaren Python-Datei, die Installation in C:\Program Files\ AWSCLI und das Herunterladen aller Abhängigkeiten festzulegen.
```
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps "
```
Einzelheiten, verfügbare Konfigurationsoptionen und Informationen zu Standardeinstellungen finden Sie im Abschnitt Schritt 2: Konfiguration der AWS CLI -Quellinstallation .
Führen Sie den Befehl make aus. Dieser Befehl erstellt die AWS CLI gemäß Ihren Konfigurationseinstellungen.

Das folgende make Befehlsbeispiel erstellt mit Standardoptionen und verwendet Ihre vorhandenen ./configure-Einstellungen.
Linux and macOS
```
$ make
```
Windows PowerShell
```
PS C:\> C:\msys64\usr\bin\bash -lc "make" 
```
Einzelheiten und verfügbare Build-Optionen finden Sie im Abschnitt Schritt 3: Erstellen der AWS CLI.
Führen Sie den Befehl make install aus. Mit diesem Befehl wird Ihre entwickelte AWS CLI am konfigurierten Ort in Ihrem System installiert.

Das folgende make install-Befehlsbeispiel installiert Ihre entwickelte AWS CLI und erstellt Symlinks an Ihren konfigurierten Speicherorten unter Verwendung der Standardbefehlseinstellungen.
Linux and macOS
```
$ make install
```
Windows PowerShell
```
PS C:\> C:\msys64\usr\bin\bash -lc "make install" 
```
Fügen Sie nach der Installation den Pfad AWS CLI wie folgt hinzu:
```
PS C:\> $Env: PATH +=";C:\Program Files\AWSCLI\bin\"
```
Einzelheiten und verfügbare Installationsoptionen finden Sie im Abschnitt Schritt 4: Installieren der AWS CLI.
Bestätigen Sie die AWS CLI erfolgreiche Installation mit dem folgenden Befehl:
```
$ aws --version
aws-cli/2.15.30 Python/3.11.6 Windows/10 exe/AMD64 prompt/off
```
Schritte zur Behebung von Installationsfehlern finden Sie im Abschnitt Behebung von AWS CLI Installations- und Deinstallationsfehlern.

Schritt 1: Einrichten aller Anforderungen

Um den AWS CLI From-Quellcode zu erstellen, müssen Sie zuvor Folgendes erledigen:

Anmerkung

Es wird davon ausgegangen, dass alle Codebeispiele aus dem Stammverzeichnis des Quellverzeichnisses ausgeführt werden.

Laden Sie die AWS CLI Quelle herunter, indem Sie entweder das AWS CLI GitHub Repository forken oder den Quell-Tarball herunterladen. Siehe eine der folgenden Anweisungen:

Forke und klone das AWS CLI Repository von. GitHub Weitere Informationen finden Sie in den GitHubDokumenten unter Forken eines Repositorys.

Laden Sie den Quell-Tarball unter https://awscli.amazonaws.com/awscli.tar.gz herunter und extrahieren Sie den Inhalt mit den folgenden Befehlen:


$ curl -o awscli.tar.gz https://awscli.amazonaws.com/awscli.tar.gz
$ tar -xzf awscli.tar.gz

Anmerkung

Verwenden Sie das folgende Linkformat, um eine bestimmte Version herunterzuladen: https://awscli.amazonaws.com/awscli-Versionsnummer.tar.gz, um eine bestimmte Version herunterzuladen.

Für Version 2.10.0 lautet der Link beispielsweise wie folgt: https://awscli.amazonaws.com/awscli-2.10.0.tar.gz

Quellversionen sind ab Version 2.10.0 von der AWS CLI verfügbar.

(Optional) Überprüfen der Integrität Ihrer heruntergeladenen Zip-Datei anhand der folgenden Schritten:

Sie können die folgenden Schritte verwenden, um die Signaturen mithilfe des GnuPG-Tools zu überprüfen.

Die AWS CLI .zip Installationspaketdateien sind mithilfe von PGP-Signaturen kryptografisch signiert. Wenn die Dateien beschädigt oder verändert wurden, schlägt diese Verifizierung fehl und Sie sollten nicht mit der Installation fortfahren.
Laden Sie den gpg-Befehl herunter und installieren Sie diesen mit Ihrem Paket-Manager. Weitere Informationen zu GnuPG finden Sie auf der GnuPG-Website.

Um die öffentliche Schlüsseldatei zu erstellen, müssen Sie eine Textdatei erstellen und den folgenden Text einfügen.

Als Referenz finden Sie im Folgenden die Details des öffentlichen Schlüssels.


Key ID:           A6310ACC4672
Type:             RSA
Size:             4096/4096
Created:          2019-09-18
Expires:          2023-09-17
User ID:          AWS CLI Team <aws-cli@amazon.com>
Key fingerprint:  FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C

Importieren Sie den AWS CLI öffentlichen Schlüssel mit dem folgenden Befehl und ersetzen Sie ihn durch den Dateinamen des öffentlichen public-key-file-nameSchlüssels, den Sie erstellt haben.


$ gpg --import public-key-file-name
gpg: /home/username/.gnupg/trustdb.gpg: trustdb created
gpg: key A6310ACC4672475C: public key "AWS CLI Team <aws-cli@amazon.com>" imported
gpg: Total number processed: 1
gpg:               imported: 1

Laden Sie die AWS CLI Signaturdatei für das Paket herunter, das Sie unter https://awscli.amazonaws.com/awscli.tar.gz.sig heruntergeladen haben. Sie hat denselben Pfad und denselben Namen wie die Tarball-Datei, der sie entspricht, hat aber die Erweiterung .sig. Speichern Sie sie im gleichen Pfad wie die Tarball-Datei. Oder verwenden Sie den folgenden Befehlsblock:
```
$ curl -o awscliv2.sig https://awscli.amazonaws.com/awscli.tar.gz.sig
```
Überprüfen Sie die Signatur und übergeben Sie sowohl den heruntergeladenen .sig- als auch den .zip-Dateinamen als Parameter an den gpg-Befehl.
```
$ gpg --verify awscliv2.sig awscli.tar.gz
```
Die Ausgabe sollte in etwa folgendermaßen aussehen:
```
gpg: Signature made Mon Nov  4 19:00:01 2019 PST
gpg:                using RSA key FB5D B77F D5C1 18B8 0511 ADA8 A631 0ACC 4672 475C
gpg: Good signature from "AWS CLI Team <aws-cli@amazon.com>" [unknown]
gpg: WARNING: This key is not certified with a trusted signature!
gpg:          There is no indication that the signature belongs to the owner.
Primary key fingerprint: FB5D B77F D5C1 18B8 0511  ADA8 A631 0ACC 4672 475C
```
Wichtig
Die Warnung in der Ausgabe wird erwartet und ist kein Hinweis auf ein Problem. Sie tritt auf, weil keine Vertrauenskette zwischen Ihrem persönlichen PGP-Schlüssel (falls Sie einen haben) und dem AWS CLI -PGP-Schlüssel besteht. Weitere Informationen finden Sie unter Web of trust (Netz des Vertrauens).

Weniger anzeigen

Sie haben eine Umgebung, in der von GNU Autotools generierte Dateien wie configure und Makefile ausgeführt werden können. Diese Dateien sind auf POSIX-Plattformen weitgehend portabel.
Linux and macOS

Wenn Autotools in Ihrer Umgebung noch nicht installiert sind oder Sie sie aktualisieren müssen, folgen Sie den Installationsanweisungen unter Wie installiere ich die Autotools (als Benutzer)? oder Grundinstallation in der GNU-Dokumentation.

Windows PowerShell
Warnung
Wir empfehlen, dass Sie in einer Windows-Umgebung die vordefinierten Installationsprogramme verwenden. Anweisungen zur Installation der vordefinierten Installationsprogramme finden Sie unter Installieren oder aktualisieren Sie auf die neueste Version von AWS CLI

Da Windows nicht mit einer POSIX-kompatiblen Shell geliefert wird, müssen Sie zusätzliche Software installieren, um die Version AWS CLI aus dem Quellcode zu installieren. MSYS2 bietet eine Sammlung von Tools und Bibliotheken, die beim Erstellen und Installieren von Windows-Software helfen, insbesondere für das POSIX-basierte Skripting, das Autotools verwendet.
Installieren Sie MSYS2. Informationen zur Installation und Verwendung von MSYS2 finden Sie in den Installations- und Nutzungsanweisungen in der MSYS2-Dokumentation.

Öffnen Sie das MSYS2-Terminal und installieren Sie Autotools mit dem folgenden Befehl.

$ pacman -S autotools
Anmerkung
Wenn Sie die Codebeispiele zum Konfigurieren, Erstellen und Installieren in diesem Handbuch für Windows verwenden, wird der standardmäßige MSYS2-Installationspfad von C:\msys64\usr\bin\bash angenommen. Wenn Sie MSYS2 innerhalb von aufrufen, verwenden PowerShell Sie das folgende Format, wobei der Befehl bash in Anführungszeichen steht:
PS C:\> C:\msys64\usr\bin\bash -lc "command example"
Das folgende Befehlsbeispiel ruft den ./configure-Befehl auf.
PS C:\> C:\msys64\usr\bin\bash -lc "./configure"
Python 3.8-Interpreter oder höher ist installiert. Die erforderliche Python-Mindestversion folgt denselben Zeitplänen wie die offizielle Python-Supportrichtlinie für AWS SDKs und Tools. Ein Interpreter wird erst 6 Monate nach seinem Datum unterstützt. end-of-support
(Optional) Installieren Sie alle Build- und Laufzeit-Python-Bibliotheksabhängigkeiten der AWS CLI. Der ./configure-Befehl informiert Sie darüber, ob Ihnen Abhängigkeiten fehlen und wie Sie diese installieren.

Sie können diese Abhängigkeiten über die Konfiguration automatisch installieren und verwenden. Weitere Informationen finden Sie unter Herunterladen von Abhängigkeiten.

Schritt 2: Konfiguration der AWS CLI -Quellinstallation

Die Konfiguration für den Aufbau und die Installation von AWS CLI wird mithilfe des configure Skripts angegeben. Für die Dokumentation aller Konfigurationsoptionen führen Sie das configure-Skript mit der --help-Option aus:

Installationsspeicherort

Die Quellinstallation von AWS CLI verwendet zwei konfigurierbare Verzeichnisse zur Installation von AWS CLI:

libdir- Übergeordnetes Verzeichnis, in dem das installiert AWS CLI werden soll. Der Pfad zur AWS CLI Installation ist<libdir-value>/aws-cli. Der libdir-Standardwert für Linux und macOS ist /usr/local/lib zur Markierung des Standardinstallationsverzeichnisses /usr/local/lib/aws-cli.
bindir- Verzeichnis, in dem die AWS CLI ausführbaren Dateien installiert sind. Der Standardspeicherort ist /usr/local/bin.

Die folgenden configure-Optionen steuern die verwendeten Verzeichnisse:

--prefix – Legt das Verzeichnispräfix fest, das für die Installation verwendet werden soll. Der Standardwert für Linux und macOS ist /usr/local.
--libdir – Legt den für die Installation der AWS CLI zu verwendenden libdir fest. Der Standardwert ist <prefix-value>/lib. Wenn --libdir und --prefix nicht angegeben sind, ist die Standardeinstellung für Linux und macOS /usr/local/lib/.
--bindir- Legt fest, welches für bindir die Installation der AWS CLI aws und aws_completer der ausführbaren Dateien verwendet werden soll. Der Standardwert ist <prefix-value>/bin. Wenn bindir und --prefix nicht angegeben sind, ist die Standardeinstellung für Linux und macOS /usr/local/bin/.

Python-Interpreter

Anmerkung

Es wird dringend empfohlen, den Python-Interpreter bei der Installation für Windows anzugeben.

Das ./configure Skript wählt automatisch einen installierten Interpreter für Python 3.8 oder höher aus, der beim Erstellen und Ausführen des Makros Using the AM_PATH_PYTHONAutoconf AWS CLI verwendet wird.

Der zu verwendende Python-Interpreter kann beim Ausführen des configure-Skripts mithilfe der PYTHON-Umgebungsvariablen explizit festgelegt werden:

Herunterladen von Abhängigkeiten

Standardmäßig ist es erforderlich, dass alle Build- und Laufzeit-Abhängigkeiten der AWS CLI bereits im System installiert sind. Dies schließt alle Abhängigkeiten der Python-Bibliothek ein. Alle Abhängigkeiten werden überprüft, wenn das configure-Skript ausgeführt wird, und wenn dem System irgendwelche Python-Abhängigkeiten fehlen, meldet das configure-Skript einen Fehler.

Im folgenden Codebeispiel treten Fehler auf, wenn Ihrem System Abhängigkeiten fehlen:

Linux and macOS


$ ./configure 
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in <module>
    main()
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
    parsed_args.func(parsed_args)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
    validate_env(parsed_args.artifact)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
    raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:

awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)

We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.

If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'

configure: error: "Python dependencies not met."

Windows PowerShell


PS C:\> C:\msys64\usr\bin\bash -lc "./configure" 
checking for a Python interpreter with version >= 3.8... python
checking for python... /Users/username/.envs/env3.11/bin/python
checking for python version... 3.11
checking for python platform... darwin
checking for GNU default python prefix... ${prefix}
checking for GNU default python exec_prefix... ${exec_prefix}
checking for python script directory (pythondir)... ${PYTHON_PREFIX}/lib/python3.11/site-packages
checking for python extension module directory (pyexecdir)... ${PYTHON_EXEC_PREFIX}/lib/python3.11/site-packages
checking for --with-install-type... system-sandbox
checking for --with-download-deps... Traceback (most recent call last):
  File "<frozen runpy>", line 198, in _run_module_as_main
  File "<frozen runpy>", line 88, in _run_code
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 125, in <module>
    main()
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 121, in main
    parsed_args.func(parsed_args)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/__main__.py", line 49, in validate
    validate_env(parsed_args.artifact)
  File "/Users/username/aws-code/aws-cli/./backends/build_system/validate_env.py", line 68, in validate_env
    raise UnmetDependenciesException(unmet_deps, in_venv)
validate_env.UnmetDependenciesException: Environment requires following Python dependencies:

awscrt (required: ('>=0.12.4', '<0.17.0')) (version installed: None)

We recommend using --with-download-deps flag to automatically create a virtualenv and download the dependencies.

If you want to manage the dependencies yourself instead, run the following pip command:
/Users/username/.envs/env3.11/bin/python -m pip install --prefer-binary 'awscrt>=0.12.4,<0.17.0'

configure: error: "Python dependencies not met."

Verwenden Sie die Option --with-download-deps, um die erforderlichen Python-Abhängigkeiten automatisch zu installieren. Wenn Sie dieses Flag verwenden, führt der Build-Prozess Folgendes aus:

Überspringen der Abhängigkeitsprüfung der Python-Bibliothek.
Konfiguriert die Einstellungen so, dass alle erforderlichen Python-Abhängigkeiten heruntergeladen und nur die heruntergeladenen Abhängigkeiten verwendet werden, um sie AWS CLI während des make Builds zu erstellen.

Das folgende Konfigurationsbefehlsbeispiel verwendet die Option --with-download-deps zum Herunterladen und Verwenden der Python-Abhängigkeiten:

Installationstyp

Der Quellinstallationsprozess unterstützt die folgenden Installationstypen:

system-sandbox— (Standard) Erstellt eine isolierte virtuelle Python-Umgebung, installiert die AWS CLI in der virtuellen Umgebung und stellt Symlinks zur aws und aws_completer ausführbaren Datei in der virtuellen Umgebung her. Diese Installation von AWS CLI hängt für seine Laufzeit direkt vom ausgewählten Python-Interpreter ab.

Dies ist ein einfacher Installationsmechanismus, um das AWS CLI auf einem System zu installieren. Er folgt den bewährten Python-Methoden, indem die Installation in einer virtuellen Umgebung Sandboxing ausgeführt wird. Diese Installation ist für Kunden gedacht, die den AWS CLI Quellcode so reibungslos wie möglich installieren möchten, wobei die Installation an Ihre Python-Installation gekoppelt ist.
portable-exe- Friert das AWS CLI in eine eigenständige ausführbare Datei ein, die an Umgebungen mit ähnlichen Architekturen verteilt werden kann. Dies ist derselbe Prozess, der verwendet wird, um die offiziellen vordefinierten ausführbaren Dateien der AWS CLI zu generieren. Das portable-exe friert eine Kopie des Python-Interpreters ein, der im configure-Schritt ausgewählt wurde, um ihn für die Laufzeit der AWS CLI zu verwenden. Dadurch kann sie auf andere Computer verschoben werden, die möglicherweise keinen Python-Interpreter haben.

Diese Art von Builds ist nützlich, da Sie sicherstellen können, dass Ihre AWS CLI Installation nicht an die installierte Python-Version der Umgebung gekoppelt ist, und Sie können einen Build auf ein anderes System verteilen, auf dem Python möglicherweise noch nicht installiert ist. Auf diese Weise können Sie die Abhängigkeiten und die Sicherheit der von Ihnen verwendeten AWS CLI ausführbaren Dateien kontrollieren.

Um den Installationstyp zu konfigurieren, verwenden Sie die Option --with-install-type und geben Sie einen Wert von portable-exe oder system-sandbox an.

Der folgende ./configure-Befehl gibt den Wert portable-exe an:

Schritt 3: Erstellen der AWS CLI

Verwenden Sie den make Befehl, um das AWS CLI mit Ihren Konfigurationseinstellungen zu erstellen:

Anmerkung

Wenn Sie den `make`-Befehl verwenden, werden die folgenden Schritte im Hintergrund ausgeführt:

Eine virtuelle Umgebung wird im Build-Verzeichnis mithilfe des venv-Python-Moduls erstellt. Die virtuelle Umgebung wird mit einer Version von Pip gebootet, die in der Python-Standardbibliothek angeboten wird.
Kopieren der Abhängigkeiten der Python-Bibliothek. Je nachdem, ob das --with-download-deps-Flag im configure-Befehl angegeben ist, führt dieser Schritt eine der folgenden Aktionen aus:
- Der --with-download-deps wird angegeben. Python-Abhängigkeiten sind Pip-installiert. Dies beinhaltet wheel, setuptools und alle AWS CLI -Laufzeitabhängigkeiten. Wenn Sie das portable-exe erstellen, wird pyinstaller installiert. Diese Anforderungen sind alle in den aus pip-compile generierten Sperrdateien spezifiziert.
- Das --with-download-deps wird nicht angegeben. Python-Bibliotheken aus dem Site-Paket des Python-Interpreters sowie alle Skripte (z. B. pyinstaller) werden in die virtuelle Umgebung kopiert, die für den Build verwendet wird.
Wird pip install direkt auf der AWS CLI Codebasis ausgeführt, um einen Offline-Build im Baum durchzuführen und die virtuelle Umgebung AWS CLI in der Build-Umgebung zu installieren. Diese Installation verwendet die Pip-Flags -- no-build-isolation , --use-feature= in-tree-build , -- und. no-cache-dir --no-index
(Optional) Wenn das portable-exe im configure-Befehl auf --install-type gesetzt ist, wird eine eigenständige ausführbare Datei mithilfe von pyinstaller erstellt.

Weniger anzeigen

Schritt 4: Installieren der AWS CLI

Der make install Befehl installiert Ihren Build am konfigurierten Speicherort AWS CLI auf dem System.

Die make install-Regel unterstützt die DESTDIR-Variable. Wenn angegeben, setzt diese Variable den angegebenen Pfad dem bereits konfigurierten Installationspfad bei der Installation der AWS CLI voran. Standardmäßig ist für diese Variable kein Wert festgelegt.

Anmerkung

Bei der Ausführung von `make install` werden die folgenden Schritte im Hintergrund ausgeführt

Verschieben einer der folgenden Dateien in das konfigurierte Installationsverzeichnis:
- Wenn der Installationstyp system-sandbox ist, wird Ihre erstellte virtuelle Umgebung verschoben.
- Wenn der Installationstyp portable-exe ist, wird Ihre erstellte eigenständige ausführbare Datei verschoben.
Erzeugt Symlinks sowohl für die ausführbaren aws- als auch für die aws_completer-Dateien in Ihrem konfigurierten Bin-Verzeichnis.

Weniger anzeigen

Schritt 5: Überprüfen der AWS CLI -Installation

Bestätigen Sie die AWS CLI erfolgreiche Installation mit dem folgenden Befehl:


$ aws --version
aws-cli/2.15.30 Python/3.11.6 Windows/10 exe/AMD64 prompt/off

Wenn der aws-Befehl nicht erkannt wird, müssen Sie möglicherweise Ihr Terminal neu starten, damit die neuen Symlinks aktualisiert werden. Wenn Sie nach der Installation oder Deinstallation von auf weitere Probleme stoßen AWS CLI, finden Sie unter Fehler AWS CLI beheben Allgemeine Schritte zur Fehlerbehebung

Workflow-Beispiele

Dieser Abschnitt enthält einige grundlegende Workflow-Beispiele für die Installation aus der Quelle.

Grundlegende Linux- und macOS-Installation

Das folgende Beispiel zeigt einen grundlegenden Installationsablauf, bei dem der im Standardverzeichnis von /usr/local/lib/aws-cli installiert AWS CLI wird.


$ cd path/to/cli/respository/
$ ./configure
$ make
$ make install

Automatisierte Windows-Installation

Anmerkung

Sie müssen ihn PowerShell als Administrator ausführen, um diesen Workflow verwenden zu können.

MSYS2 kann automatisiert in einer CI-Einstellung verwendet werden, siehe Verwenden von MSYS2 in CI in der MSYS2-Dokumentation.

Downloaded Tarball

Laden Sie die Datei awscli.tar.gz herunter und installieren Sie die AWS CLI. Ersetzen Sie die folgenden Pfade, wenn Sie die folgenden Befehle verwenden:

C:\msys64\usr\bin\bash durch den Speicherort Ihres MSYS2-Pfads.
.\awscli-2.x.x\ durch den Namen des entpackten awscli.tar.gz-Ordners.
PYTHON='C:\path\to\python.exe' durch Ihren lokalen Python-Pfad.

Das folgende Codebeispiel automatisiert das Erstellen und Installieren des Formulars PowerShell mithilfe AWS CLI von MSYS2 und gibt an, welche lokale Python-Installation verwendet werden soll:


PS C:\> curl -o awscli.tar.gz https://awscli.amazonaws.com/awscli.tar.gz  #  Download the awscli.tar.gz file in the current working directory
PS C:\> tar -xvzf .\awscli.tar.gz #  Extract awscli.tar.gz file
PS C:\> cd .\awscli-2.x.x\ #  Navigate to the root of the extracted files
PS C:\> $env:CHERE_INVOKING = 'yes' #  Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps " 
PS C:\> C:\msys64\usr\bin\bash  -lc "make"
PS C:\> C:\msys64\usr\bin\bash  -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version
aws-cli/2.15.30 Python/3.11.6 Windows/10 source-sandbox/AMD64 prompt/off

GitHub Repository

Laden Sie die Datei awscli.tar.gz herunter und installieren Sie die AWS CLI. Ersetzen Sie die folgenden Pfade, wenn Sie die folgenden Befehle verwenden:

C:\msys64\usr\bin\bash durch den Speicherort Ihres MSYS2-Pfads.
C:path\to\cli\repository\mit dem Pfad zu Ihrem AWS CLI geklonten Repository von. GitHub Weitere Informationen finden Sie in den Dokumenten unter Fork a repo GitHub
PYTHON='C:\path\to\python.exe' durch Ihren lokalen Python-Pfad.

Das folgende Codebeispiel automatisiert das Erstellen und Installieren des Formulars PowerShell mithilfe AWS CLI von MSYS2 und gibt an, welche lokale Python-Installation verwendet werden soll:


PS C:\> cd C:path\to\cli\repository\
PS C:\> $env:CHERE_INVOKING = 'yes' #  Preserve the current working directory
PS C:\> C:\msys64\usr\bin\bash  -lc " PYTHON='C:\path\to\python.exe' ./configure --prefix='C:\Program Files\AWSCLI' --with-download-deps " 
PS C:\> C:\msys64\usr\bin\bash  -lc "make"
PS C:\> C:\msys64\usr\bin\bash  -lc "make install"
PS C:\> $Env:PATH +=";C:\Program Files\AWSCLI\bin\"
PS C:\> aws --version

Alpine Linux-Container

Im Folgenden finden Sie ein Beispiel für ein Dockerfile, das verwendet werden kann, um eine funktionierende Installation von AWS CLI in einem Alpine-Linux-Container als Alternative zu vorgefertigten Binärdateien für Alpine zu erhalten. Wenn Sie dieses Beispiel verwenden, ersetzen Sie es durch die gewünschte AWSCLI_VERSIONVersionsnummer: AWS CLI


FROM python:3.8-alpine AS builder

ENV AWSCLI_VERSION=2.10.1

RUN apk add --no-cache \
    curl \
    make \
    cmake \
    gcc \
    g++ \
    libc-dev \
    libffi-dev \
    openssl-dev \
    && curl https://awscli.amazonaws.com/awscli-${AWSCLI_VERSION}.tar.gz | tar -xz \
    && cd awscli-${AWSCLI_VERSION} \
    && ./configure --prefix=/opt/aws-cli/ --with-download-deps \
    && make \
    && make install

FROM python:3.8-alpine

RUN apk --no-cache add groff

COPY --from=builder /opt/aws-cli/ /opt/aws-cli/

ENTRYPOINT ["/opt/aws-cli/bin/aws"]

Dieses Image wird aus einem Container erstellt und AWS CLI dann aufgerufen, der dem Container ähnelt, der auf Amazon Linux 2 erstellt wurde:


$ docker build --tag awscli-alpine .
$ docker run --rm -it awscli-alpine --version
aws-cli/2.2.1 Python/3.8.11 Linux/5.10.25-linuxkit source-sandbox/x86_64.alpine.3 prompt/off

Die endgültige Größe dieses Images ist kleiner als die Größe des offiziellen AWS CLI Docker-Images. Informationen zum offiziellen Docker-Image finden Sie unter Führen Sie die AWS CLI von den offiziellen Amazon ECR Public- oder Docker-Images aus.

Behebung von AWS CLI Installations- und Deinstallationsfehlern

Schritte zur Behebung von Installationsfehlern finden Sie unter Fehler AWS CLI beheben Allgemeine Schritte zur Problembehandlung. 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 von eine Version zurück AWS CLI.

Suchen Sie bei Problemen, die nicht in den Anleitungen zur Fehlerbehebung behandelt werden, nach den Problemen mit der source-distribution Bezeichnung im AWS CLI Repository auf GitHub. Wenn keine bestehenden Probleme Ihre Fehler abdecken, erstellen Sie eine neue Ausgabe, um Hilfe von den AWS CLI Betreuern zu erhalten.

Nächste Schritte

Nach der Installation von AWS CLI sollten Sie eine durchführen. Richten Sie das ein AWS CLI

Warnung JavaScript ist in Ihrem Browser nicht verfügbar oder deaktiviert.

Zur Nutzung der AWS-Dokumentation muss JavaScript aktiviert sein. Weitere Informationen finden auf den Hilfe-Seiten Ihres Browsers.

Dokumentkonventionen

Frühere Versionen

Amazon ECR Public/Docker

Erstellen und installieren Sie das AWS CLI aus dem Quellcode

Wichtig

Themen

Warum aus der Quelle erstellen?

Schnelle Schritte

Anmerkung

Schritt 1: Einrichten aller Anforderungen

Anmerkung

Anmerkung

Wichtig

Warnung

Anmerkung

Schritt 2: Konfiguration der AWS CLI -Quellinstallation

Die wichtigsten Optionen sind folgende:

Installationsspeicherort

Python-Interpreter

Anmerkung

Herunterladen von Abhängigkeiten

Installationstyp

Schritt 3: Erstellen der AWS CLI

Anmerkung

Wenn Sie den make-Befehl verwenden, werden die folgenden Schritte im Hintergrund ausgeführt:

Schritt 4: Installieren der AWS CLI

Anmerkung

Bei der Ausführung von make install werden die folgenden Schritte im Hintergrund ausgeführt

Schritt 5: Überprüfen der AWS CLI -Installation

Workflow-Beispiele

Grundlegende Linux- und macOS-Installation

Automatisierte Windows-Installation

Anmerkung

Alpine Linux-Container

Behebung von AWS CLI Installations- und Deinstallationsfehlern

Nächste Schritte

Wenn Sie den `make`-Befehl verwenden, werden die folgenden Schritte im Hintergrund ausgeführt:

Bei der Ausführung von `make install` werden die folgenden Schritte im Hintergrund ausgeführt