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

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

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 oder eine Google Compute Engine-Instanz verwenden, haben Sie gsutil bereits installiert.

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-Befehlszeile erfordert Python 3 (3.5 bis 3.8, 3.7 empfohlen) und Python 2 (2.7.9 oder höher). Informationen zum Auswählen und Konfigurieren des Python-Interpreters finden Sie unter gcloud topic startup.

   Seit dem 1. Januar 2020 aktualisiert die Python-Community keine Programmfehler, Patches oder Sicherheitsprobleme für Python 2 mehr. Wir empfehlen, so bald wie möglich ein Upgrade auf Python 3 durchzuführen. Weitere Informationen finden Sie unter Python 2-Unterstützung in Google Cloud.

2. Laden Sie eine der folgenden Dateien herunter:
   Hinweis: Führen Sie getconf LONG_BIT in der Befehlszeile aus, um die Version Ihres Betriebssystems zu ermitteln.

   Plattform	Paket	Größe	SHA256-Prüfsumme
   Linux 64-Bit (x86_64)	google-cloud-cli-397.0.0-linux-x86_64.tar.gz	106,3 MB	4ba8ce1a4bbc1554ff9b1e9d71e01a0b3c1e881d5b8dff62e259939d85b7be43
   Linux 64-Bit (arm)	google-cloud-cli-397.0.0-linux-arm.tar.gz	103,1 MB	0dde7d1f83f23375b53fa33ec77eaeb3e406ae368c90d41f4de805b907b3508e
   Linux 32-Bit (x86)	google-cloud-cli-397.0.0-linux-x86.tar.gz	104,2 MB	48982ffb31358fa096899ad035b1bda0d83b780c62839398a5106f61fbe7758d

   Alternativ können Sie so die 64-Bit-Linux-Archivdatei in der Befehlszeile herunterladen:

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

   Führen Sie für die 64-Bit-Arm-Archivdatei Folgendes aus:

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

   Führen Sie für die 32-Bit-Archivdatei Folgendes aus:

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

3. Extrahieren Sie den Inhalt der Datei an einen beliebigen Speicherort in Ihrem Dateisystem (vorzugsweise in Ihrem Basisverzeichnis). 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. Das folgende Beispiel zeigt den Befehl für 32-Bit-Linux. Wenn Sie eine andere Plattform verwenden, passen Sie den Befehl entsprechend an:

   tar -xf google-cloud-cli-397.0.0-linux-x86.tar.gz

4. Fügen Sie die gcloud-Befehlszeile Ihrem Pfad hinzu. Führen Sie das Installationsskript 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 Skripts) 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 und gsutil automatisch auf die neueste Version aktualisiert werden, und Sie einen modernen Ubuntu-Release ausführen, der den Snap Package Manager verwendet, können Sie die Google Cloud-Befehlszeile als Snap-Paket.
• Wenn Sie eine Instanz in Compute Engine verwenden, wird die gcloud CLI standardmäßig installiert.

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:

• 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.
• apt-transport-https ist installiert:

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

Installation

1. Fügen Sie den Distribution-URI der gcloud CLI als Paketquelle hinzu. Wenn Ihre Distribution die Option "signed-by" unterstützt, 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

   Wenn Ihre Distribution die Option "signed-by" nicht unterstützt, führen Sie 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.
2. Importieren Sie den öffentlichen Google Cloud-Schlüssel. Wenn der Befehl apt-key Ihrer Distribution das Argument --keyring unterstützt, führen Sie 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 Ihre Distribution (Debian 11+ oder Ubuntu 21.10 oder höher) apt-key nicht unterstützt, führen Sie den folgenden Befehl aus:

   curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo tee /usr/share/keyrings/cloud.google.gpg

   Wenn Sie aufgrund eines abgelaufenen Schlüssels keine aktuellen Updates erhalten können, rufen Sie die aktuelle "apt-get.gpg"-Schlüsseldatei ab.

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 Eingabeaufforderungen 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] http://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
         

   Wenn der Befehl apt-key nicht unterstützt wird:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] http://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 | tee /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-sdk -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-datalab
   • 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, wird die Google Cloud CLI standardmäßig installiert.

Paketinhalt

