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.

Wichtig: In den meisten Fällen sollten Nutzer, die eine Befehlszeile mit Cloud Storage verwenden möchten, das gsutil-Tool nicht verwenden. Stattdessen sollten Sie mit der Google Cloud CLI arbeiten und gcloud storage-Befehle verwenden.

Nach der Installation von gsutil haben Sie sofort Lese- und/oder Schreibzugriff auf öffentliche Daten. Durch die Authentifizierung beim Cloud Storage-Dienst erhalten Sie außerdem Lese- und/oder Schreibzugriff auf geschützte Daten, die für Sie freigegeben wurden. 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.0 ist Python 3.5–3.11 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: Sie müssen einen Python-Versionenmanager (pyenv) und eine geeignete Python-Version installieren (3.11 wird empfohlen).

1. Globale Python-Version festlegen:
   • So legen Sie Python 3.11.9 als globale Version fest:

     pyenv global 3.11.9

   • Alternativ können Sie die Python-Version lokal für einen bestimmten Projektordner festlegen:

     pyenv local 3.11.9

2. Prüfen Sie, ob die richtige Python-Version verwendet wird:

   python --version

   Hier sollten Sie dies sehen:

   Python 3.11.9

macOS

Methode 1: Homebrew (brew) verwenden

Voraussetzungen: Installieren Sie Homebrew und eine geeignete Python-Version (3.11 empfohlen) über Homebrew.

1. Bestimmte Python-Version als Standard festlegen:
   • Fügen Sie die gewünschte Version zu Ihrem $PATH hinzu. So verwenden Sie beispielsweise Python 3.11:

     export PATH="/usr/local/opt/python@3.11/bin:$PATH"

   • Wenn diese Änderung dauerhaft sein soll, fügen Sie den Pfad zur Shell-Konfigurationsdatei (~/.bash_profile, ~/.zshrc oder ~/.bashrc) hinzu.
2. Prüfen Sie, ob die richtige Python-Version verwendet wird:

   python --version

   Hier sollten Sie dies sehen:

   Python 3.11.9

Methode 2: pyenv verwenden

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

1. Globale Python-Version festlegen:
   • So legen Sie die Python-Version global (für alle Terminals) fest:

     pyenv global 3.11.9

   • Alternativ können Sie die Python-Version lokal für einen bestimmten Projektordner festlegen:

     pyenv local 3.11.9

2. Prüfen Sie, ob die richtige Python-Version verwendet wird:

   python --version

   Hier sollten Sie dies sehen:

   Python 3.11.9

Windows

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

1. Globale Python-Version festlegen:
   • So legen Sie Python 3.11.9 als globale Version fest:

     pyenv global 3.11.9

   • Alternativ können Sie die Python-Version lokal für einen bestimmten Projektordner festlegen:

     pyenv local 3.11.9

2. Prüfen Sie, ob die richtige Python-Version verwendet wird:

   python --version

   Hier sollten Sie dies sehen:

   Python 3.11.9

• 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. Für weitere Informationen zu crcmod installieren Sie gsutil und lesen das Hilfethema mit dem Befehl gsutil help crc32c.

Warnung: Bei einigen Linux-Distributionen ist ein anderes Tool namens gsutil von GrandStream BudgeTone vorinstalliert. Wenn Sie diesen Befehl anstelle des gsutil-Tools von Cloud Storage ausführen, erhalten Sie eine Fehlermeldung, die in etwa so lautet: "Choose one of -b, -d, -e, or -r to do something". In diesem Fall können Sie entweder die Cloud Storage-Version von gsutil an den Anfang der PATH-Umgebungsvariable verschieben oder den vollständigen Pfad beim Ausführen des Cloud Storage-Tools gsutil angeben (z. B. /home/users/joan/gsutil/gsutil ls).

gsutil installieren

Hinweis: Wenn Sie die Google Cloud CLI bereits installiert haben, ist gsutil bereits enthalten. Außerdem ist die Google Cloud CLI, einschließlich gsutil, standardmäßig auf einer Reihe von Google Compute Engine-Images installiert. Eine vollständige Liste finden Sie unter Betriebssystemdetails.

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

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

1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben. Die Google Cloud CLI erfordert Python 3.8 bis 3.12). Beachten Sie, dass das x86_64-Linux-Paket einen gebündelten Python-Interpreter enthält, der standardmäßig bevorzugt wird. Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie unter gcloud topic startup.
2. 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	131.3 MB	4fb56340c88901489d52f0d4895dce25c5ed39b7e63743bc8c4cf1af6c4da367
   Linux 64-Bit (Arm)	google-cloud-cli-linux-arm.tar.gz	53,5 MB	d669f9974c82182afbf769ef07ce3feca933c3145999457c717adfff275e5bcc
   Linux 32-Bit (x86)	google-cloud-cli-linux-x86.tar.gz	53,5 MB	9832e1a3891bed93d9ea6f1dae4ca5ee592ac2305decd47de649f3338ab86640

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

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz

   Ersetzen Sie in der obigen Tabelle google-cloud-cli-linux-x86_64.tar.gz durch den *.tar.gz-Paketnamen, der für Ihre Konfiguration gilt.

