Einige oder alle Informationen auf dieser Seite gelten möglicherweise nicht für Cloud de Confiance von S3NS. Weitere Informationen finden Sie unter Unterschiede zu Google Cloud.

Diese Seite wurde von der Cloud Translation API übersetzt.

gsutil installieren

Auf dieser Seite werden die Installation und Einrichtung von gsutil beschrieben. Mit diesem Tool können Sie mit HTTPS über die Befehlszeile auf Cloud Storage zugreifen.

Nach der Installation von gsutil haben Sie sofort Zugriff auf öffentliche Daten und können sie lesen und schreiben, sofern dies zulässig ist. Um mit den geschützten Daten, die für Sie freigegeben wurden, interagieren zu können, ist eine Authentifizierung beim Cloud Storage-Dienst erforderlich. Wenn Sie die Abrechnung aktivieren, können Sie eigene Buckets erstellen und verwalten.

Systemanforderungen

Das gsutil-Tool läuft unter Linux/Unix, Mac OS und Windows (XP oder neuer).
Für gsutil-Versionen ab 5.35 ist Python 3.9 bis 3.13 erforderlich. Sie können es über Ihren Python-Versionsmanager oder durch Installieren einer geeigneten Version erhalten.

In der folgenden Anleitung wird beschrieben, wie Sie Python-Versionen verwalten:

Linux

Voraussetzungen: Installieren Sie einen Python-Versionsmanager (pyenv) und eine geeignete Python-Version.

Globale Python-Version festlegen:
- So legen Sie Python 3.13 als globale Version fest:
```
pyenv global 3.13
```
- Oder legen Sie die Python-Version lokal für einen bestimmten Projektordner fest:
```
pyenv local 3.13
```
Prüfen Sie, ob die richtige Python-Version verwendet wird:
```
python --version
```
Hier sollten Sie dies sehen:
```
Python 3.13
```

macOS

Methode 1: Homebrew (brew) verwenden

Voraussetzungen: Installieren Sie Homebrew und eine geeignete Python-Version über Homebrew.

Bestimmte Python-Version als Standard festlegen:
- Fügen Sie die gewünschte Version zu Ihrem $PATH hinzu. So verwenden Sie beispielsweise Python 3.13:
```
export PATH="/usr/local/opt/python@3.13/bin:$PATH"
```
- Wenn diese Änderung dauerhaft sein soll, fügen Sie den Pfad zur Shell-Konfigurationsdatei (~/.bash_profile, ~/.zshrc oder ~/.bashrc) hinzu.
Prüfen Sie, ob die richtige Python-Version verwendet wird:
```
python --version
```
Hier sollten Sie dies sehen:
```
Python 3.13
```

Methode 2: pyenv verwenden

Voraussetzungen: Installieren Sie den Python-Versionsmanager (pyenv) und eine geeignete Python-Version über pyenv.

Globale Python-Version festlegen:
- So legen Sie die Python-Version global (für alle Terminals) fest:
```
pyenv global 3.13
```
- Oder legen Sie die Python-Version lokal für einen bestimmten Projektordner fest:
```
pyenv local 3.13
```
Prüfen Sie, ob die richtige Python-Version verwendet wird:
```
python --version
```
Hier sollten Sie dies sehen:
```
Python 3.13
```

Windows

Voraussetzungen: Installieren Sie den Python-Versionsmanager (pyenv-win) und eine geeignete Python-Version über pyenv.

Globale Python-Version festlegen:
- So legen Sie Python 3.13 als globale Version fest:
```
pyenv global 3.13
```
- Oder legen Sie die Python-Version lokal für einen bestimmten Projektordner fest:
```
pyenv local 3.13
```
Prüfen Sie, ob die richtige Python-Version verwendet wird:
```
python --version
```
Hier sollten Sie dies sehen:
```
Python 3.13
```