Die gcloud CLI ist im Paketformat zur Installation auf den Systemen Red Hat Enterprise Linux 7, Red Hat Enterprise Linux 8, Fedora 33, Fedora 34 sowie CentOS 7 und 8 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 8. Ersetzen Sie bei einer mit Red Hat Enterprise Linux 7 kompatiblen Installation el8 durch el7 im Wert für baseUrl.

   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-el8-x86_64
   enabled=1
   gpgcheck=1
   repo_gpgcheck=0
   gpgkey=https://packages.cloud.google.com/yum/doc/yum-key.gpg
          https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
   EOM
   

   Wichtig: Die zweite Zeile von gpgkey muss wie gezeigt eingerückt sein.
2. Wenn Sie auf Fedora 34 oder 35 installieren, installieren Sie libcrypt-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-datalab
   • 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. Moderne Versionen von macOS enthalten die entsprechende Version von Python, die für das Cloud SDK erforderlich ist. Unterstützte Versionen sind Python 3 (3.5 bis 3.8, 3.7 empfohlen) und Python 2 (2.7.9 oder höher).

     Seit dem 1. Januar 2020 aktualisiert die Python-Community keine Programmfehler, Patches oder Sicherheitsprobleme für Python 2 mehr. Wir empfehlen, so bald wie möglich ein Upgrade auf Python 3 durchzuführen. Weitere Informationen finden Sie unter Python 2-Unterstützung in Google Cloud.

   • Für die Clou SDK-Release-Version 352.0.0 und höher bietet das Hauptinstallationsskript an, Python 3.7 von CPython auf Intel-basierten Macs zu installieren.
   • 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-397.0.0-darwin-x86_64.tar.gz	106,6 MB	3455f1136c8a87c87c419df22bbe93787991c04c5f27a9bc0b0c2ccdd455bbf4
macOS 64-Bit (arm64, Apple M1 silicon)	google-cloud-cli-397.0.0-darwin-arm.tar.gz	105,2 MB	439654692d17796d7ffd2815bfea5423bc3a9ad07ecf57da931a98fe55c542af
macOS 32-Bit (x86)	google-cloud-cli-397.0.0-darwin-x86.tar.gz	108,6 MB	b9d36ccf9f06c25ecc7eaeb2c188bfedc415d209d4532b4e280a3efff24c0180

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

   Führen Sie das Skript (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 Skripts) 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/GoogleCloudSDKInstaller.exe", "$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. Das Cloud SDK erfordert Python. Unterstützte Versionen sind Python 3 (bevorzugt; 3.5 bis 3.8) und Python 2 (ab 2.7.9). Die Windows-Version des Cloud SDK ist standardmäßig in Python 3 und Python 2 enthalten. Um das Cloud SDK verwenden zu können, muss das Betriebssystem in der Lage sein, eine unterstützte Version von Python auszuführen.

   Seit dem 1. Januar 2020 aktualisiert die Python-Community keine Programmfehler, Patches oder Sicherheitsprobleme für Python 2 mehr. Wir empfehlen, so bald wie möglich ein Upgrade auf Python 3 durchzuführen. Weitere Informationen finden Sie unter Python 2-Unterstützung in Google Cloud.

   Das Installationsprogramm installiert alle notwendigen Abhängigkeiten, darunter die erforderliche Version von Python. Das Cloud SDK 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.

Informationen zur Verwendung von gsutil finden Sie unter Kurzanleitung: gsutil-Tool verwenden. Alternativ können Sie gsutil help ausführen.

Alternative Installationsmethoden

Sie haben verschiedene Möglichkeiten, gsutil als eigenständiges Produkt zu installieren. Dies ist vorzuziehen, wenn Sie die anderen Komponenten der gcloud CLI nicht benötigen oder wenn Sie Pakete mit PyPI verwalten.

Wenn Sie gsutil 5.0 oder höher installieren, muss Python 3 auf Ihrem Computer installiert sein. Python 3.5 bis 3.8 wird dabei bevorzugt. Python 3 ist jedoch standardmäßig auf den meisten Linux- und macOS-Distributionen installiert.

• Python 3 ist nicht standardmäßig unter Windows installiert, kann aber manuell installiert werden.
• Python 3 ist möglicherweise nicht standardmäßig auf CentOS oder RHEL installiert. Wenn es derzeit nicht installiert ist, können Sie es manuell installieren.

Maximieren Sie die gewünschte Methode, um Anweisungen zum Installieren von gsutil zu erhalten.