3. Führen Sie den folgenden Befehl aus, um den Inhalt der Datei in Ihr Dateisystem (vorzugsweise in Ihr Basisverzeichnis) zu extrahieren:

   tar -xf google-cloud-cli-linux-x86_64.tar.gz

   Optional: Wenn Sie eine vorhandene Installation ersetzen möchten, entfernen Sie das vorhandene Verzeichnis google-cloud-sdk und extrahieren Sie dann das Archiv an denselben Speicherort.
4. Fügen Sie die gcloud-Befehlszeile Ihrem Pfad hinzu. Führen Sie das Installations-Script aus dem Stammverzeichnis des Ordners, in den Sie extrahiert haben, mit dem folgenden Befehl aus:

   ./google-cloud-sdk/install.sh

   Dies kann auch auf nicht interaktive Weise erfolgen (z. B. mithilfe eines Scripts) und indem Sie Einstellungen als Flags angeben. Führen Sie Folgendes aus, um die verfügbaren Flags aufzurufen:

   ./google-cloud-sdk/install.sh --help

   Optional:
   • Wenn Sie anonyme Nutzungsstatistiken senden möchten, um zur Verbesserung der gcloud-Befehlszeile zu beitragen, antworten Sie auf Y, wenn Sie dazu aufgefordert werden.
   • Wenn Sie die gcloud CLI zu PATH hinzufügen und die Befehlsvervollständigung aktivieren möchten, antworten Sie mit Y, wenn Sie dazu aufgefordert werden.
5. Öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
6. Führen Sie gcloud init aus, um die gcloud CLI zu initialisieren:

./google-cloud-sdk/bin/gcloud init

7. Optional: Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.

Debian/Ubuntu

Hinweis: Je nach Konfiguration können Sie auch andere Installationsmethoden auswählen:

• Wenn Sie möchten, dass gcloud automatisch auf die neueste Version aktualisiert wird, und Sie einen modernen Ubuntu-Release ausführen, der den Snap Package Manager verwendet, können Sie die Google Cloud-Befehlszeile als Snap-Paket installieren..
• Wenn Sie eine Instanz in Compute Engine verwenden, wird die gcloud CLI standardmäßig auf einer Reihe von Betriebssystem-Images installiert. Eine vollständige Liste finden Sie unter Details zu Betriebssystemen.

Paketinhalt

Die gcloud CLI ist im Paketformat für die Installation auf Debian- und Ubuntu-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. 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.
• Es hat vor Kurzem die Pakete aktualisiert:

  sudo apt-get update

• Es sind apt-transport-https und curl installiert:

  sudo apt-get install apt-transport-https ca-certificates gnupg curl

Installation

1. Importieren Sie den öffentlichen Google Cloud-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.

2. 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.
3. 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 | sudo 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
         

4. (Optional) Installieren Sie eine oder mehrere der folgenden zusätzlichen Komponenten:
   • google-cloud-cli
   • 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

5. Führen Sie gcloud init aus, um zu beginnen:

   gcloud init

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.

HINWEIS: Bei Versionen vor 371.0.0 lautet der Paketname google-cloud-sdk.

Red Hat/Fedora/CentOS

Hinweis: Wenn Sie eine Instanz in Compute Engine verwenden, ist die Google Cloud CLI standardmäßig auf einer Reihe von Betriebssystem-Images installiert. Eine vollständige Liste finden Sie unter Betriebssystemdetails.

Paketinhalt

Die gcloud CLI ist im Paketformat zur Installation auf Red Hat Enterprise Linux 7, 8 und 9 sowie auf Fedora 33 und 34 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

1. Aktualisieren Sie DNF mit Repository-Informationen der gcloud CLI. Der folgende Beispielbefehl bezieht sich auf eine Installation von Red Hat Enterprise Linux 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

2. Wenn Sie auf Fedora 34 oder 35 installieren, installieren Sie libxcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. 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.

4. (Optional) Installieren Sie eine oder mehrere der folgenden zusätzlichen Komponenten:
   • google-cloud-cli
   • 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 dnf install google-cloud-cli-app-engine-java

5. Führen Sie gcloud init aus, um zu beginnen:

   gcloud init

Downgrade auf gcloud CLI-Versionen ausführen

Wenn Sie eine bestimmte Version der gcloud CLI wiederherstellen möchten, wobei VERSION das Format 123.0.0 hat, führen Sie Folgendes aus: sudo dnf downgrade google-cloud-cli-VERSION Die letzten zehn Releases sind immer im Repository verfügbar. HINWEIS: Bei Versionen vor 371.0.0 lautet der Paketname google-cloud-sdk.

macOS