Wenn Sie zusammengesetzte Objekte verwenden möchten, müssen Sie eine kompilierte crcmod-Bibliothek installieren. Unter Windows ist dies nur für 32-Bit-Python verfügbar. Weitere Informationen zu crcmod erhalten Sie, wenn Sie gsutil installieren und den Befehl gsutil help crc32c ausführen.

gsutil installieren

Nur die Installation und Aktualisierung von gsutil als Teil der Google Cloud CLI wird offiziell unterstützt.

Hinweise

Die Google Cloud CLI und gsutil haben Python-Versionsabhängigkeiten, die Kompatibilitätsprobleme verursachen können. Für die Google Cloud CLI ist Python 3.9 bis 3.14 erforderlich, für gsutil Python 3.9 bis 3.13.

Wir empfehlen, gsutil als Teil der Google Cloud CLI zu installieren. Wenn Sie gsutil direkt installieren möchten, verwenden Sie Python 3.9 bis 3.13, um Kompatibilitätsprobleme zu vermeiden.

gsutil als Teil der Google Cloud-Befehlszeile installieren

Folgen Sie der Anleitung für Ihr Betriebssystem, um gsutil als Teil der Google Cloud CLI zu installieren:

Linux

Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.9 bis 3.14. Das x86_64-Linux-Paket enthält einen gebündelten Python-Interpreter, der standardmäßig bevorzugt wird. Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie in der gcloud topic startup-Dokumentation.

Laden Sie eine der folgenden Dateien herunter:

Hinweis:Führen Sie uname -a in der Befehlszeile aus, um die Linux-Plattform Ihres Betriebssystems zu ermitteln.

Plattform	Paketname	Größe	SHA256-Prüfsumme
Linux 64-Bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	202,9 MB	71a81b5391dbc0418ac767a8522d8eab92780d708cb1c2740160d137fbeb760a
Linux 64-Bit (Arm)	google-cloud-cli-linux-arm.tar.gz	57,7 MB	001c4adc88fe796a0c0a0db9771949947528c5066bc5c9f6b7240b5ef59ee0f3
Linux 32-Bit (x86)	google-cloud-cli-linux-x86.tar.gz	57,8 MB	921b840acfbbb9cace1d696175aded8a891149ccfbab48e5aea11613bc4a31fc

Führen Sie den folgenden Befehl aus, um die Linux-Archivdatei herunterzuladen:

curl -O https://storage.s3nsapis.fr/cloud-sdk-release/google-cloud-cli-linux-x86_64.tar.gz

Sehen Sie in der Tabelle oben nach und ersetzen Sie google-cloud-cli-linux-x86_64.tar.gz durch den Paketnamen *.tar.gz, der für Ihre Konfiguration gilt.

Führen Sie den folgenden Befehl aus, um den Inhalt der Datei in Ihr Dateisystem zu extrahieren:
```
tar -xf google-cloud-cli-linux-x86_64.tar.gz
```
Wenn Sie eine vorhandene Installation ersetzen möchten, löschen Sie das vorhandene Verzeichnis google-cloud-sdk und extrahieren Sie dann das Archiv an denselben Speicherort.
Führen Sie das Installationsskript aus dem Stammverzeichnis des Ordners aus, den Sie extrahiert haben:
```
./google-cloud-sdk/install.sh
```
Das Skript fordert Sie auf, die folgenden Einrichtungsaktionen auszuführen. Wenn Sie die Anfrage annehmen möchten, antworten Sie mit Y.
- Fügen Sie die gcloud-Befehlszeile zu PATH hinzu.
- Aktivieren Sie die Befehlsvervollständigung.
- Aktivieren Sie die Option zum Senden von anonymen Nutzungsstatistiken, um zur Verbesserung der gcloud CLI beizutragen.
Sie können die Installation auch nicht interaktiv durchführen, indem Sie Flags angeben. Führen Sie Folgendes aus, um die verfügbaren Flags aufzurufen:
```
./google-cloud-sdk/install.sh --help
```
Optional: Wenn Sie Ihre PATH im vorherigen Schritt aktualisiert haben, öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.