Aus einem TAR- oder ZIP-Archiv installieren

Linux und macOS

1. Sie können gsutil als gsutil.tar.gz oder gsutil.zip herunterladen. Es ist egal, für welches Format Sie sich entscheiden. In dieser Anleitung wird jedoch die Installation aus der Datei gsutil.tar.gz beschrieben.

   Unabhängig vom Format ist gsutil in einem einzigen Archiv verpackt. Speichern Sie dieses an einem geeigneten Ort.

2. Extrahieren Sie die Dateien.

   Öffnen Sie ein Shell-Fenster, wechseln Sie in das Verzeichnis, in das Sie gsutil heruntergeladen haben, und führen Sie den folgenden Befehl aus:

   tar xfz gsutil.tar.gz -C $HOME

   Damit wird gsutil in Ihrem Basisverzeichnis installiert und ein Verzeichnis namens gsutil erstellt. Das Verzeichnis gsutil sollte das gsutil-Tool, das Verzeichnis "gslib" sowie das Verzeichnis "third_party" mit mehreren Unterverzeichnissen enthalten, in denen sich unter anderem die Boto-Bibliothek befindet.

   Falls Sie gsutil nicht im Basisverzeichnis installieren möchten, ersetzen Sie $HOME durch einen anderen Speicherort auf Ihrem Computer.

3. Fügen Sie gsutil der PATH-Umgebungsvariable hinzu.

   Fügen Sie unter Linux in der Datei "~/.bashrc" bzw. unter macOS in der Datei "~/.bash_profile" die folgende Zeile hinzu:

   export PATH=${PATH}:$HOME/gsutil

   Falls Sie gsutil nicht im Basisverzeichnis installiert haben, müssen Sie $HOME/gsutil zum tatsächlichen Installationsort von gsutil ändern.

4. Starten Sie das Shell- oder Terminalprogramm neu.

   Unter Umständen müssen Sie das Shell- oder Terminalprogramm neu starten, damit die Änderung der PATH-Umgebungsvariable wirksam wird.

Jetzt können Sie mit gsutil arbeiten. Führen Sie über eine Eingabeaufforderung den Befehl gsutil aus, um eine Liste der gsutil-Befehle aufzurufen.

Windows

1. Laden Sie Python herunter und installieren Sie es.

   Installieren Sie eine Version von Python, die mit gsutil funktioniert (siehe Systemanforderungen oben). Wir empfehlen, eine 32-Bit-Version von Python im Standardverzeichnis zu installieren (zum Beispiel C:\Python38).

2. Laden Sie gsutil herunter.

   gsutil ist in einem Archiv namens gsutil.zip enthalten. Speichern Sie dieses an einem geeigneten Ort, z. B. C:\.

3. Extrahieren Sie die Archivdateien.

   Wir empfehlen, die Archivdateien in das Stammverzeichnis zu extrahieren. Dabei wird ein Verzeichnis namens gsutil im Stammverzeichnis erstellt (z. B. C:\gsutil), in dem das gsutil-Tool sowie alle benötigten Bibliotheken und anderen Dateien enthalten sind.

4. Führen Sie gsutil über eine Eingabeaufforderung aus, um eine Liste der gsutil-Befehle abzurufen.

   Für das Ausführen von gsutil-Befehlen unter Windows benötigen Sie den Python-Interpreter. Führen Sie beispielsweise über eine Eingabeaufforderung den Befehl python gsutil aus, um eine Liste der gsutil-Befehle aufzurufen. Falls Sie gsutil außerhalb des Verzeichnisses C:\gsutil ausführen, müssen Sie außerdem den vollständigen Pfad zur ausführbaren gsutil-Datei angeben. Wenn gsutil beispielsweise im Verzeichnis C:\Users\Admin\MyDocuments installiert wurde, geben Sie python C:\gsutil\gsutil ein.

Jetzt können Sie mit gsutil arbeiten.

Verwendung von gsutil vereinfachen

Sie können das Ausführen von gsutil vereinfachen. Dazu erstellen Sie eine gsutil.cmd-Befehlsdatei mit folgendem Inhalt (vorausgesetzt, Sie haben Python und gsutil wie oben beschrieben installiert):

cmd.exe /C C:\Python38\python.exe "C:\gsutil\gsutil" %*"