1. Prüfen Sie, ob Sie eine unterstützte Version von Python haben:
   • Um Ihre aktuelle Python-Version zu prüfen, führen Sie python3 -V oder python -V aus. Unterstützte Versionen sind Python 3.8 bis 3.12).
   • Das Hauptinstallationsskript bietet die Installation von Python 3.11 von CPython.
   • Wenn Sie eine unterstützte Python-Version installieren möchten, besuchen Sie die Python-Releases für macOS von Python.org.
   • Wenn auf Ihrem Computer mehrere Python-Interpreter installiert sind, legen Sie die Umgebungsvariable CLOUDSDK_PYTHON in der Shell so fest, dass sie auf den Pfad Ihres bevorzugten Interpreters verweist.
   • Weitere Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie unter gcloud topic startup.
2. Laden Sie eine der folgenden Dateien herunter:
   Hinweis: Führen Sie uname -m über eine Befehlszeile aus, um den Namen Ihrer Maschinenhardware zu ermitteln.

Plattform	Paket	Größe	SHA256-Prüfsumme
macOS 64-Bit (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	53,6 MB	9525b9e7affb5447fdd22c8b7fc5e14f486793a835b07eeabe9311f66e939207
macOS 64-Bit (ARM64, Apple M1 silicon)	google-cloud-cli-darwin-arm.tar.gz	53,5 MB	388e0289be5e2ca4ec2aeab3172fe28891080a11db9907a9502bd2a01c4896dd
macOS 32-Bit (x86)	google-cloud-cli-darwin-x86.tar.gz	52.2 MB	56faf55a2882d85f4f3b7e27110a9bba258084df22a80bf5276706ed998a6505

1. Entpacken Sie das Archiv in einem Verzeichnis Ihres Dateisystems, vorzugsweise im Basisverzeichnis. Unter macOS erreichen Sie dies, indem Sie die heruntergeladene Archivdatei .tar.gz am bevorzugten Speicherort öffnen.

   Wenn Sie eine vorhandene Installation ersetzen möchten, entfernen Sie das vorhandene Verzeichnis google-cloud-sdk und extrahieren Sie dann das Archiv an denselben Speicherort.

2. (Optional) Verwenden Sie das Installationsskript, um die gcloud CLI-Tools Ihrem PATH hinzuzufügen. Sie können auch die Befehlsvervollständigung für Ihre Shell aktivieren, Nutzungsstatistiken erheben und Python 3.11 installieren.

   Führen Sie das Script (im Stammverzeichnis des Ordners, den Sie im letzten Schritt extrahiert haben) mit diesem Befehl aus:

   ./google-cloud-sdk/install.sh

   Dies kann auch auf nicht interaktive Weise erfolgen (z. B. mithilfe eines Scripts) und indem Sie Einstellungen als Flags angeben. Führen Sie folgenden Befehl aus, um die verfügbaren Flags zu beschreiben:

   ./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

   Öffnen Sie ein neues Terminal, damit die Änderungen wirksam werden.
3. Führen Sie gcloud init aus, um die gcloud CLI zu initialisieren:

./google-cloud-sdk/bin/gcloud init

4. Optional. Sie können zusätzliche Komponenten mit dem Komponentenmanager installieren.

Windows

Die Google Cloud-Befehlszeile funktioniert unter Windows 8.1 und höher sowie Windows Server 2012 und höher.

1. 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://dl.google.com/dl/cloudsdk/channels/rapid/", "$env:Temp\GoogleCloudSDKInstaller.exe")
   
   & $env:Temp\GoogleCloudSDKInstaller.exe
       

2. 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.

3. Die Google Cloud CLI erfordert Python. Unterstützte Versionen sind Python 3.8 bis 3.12. 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.

4. 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. Achten Sie darauf, dass die Optionen zum Starten der Shell und zum Konfigurieren der Installation ausgewählt bleiben. Das Installationsprogramm startet ein Terminalfenster und führt den Befehl gcloud init aus.

5. 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.

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 nutzen, wird OAuth2 zur Authentifizierung und Autorisierung des Zugriffs auf Ihre Cloud Storage-Ressourcen verwendet. Führen Sie den Befehl gcloud init aus und folgen Sie der Anleitung in der Befehlszeile, einschließlich der Anmeldung in Ihrem Nutzerkonto. Beachten Sie, dass Sie diese Einrichtung wahrscheinlich bereits ausgeführt haben, wenn Sie die oben beschriebenen Installationsschritte ausgeführt haben. Wenn Sie zuvor gcloud init ausgeführt haben und den Befehl noch einmal ausführen, werden Sie 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 zu storage.mtls.googleapis.com herzustellen. Bevor die Verbindung zugelassen wird, überprüft Cloud Storage das Zertifikat auf Ihrem Gerät.

Hinweis: Dieses Feature funktioniert nur, wenn gsutil Anfragen über die Cloud Storage JSON API ausführt.

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:

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

Jetzt testen

Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit von Cloud Storage in der Praxis sehen und bewerten zu können. Neukunden erhalten außerdem ein Guthaben von 300 $, um Arbeitslasten auszuführen, zu testen und bereitzustellen.

Cloud Storage kostenlos testen