Debian/Ubuntu

Paketinhalt

Die gcloud CLI ist im Paketformat für die Installation auf Debian- und Ubuntu-Systemen verfügbar. Dieses Paket umfasst nur die Befehlszeilentools gcloud, gcloud alpha, gcloud beta, gsutil und bq. Nicht enthalten sind kubectl oder die App Engine-Erweiterungen, die für die Bereitstellung einer Anwendung mit gcloud-Befehlen erforderlich sind. Wenn Sie diese Komponenten benötigen, müssen Sie sie separat installieren.

Hinweis

Prüfen Sie vor der Installation der gcloud CLI, ob Ihr Betriebssystem die folgenden Anforderungen erfüllt:

Es ist ein Ubuntu-Release, das das Ende des Produktzyklus noch nicht erreicht hat, oder ein stabiler Debian-Release, der das Ende des Produktzyklus noch nicht erreicht hat.
Die Pakete wurden vor Kurzem aktualisiert. Führen Sie dazu den folgenden Befehl aus:
```
sudo apt-get update
```
Es sind apt-transport-https, ca-certificates, gnupg und curl installiert. Führen Sie den folgenden Befehl aus, um diese Pakete zu installieren:
```
sudo apt-get install apt-transport-https ca-certificates gnupg curl
```

Installation

Importieren Sie den Cloud de Confiance by S3NS öffentlichen Schlüssel.
- Für neuere Distributionen (Debian 9+ oder Ubuntu 18.04+) führen Sie den folgenden Befehl aus:
```
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg
```
- Führen Sie für ältere Distributionen den folgenden Befehl aus:
```
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -
```
- Wenn der Befehl apt-key Ihrer Distribution das Argument --keyring nicht unterstützt, führen Sie den folgenden Befehl aus:
```
curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
```
- Wenn Sie aufgrund eines abgelaufenen Schlüssels keine aktuellen Updates erhalten können, rufen Sie die aktuelle apt-get.gpg-Schlüsseldatei ab.
Fügen Sie den Distribution-URI der gcloud CLI als Paketquelle hinzu.
- Für neuere Distributionen (Debian 9+ oder Ubuntu 18.04+) führen Sie den folgenden Befehl aus:
```
echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
```
- Führen Sie für ältere Distributionen, die die Option signed-by nicht unterstützen, den folgenden Befehl aus:
```
echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
```
Hinweis: Achten Sie darauf, dass Sie keine doppelten Einträge für das Repository cloud-sdk in /etc/apt/sources.list.d/google-cloud-sdk.list haben.

Aktualisieren Sie die gcloud CLI und installieren Sie sie:

sudo apt-get update && sudo apt-get install google-cloud-cli

Weitere Optionen für apt-get, wie das Deaktivieren von Prompts oder Probeläufen, finden Sie auf den apt-get-man-Seiten.

Docker-Tipp: Wenn Sie die gcloud CLI in einem Docker-Image installieren, verwenden Sie stattdessen einen einzigen RUN-Schritt:

RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y

Für ältere Basis-Images, die den Befehl gpg --dearmor nicht unterstützen:

RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y

Optional können Sie eine oder mehrere der folgenden zusätzlichen Komponenten installieren:
- google-cloud-cli-anthos-auth
- google-cloud-cli-app-engine-go
- google-cloud-cli-app-engine-grpc
- google-cloud-cli-app-engine-java
- google-cloud-cli-app-engine-python
- google-cloud-cli-app-engine-python-extras
- google-cloud-cli-bigtable-emulator
- google-cloud-cli-cbt
- google-cloud-cli-cloud-build-local
- google-cloud-cli-cloud-run-proxy
- google-cloud-cli-config-connector
- google-cloud-cli-datastore-emulator
- google-cloud-cli-firestore-emulator
- google-cloud-cli-gke-gcloud-auth-plugin
- google-cloud-cli-kpt
- google-cloud-cli-kubectl-oidc
- google-cloud-cli-local-extract
- google-cloud-cli-minikube
- google-cloud-cli-nomos
- google-cloud-cli-pubsub-emulator
- google-cloud-cli-skaffold
- google-cloud-cli-spanner-emulator
- google-cloud-cli-terraform-validator
- google-cloud-cli-tests
- kubectl
Die Komponente google-cloud-cli-app-engine-java kann beispielsweise so installiert werden:
```
sudo apt-get install google-cloud-cli-app-engine-java
```
Führen Sie gcloud init aus, um die gcloud CLI zu initialisieren, zu autorisieren und zu konfigurieren.