Wenn Sie anschließend den Verzeichnispfad von gsutil.cmd dem Systempfad hinzufügen, können Sie gsutil COMMAND von überall ausführen. COMMAND steht hier für einen gültigen gsutil-Befehl.

Eigenständig installiertes gsutil-Tool aktualisieren

Bei Verwendung von gsutil als eigenständiges Produkt verfügt das Tool über einen integrierten Aktualisierungsbefehl, der nach der neuesten gsutil-Version sucht und Ihnen anbietet, automatisch darauf zu aktualisieren, falls sie sich von der Version unterscheidet, die derzeit installiert ist. Verwenden Sie den Befehl gsutil update (oder python gsutil update für Windows).

Aus dem Python-Paketindex (PyPI) installieren

In Entwicklungsphase

Die Installation von gsutil über PyPI ist ein neues Feature von Cloud Storage, das sich noch in der Entwicklungsphase befindet und sich daher häufig ändert. Dabei kann es unter Umständen zu rückwärtsinkompatiblen Änderungen kommen. Wir informieren die Community, sobald die Funktion nicht mehr in der Entwicklungsphase ist.
 

CentOS, RHEL und Fedora

1. Installieren Sie die erforderlichen Systempakete.

   Für die erfolgreiche Installation von gsutil aus PyPI sind mehrere Pakete erforderlich. Diese können Sie mit dem folgenden Befehl installieren:

   sudo yum install gcc openssl-devel python-devel python-setuptools libffi-devel

2. Installieren Sie pip.

   Wir empfehlen die Verwendung des pip-Installationsprogramms. Dieses können Sie mit dem folgenden Befehl installieren:

   sudo yum install python-pip

   Wenn Sie CentOS oder RHEL verwenden und yum das Paket python-pip nicht finden kann, liegt dies wahrscheinlich daran, dass Sie die Repository-Quelle EPEL (Extra Packages for Enterprise Linux) nicht aktiviert haben. Folgen Sie dieser Anleitung, um sie zu aktivieren.

3. Installieren Sie gsutil aus PyPI.

   Führen Sie den folgenden Befehl aus, um gsutil aus PyPI zu installieren:

   sudo pip install gsutil

Jetzt können Sie mit gsutil arbeiten. Führen Sie über eine Eingabeaufforderung den Befehl gsutil aus, um eine Liste der gsutil-Befehle aufzurufen.

Debian und Ubuntu

1. Installieren Sie die erforderlichen Systempakete.

   Für die erfolgreiche Installation von gsutil aus PyPI sind mehrere Pakete erforderlich. Diese können Sie mit dem folgenden Befehl installieren:

   sudo apt-get install gcc python-dev python-setuptools libffi-dev

2. Installieren Sie pip.

   Wir empfehlen die Verwendung des pip-Installationsprogramms. Dieses können Sie mit dem folgenden Befehl installieren:

   sudo apt-get install python-pip

3. Installieren Sie gsutil aus PyPI.

   Führen Sie den folgenden Befehl aus, um gsutil aus PyPI zu installieren:

   sudo pip install gsutil

Jetzt können Sie mit gsutil arbeiten. Führen Sie über eine Eingabeaufforderung den Befehl gsutil aus, um eine Liste der gsutil-Befehle aufzurufen.

macOS

1. Installieren Sie pip.

   Wir empfehlen die Verwendung des pip-Installationsprogramms. Dieses können Sie mit dem folgenden Befehl installieren:

   sudo easy_install -U pip

2. Installieren Sie gsutil aus PyPI.

   Führen Sie den folgenden Befehl aus, um gsutil aus PyPI zu installieren:

   sudo pip install gsutil

Jetzt können Sie mit gsutil arbeiten. Führen Sie über eine Eingabeaufforderung den Befehl gsutil aus, um eine Liste der gsutil-Befehle aufzurufen.

Windows

1. pip installieren

   Führen Sie diesen Befehl aus:

   python -m ensurepip

2. gsutil aus PyPI installieren

   Führen Sie den folgenden Befehl aus, um gsutil aus PyPI zu installieren:

   pip install gsutil

Jetzt können Sie mit gsutil arbeiten. Führen Sie über eine Eingabeaufforderung den Befehl gsutil aus, um eine Liste der gsutil-Befehle aufzurufen.