Downgrade auf gcloud CLI-Versionen ausführen

Führen Sie den folgenden Befehl aus, um eine bestimmte Version der gcloud CLI wiederherzustellen, wobei VERSION das Format 123.0.0 hat:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Die zehn neuesten Releases sind immer im Repository verfügbar. Bei Versionen vor 371.0.0 lautet der Paketname google-cloud-sdk.

Red Hat/Fedora/CentOS

Paketinhalt

Die gcloud CLI ist im Paketformat zur Installation auf Red Hat Enterprise Linux 7, 8, 9 und 10 sowie auf Fedora 41 und 42 und CentOS 7- und 8-Systemen verfügbar. Dieses Paket umfasst nur die Befehle von gcloud, gcloud alpha, gcloud beta, gsutil und bq. Nicht enthalten sind kubectl oder die App Engine-Erweiterungen, die für die Bereitstellung einer Anwendung mit gcloud-Befehlen erforderlich sind. Diese können wie unten in diesem Abschnitt separat installiert werden.

Installation

Aktualisieren Sie DNF mit Repository-Informationen der gcloud CLI.

Der folgende Beispielbefehl bezieht sich auf eine Installation von Red Hat Enterprise Linux 7, 8 oder 9. Achten Sie jedoch darauf, die Einstellungen nach Bedarf für Ihre Konfiguration zu aktualisieren:

sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
EOM

Verwenden Sie für RHEL 10-kompatible Installationen den folgenden Befehl mit der aktualisierten gpgkey:

sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
[google-cloud-cli]
name=Google Cloud CLI
baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-x86_64
enabled=1
gpgcheck=1
repo_gpgcheck=0
gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
EOM

Installieren Sie libxcrypt-compat.x86_64.

sudo dnf install libxcrypt-compat.x86_64

Installieren Sie die gcloud CLI:
```
sudo dnf install google-cloud-cli
```
Hinweis: Wenn Sie die Migration in dnf auf Ihrem System noch nicht ausgeführt haben, können Sie diese Befehle stattdessen mit yum ausführen.
Sie können auch die Optionen dnf/yum mit den bereitgestellten Befehlen verwenden, wie z. B. das Deaktivieren von Eingabeaufforderungen oder Probeläufen.
Optional: Installieren Sie eine oder mehrere der folgenden zusätzlichen Komponenten:
- google-cloud-cli-anthos-auth
- google-cloud-cli-app-engine-go
- google-cloud-cli-app-engine-grpc
- google-cloud-cli-app-engine-java
- google-cloud-cli-app-engine-python
- google-cloud-cli-app-engine-python-extras
- google-cloud-cli-bigtable-emulator
- google-cloud-cli-cbt
- google-cloud-cli-cloud-build-local
- google-cloud-cli-cloud-run-proxy
- google-cloud-cli-config-connector
- google-cloud-cli-datastore-emulator
- google-cloud-cli-firestore-emulator
- google-cloud-cli-gke-gcloud-auth-plugin
- google-cloud-cli-kpt
- google-cloud-cli-kubectl-oidc
- google-cloud-cli-local-extract
- google-cloud-cli-minikube
- google-cloud-cli-nomos
- google-cloud-cli-pubsub-emulator
- google-cloud-cli-skaffold
- google-cloud-cli-spanner-emulator
- google-cloud-cli-terraform-validator
- google-cloud-cli-tests
- kubectl
Führen Sie beispielsweise den folgenden Befehl aus, um die Komponente google-cloud-cli-app-engine-java zu installieren:
```
sudo dnf install google-cloud-cli-app-engine-java
```
Führen Sie gcloud init aus, um die gcloud CLI zu initialisieren, zu autorisieren und zu konfigurieren.