Aus PyPI installiertes gsutil-Tool aktualisieren

Der Befehl zum Aktualisieren von gsutil ist bei der Installation über PyPI nicht verfügbar. Nutzen Sie stattdessen das pip-Installationsprogramm:

sudo pip install -U gsutil

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

Nach der Installation von gsutil können Sie öffentlich zugängliche Daten herunterladen und darauf zugreifen. Um jedoch 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 installiert haben, folgen Sie dieser Anleitung. Ansonsten lesen Sie den Abschnitt Eigenständiges gsutil-Tool authentifizieren.

Hinweis: Mit dem Befehl gsutil version -l können Sie prüfen, ob Sie gsutil aus der gcloud CLI oder als eigenständiges Produkt verwenden. Achten Sie in der Ausgabe auf „using cloud sdk“.

Google Cloud CLI authentifizieren

Wenn Sie gsutil als Teil der Google Cloud CLI nutzen, wird OAuth2 zur Authentifizierung und Autorisierung des Zugriffs verwendet. Die folgenden Schritte haben Sie möglicherweise bereits ausgeführt, wenn Sie wie unter gsutil als Teil der Google Cloud CLI installieren (siehe oben) vorgegangen sind. Wenn Sie zuvor gcloud init ausgeführt haben, werden Sie gefragt, ob Sie die Konfiguration neu initialisieren oder eine neue erstellen möchten.

1. Öffnen Sie eine Eingabeaufforderung.

2. Führen Sie über die Eingabeaufforderung gcloud init aus.

   Sie erhalten die folgende Ausgabe:

   Welcome! This command will take you through the configuration of gcloud.
    
   Your current configuration has been set to: [default]
    
   To continue, you must login. Would you like to login (Y/n)?
   

3. Geben Sie "Y" ein und drücken Sie die Eingabetaste, um sich anzumelden.

   • Der Befehl gibt eine URL aus und versucht, ein Browserfenster zu öffnen, um den Zugriff auf Ihr Projekt anzufordern. Wenn ein Browserfenster geöffnet werden kann, erhalten Sie die folgende Ausgabe:

     Your browser has been opened to visit:
      
     https://accounts.google.com/o/oauth2/auth?redirect_uri=http%3A%2F%2F...
     

     Fahren Sie mit dem nächsten Schritt fort.

   • Wenn Sie auf einem lokalen Computer arbeiten und Ihr Browser die URL nicht automatisch lädt, wiederholen Sie den Befehl gcloud init mit dem Flag --console-only:

     gcloud init --console-only
     

     Wenn Sie diesen Befehl verwenden oder die gcloud CLI erkennt, dass kein Browser geöffnet werden kann (z. B. weil Sie auf einem Remote-Computer arbeiten), erhalten Sie die folgende Ausgabe:

     Go to the following link in your browser:
      
     https://accounts.google.com/o/oauth2/auth?redirect_uri=urn%3Aietf%3Awg%3A...
      
     Enter verification code:
     

     Öffnen Sie einen Browser und gehen Sie zur angegebenen URL.

4. Falls Sie dazu aufgefordert werden, melden Sie sich im Browserfenster mit dem Google-Konto an, das mit Ihren Cloud Storage-Daten verknüpft ist.

5. Gewähren Sie den Zugriff.

   • Falls sich das Browserfenster automatisch öffnet, prüfen Sie die Anwendungsberechtigungen und klicken Sie anschließend auf Akzeptieren. Der Bestätigungscode wird dann automatisch an das Befehlszeilentool gesendet.

   • Falls Sie an einem Remote-Computer arbeiten oder das Flag --console-only verwendet haben, kopieren Sie den Bestätigungscode aus der URL und fügen Sie ihn hinter Enter verification code: in die Terminalbefehlszeile ein.

6. Wählen Sie das Standardprojekt für die Konfiguration aus.

   Nachdem Sie Ihre Anmeldedaten eingerichtet haben, werden Sie von der Google Cloud CLI zu einem Standardprojekt für diese Konfiguration aufgefordert und erhalten eine Liste der verfügbaren Projekte. Wählen Sie eine Projekt-ID aus der Liste aus.

   Wenn Sie dieses Attribut festlegen, verwenden gsutil-Befehle, für die ein Projekt, z. B. gsutil mb, erforderlich ist, die Standardprojekt-ID, es sei denn, Sie überschreiben sie mit dem Flag -p oder legen die Umgebungsvariable CLOUDSDK_CORE_PROJECT fest.

Hinweis: Falls Sie die Compute Engine API aktiviert haben, werden Sie daraufhin von gcloud init möglicherweise aufgefordert, eine Standardzone und -region für das Projekt festzulegen. Ihre Auswahl hat keinen Einfluss auf die Funktionsweise von gsutil..

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.

Eigenständiges gsutil-Tool authentifizieren

Maximieren Sie diese Anleitung zum Einrichten Ihrer Anmeldedaten, wenn Sie gsutil nicht als Teil der Google Cloud CLI installiert haben.

Hinweis: Diese Anleitung gilt für die Verwendung von Anmeldedaten für Nutzerkonten. Verwenden Sie gsutil config -e, um die Anmeldedaten des Dienstkontos zu verwenden.

1. Öffnen Sie eine neue Eingabeaufforderung.
2. (Nur Windows): Wechseln Sie in das Verzeichnis, in dem Sie gsutil installiert haben (Standard ist C:\gsutil).
3. Führen Sie gsutil config über die Eingabeaufforderung aus (für Windows: python gsutil config).

   Wenn Sie diesen Befehl zum ersten Mal ausführen, gibt gsutil eine URL für die Autorisierungsseite aus, auf der Sie gsutil für den Cloud Storage-Zugriff autorisieren können. Das gsutil-Dialogfeld sieht in etwa so aus:

   This script creates a boto config file at YOUR_HOMEDIR/.boto
   containing your credentials, based on your responses to the following questions.
   
   Please navigate your browser to the following URL: <http://urlto/authorization/dialog>
   In your browser you should see a page that requests you to authorize gsutil to access
   Cloud Storage on your behalf. After you approve, an authorization code is displayed.
   
   Enter the authorization code:
   

   Hinweis: Wenn gsutil ein Browserfenster für Sie öffnen soll, verwenden Sie gsutil config -b (für Windows: python gsutil config -b). Falls Sie über SSH eine Verbindung zu einem Remote-Computer herstellen, funktioniert die Option -b möglicherweise nicht.

   
   
4. Kopieren Sie die URL in ein Browserfenster.

   Wenn Sie dazu aufgefordert werden, melden Sie sich im Browserfenster mit dem Google-Konto an, das mit Ihren Cloud Storage-Daten verknüpft ist.

5. Klicken Sie auf "Allow Access".

   Damit autorisieren Sie gsutil für den Zugriff auf Cloud Storage.

6. Kopieren Sie den Autorisierungscode, der auf der nächsten Seite angezeigt wird, in die Eingabeaufforderung von gsutil und drücken Sie die Eingabetaste.

   Nachdem Sie den Autorisierungscode angegeben haben, gibt gsutil Folgendes aus:

   Please navigate your browser to the following URL:
   https://console.cloud.google.com/
   What is your project-id?
   

7. Geben Sie eine Projekt-ID in die Eingabeaufforderung von gsutil ein.

   Wenn Sie eine Projekt-ID erhalten haben, können Sie diese hier eingeben. Andernfalls kopieren Sie die URL in ein Browserfenster und melden Sie sich in der Google Cloud Console an, um eine Projekt-ID zu suchen. (Klicken Sie dazu im Drop-down rechts oben auf Alle Projekte verwalten.)

   Dieses Projekt wird in gsutil als Standardprojekt festgelegt. Es kann immer nur eine Projekt-ID für gsutil eingerichtet werden. Sie können die Projekt-ID für gsutil jedoch ändern, indem Sie die Boto-Konfigurationsdatei bearbeiten.

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.

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 das Flag -a im Befehl gsutil config:

gsutil config -a

Mit diesem Befehl starten Sie einen ähnlichen Vorgang wie bei der Authentifizierung des eigenständigen gsutil-Tools (siehe vorherigen Abschnitt). Allerdings werden Sie zur Angabe der Zugriffs-ID und des Secrets aufgefordert, die mit Ihrem HMAC-Schlüssel verknüpft sind.

Wenn Sie die Google Cloud CLI verwenden, sollten Sie außerdem die Übergabe der Anmeldedaten mithilfe des folgenden Befehls deaktivieren:

gcloud config set pass_credentials_to_gsutil false

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