Downgrade auf gcloud CLI-Versionen ausführen

Führen Sie den folgenden Befehl aus, um eine bestimmte Version der gcloud CLI wiederherzustellen. Ersetzen Sie 123.0.0 durch die Version, die Sie installieren möchten:

sudo dnf downgrade google-cloud-cli-123.0.0

Die zehn neuesten Releases sind im Repository verfügbar. Bei Versionen vor 371.0.0 verwenden Sie google-cloud-sdk als Paketnamen.

macOS

Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.9 bis 3.14.
Führen Sie python3 -V oder python -V aus, um Ihre Python-Version zu prüfen.

Das Installationsskript kann Python bei Bedarf für Sie installieren. Dazu sind die Xcode-Befehlszeilentools erforderlich. Führen Sie sudo xcode-select --install aus, um sie zu installieren. Alternativ können Sie eine unterstützte Python-Version von python.org installieren.

Weitere Informationen zum Konfigurieren des Python-Interpreters, insbesondere wenn Sie mehrere Versionen installiert haben, finden Sie in der gcloud topic startup-Dokumentation.

Laden Sie eine der folgenden Dateien herunter:

Hinweis: Führen Sie uname -m über eine Befehlszeile aus, um Ihre Plattform zu ermitteln.

Plattform	Paket	Größe	SHA256-Prüfsumme
macOS 64-Bit (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	57,9 MB	6a838eacf37a2505c4d90fb74bd97abdb488b0a85321c3d886e4bd9851a78fd8
macOS 64-Bit (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	57,8 MB	36e2838b7b3ec0659df7a142bb870f8612576ca6883240d657363e3391964339
macOS 32-Bit (x86)	google-cloud-cli-darwin-x86.tar.gz	56,3 MB	eaeef651be72fb86379e1fd6c208d625c5ebaf3f87d9deb540594e456fc4ed56

Alternativ können Sie das Archiv über die Befehlszeile herunterladen. Ersetzen Sie FILE_NAME durch den Paketnamen für Ihre Plattform aus der Tabelle oben.

curl -O https://storage.s3nsapis.fr/cloud-sdk-release/FILE_NAME

Entpacken Sie die Inhalte der Datei an einem beliebigen Speicherort in Ihrem Dateisystem. Häufig wird sie in das Home-Verzeichnis extrahiert.
Unter macOS erreichen Sie dies, indem Sie die heruntergeladene Datei .tar.gz am bevorzugten Speicherort öffnen. Alternativ können Sie über die Befehlszeile folgenden Befehl ausführen:
```
tar -xf FILE_NAME
```
Wenn Sie eine vorhandene Installation ersetzen möchten, löschen Sie das vorhandene Verzeichnis google-cloud-sdk und extrahieren Sie dann das Archiv an denselben Speicherort.
Führen Sie das Installationsskript aus dem Stammverzeichnis des Ordners aus, den Sie extrahiert haben:
```
./google-cloud-sdk/install.sh
```
Das Skript fordert Sie auf, die folgenden Einrichtungsaktionen auszuführen. Wenn Sie die Anfrage annehmen möchten, antworten Sie mit Y.
- Installieren Sie bei Bedarf Python 3.13 und die empfohlenen Module.
- Fügen Sie die gcloud CLI zu PATH hinzu und aktivieren Sie die Befehlsvervollständigung.
- Aktivieren Sie die Option zum Senden von anonymen Nutzungsstatistiken, um zur Verbesserung der gcloud CLI beizutragen.
Sie können die Installation auch nicht interaktiv durchführen, indem Sie Flags angeben. Führen Sie Folgendes aus, um die verfügbaren Flags aufzurufen:
```
./google-cloud-sdk/install.sh --help
```
So führen Sie das Installationsskript mit aktiviertem Screenreader-Modus aus:
```
./google-cloud-sdk/install.sh --screen-reader=true
```
Optional: Wenn Sie Ihre PATH im vorherigen Schritt aktualisiert haben, öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.

Windows

Für die Google Cloud CLI unter Windows ist Windows 8.1 oder höher bzw. Windows Server 2012 oder höher erforderlich.

Laden Sie das Installationsprogramm für die Google Cloud-CLI herunter.

Alternativ können Sie ein PowerShell-Terminal öffnen und die folgenden PowerShell-Befehle ausführen.

(New-Object Net.WebClient).DownloadFile("https://storage.s3nsapis.fr/cloud-sdk-release/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")

& $env:Temp\GoogleCloudSDKInstaller.exe

Starten Sie das Installationsprogramm und folgen Sie den Anweisungen. Das Installationsprogramm ist von Google LLC signiert.
- Wenn Sie einen Screenreader verwenden, klicken Sie auf das Kästchen Screenreader-Modus aktivieren. Diese Option konfiguriert gcloud so, dass Status-Tracker anstelle von rotierenden Unicode-Ladesymbolen verwendet, die Fortschritt als Prozentsatz angezeigt und Tabellen vereinfacht werden. Weitere Informationen finden Sie im Leitfaden zu Bedienungshilfen.
- Die Google Cloud CLI erfordert Python. Unterstützte Versionen sind Python 3.9 bis 3.14. Die Windows-Version der Google Cloud CLI ist standardmäßig in Python 3 enthalten. Um die Google Cloud CLI verwenden zu können, muss das Betriebssystem in der Lage sein, eine unterstützte Version von Python auszuführen.
- Das Installationsprogramm installiert alle notwendigen Abhängigkeiten, darunter die erforderliche Version von Python. Die Google Cloud CLI installiert und verwaltet Python 3 standardmäßig, kann aber bei Bedarf eine vorhandene Python-Installation verwenden. Dazu deaktivieren Sie die Option zum gebündelten Installieren von Python. Unter gcloud topic startup erfahren Sie, wie Sie eine vorhandene Python-Installation verwenden.
Nach Abschluss der Installation haben Sie die Möglichkeit, das Startmenü und die Desktopverknüpfungen zu erstellen, die Google Cloud CLI-Shell zu starten und die gcloud CLI zu konfigurieren. Lassen Sie die Optionen zum Starten der Shell und zum Konfigurieren der Installation ausgewählt. Das Installationsprogramm startet ein Terminalfenster und führt den Befehl gcloud init aus, um die gcloud CLI zu initialisieren, zu autorisieren und zu konfigurieren.
Die Standardinstallation umfasst nicht die App Engine-Erweiterungen, die für die Bereitstellung einer Anwendung mit gcloud-Befehlen erforderlich sind. Diese Komponenten können mit dem Komponentenmanager der gcloud CLI installiert werden.

Tipps zur Fehlerbehebung

Wenn die Installation aufgrund der Nichterkennung des Befehls find fehlschlägt, achten Sie darauf, dass die Umgebungsvariable PATH so eingestellt ist, dass sie den Ordner mit find enthält. Normalerweise ist dies C:\WINDOWS\system32;.
Wenn Sie die gcloud CLI deinstalliert haben, müssen Sie Ihr System neu starten, bevor Sie die gcloud CLI noch einmal installieren.
Wenn das Entpacken fehlschlägt, führen Sie das Installationsprogramm als Administrator aus.

Bei der Installation von gsutil müssen Sie die Umgebungsvariable CLOUDSDK_PYTHON festlegen, damit die richtige Python-Version verwendet wird. Weitere Informationen finden Sie unter gcloud startup topic.

Führen Sie Updates mit dem Befehl components update aus: gcloud components update.

Anmeldedaten für den Zugriff auf geschützte Daten einrichten

Um auf geschützte Daten zuzugreifen oder in einen geschützten Bucket zu schreiben, müssen Sie Anmeldedaten einrichten (sich also authentifizieren). Wenn beispielsweise jemand ein Cloud Storage-Konto erstellt und Daten hochgeladen hat, die nur für Sie oder bestimmte andere Personen zugänglich sind, müssen Sie Ihre Anmeldedaten für den Cloud Storage-Dienst so einrichten, dass Sie auf diese Daten zugreifen können.

Wenn Sie gsutil als Teil der Google Cloud CLI verwenden, wird OAuth2 zur Authentifizierung und Autorisierung des Zugriffs auf Ihre Cloud Storage-Ressourcen verwendet. Führen Sie dazu den Befehl gcloud init aus und folgen Sie der Anleitung in der Befehlszeile, die eine Anmeldung in Ihrem Nutzerkonto umfasst. Wenn Sie die Installationsschritte ausgeführt haben, haben Sie diese Einrichtung wahrscheinlich bereits vorgenommen. Wenn Sie zuvor gcloud init ausgeführt haben, werden Sie beim erneuten Ausführen des Befehls gefragt, ob Sie die Konfiguration neu initialisieren oder eine neue erstellen möchten. Weitere Informationen finden Sie unter Google Cloud CLI initialisieren.

Das war's. Jetzt können Sie auf geschützte Daten zugreifen. Führen Sie über eine Eingabeaufforderung den Befehl gsutil aus, um eine Liste der gsutil-Befehle aufzurufen.

Fehlerbehebung

Wenn Sie versuchen, gsutil mit dem gcloud init-Befehl zu authentifizieren, aber noch nicht auf die erwarteten Buckets oder Objekte zugreifen können, verfügt Ihr System möglicherweise über die eigenständige Legacy-Version von gsutil und die mit Google Cloud CLI gebündelte Version von gsutil, die darauf installiert wird. Führen Sie den Befehl gsutil version -l aus und prüfen Sie den Wert für using cloud sdk. Ist dieser False, verwendet Ihr System beim Ausführen von Befehlen die eigenständige Version von gsutil. Es wird empfohlen, die eigenständige Version von gsutil aus Ihrem System zu entfernen. Sie können sich aber auch mit gsutil config -a oder gsutil config -e authentifizieren.

Mit HMAC authentifizieren

OAuth 2.0 ist zwar die empfohlene Methode zur Authentifizierung von gsutil, Sie können aber auch die HMAC-Schlüssel für Ihre Anmeldedaten verwenden. Verwenden Sie zur Authentifizierung mit HMAC den folgenden Befehl:

gsutil config -a

Dieser Befehl führt Sie durch einen Authentifizierungsprozess, bei dem Sie zur Eingabe der Zugriffs-ID und des Secrets aufgefordert werden, die mit Ihrem HMAC-Schlüssel verknüpft sind.

Bei der Authentifizierung mit HMAC-Schlüsseln sollten Sie mit dem Befehl gcloud config set pass_credentials_to_gsutil false das Übergeben der Anmeldedaten von der Google Cloud CLI deaktivieren.

mTLS aktivieren

Sie können auch mTLS aktivieren. Wenn mTLS auf Ihrem Gerät aktiviert ist, versucht Ihr Gerät, eine Verbindung zum mTLS-Anfrageendpunkt für die JSON API herzustellen. Bevor die Verbindung zugelassen wird, überprüft Cloud Storage das Zertifikat auf Ihrem Gerät.

Am einfachsten erhalten Sie ein Zertifikat über die Google Cloud CLI. Sie können eines in der .boto-Datei manuell festlegen. Legen Sie dazu die folgenden Werte unter "Anmeldedaten" fest:

use_client_certificate: Ein Flag, das steuert, ob mTLS verwendet werden soll.
cert_provider_command: Ein Shell-Befehl, der ein Zertifikat an stdout ausgibt, um gsutil lesen zu können.