Auf dieser Seite werden die Installation und Einrichtung von gsutil beschrieben. Mit diesem Tool können Sie ü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.
Systemvoraussetzungen
Das gsutil-Tool läuft unter Linux/Unix, Mac OS und Windows (XP oder neuer).
Nur die Installation und Aktualisierung von gsutil als Teil des Google Cloud SDK wird offiziell unterstützt.
gsutil als Teil des Google Cloud SDK installieren
Folgen Sie der Anleitung für Ihr Betriebssystem, um gsutil als Teil des Google Cloud SDK zu installieren:
Linux
Geben Sie in der Eingabeaufforderung Folgendes ein:
curl https://sdk.cloud.google.com | bash
Starten Sie die Shell neu:
exec -l $SHELL
Führen Sie gcloud init aus, um die gcloud-Umgebung zu initialisieren:
gcloud init
Debian/Ubuntu
Das Cloud SDK steht im Paketformat zur Installation auf Debian- und Ubuntu-Systemen zur Verfügung. 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 gemäß der Anleitung weiter unten in diesem Abschnitt separat installieren.
Sie können das Cloud SDK aus einem Debian- bzw. Ubuntu-Paket installieren. Dies gilt für alle weiterhin unterstützten offiziellen Ubuntu-Releases sowie für stabile Debian-Releases ab der Version Wheezy.
Hinweis: Wenn Sie eine Google Compute Engine-Instanz verwenden, wird das Cloud SDK standardmäßig installiert. Sie können das Cloud SDK aber auch manuell installieren:
Fügen Sie den URI der Cloud SDK-Distribution als Paketquelle hinzu:
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
Starten Sie das Installationsprogramm und folgen Sie den Anweisungen. Das Installationsprogramm ist von Google LLC signiert.
Für das Cloud SDK ist Python 2 mit einer Release-Version von Python 2.7.9 oder höher erforderlich.
Das Installationsprogramm installiert standardmäßig alle notwendigen Abhängigkeiten, darunter die erforderliche Version von Python. Falls Python 2.x.y. bereits installiert ist und Sie die vorhandene Installation verwenden möchten, können Sie das Häkchen bei der Option Python gebündelt installieren entfernen.
Akzeptieren Sie nach Abschluss der Installation die folgenden Optionen:
Start Cloud SDK Shell (Cloud SDK Shell starten)
"gcloud init" ausführen
Das Installationsprogramm startet ein Terminalfenster und führt den Befehl gcloud init aus.
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 Cloud SDK-Komponentenmanager installiert werden.
Führen Sie Updates mit dem Befehl components update aus: gcloud components update.
Sie haben verschiedene Möglichkeiten, gsutil als eigenständiges Produkt zu installieren. Dies ist vorzuziehen, wenn Sie die anderen Komponenten des Cloud SDK nicht benötigen oder wenn Sie Pakete mit PyPI verwalten.
Wenn Sie gsutil als eigenständiges Produkt installieren möchten, muss auf Ihrem Computer Python 2.7.x installiert sein. gsutil läuft derzeit nicht unter Python 3.x. Python ist standardmäßig auf den meisten Linux- und macOS-Distributionen installiert. Dies gilt jedoch nicht für Windows. Hier müssen Sie zuerst Python installieren, bevor Sie gsutil ausführen können.
Maximieren Sie die gewünschte Methode, um die Anleitung zu lesen.
Aus einem TAR- oder ZIP-Archiv installieren
Linux und macOS
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.
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.
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.
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.
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:\Python27).
gsutil ist in einem Archiv namens gsutil.zip enthalten. Speichern Sie dieses an einem geeigneten Ort, z. B. C:\.
Extrahieren Sie die Dateien.
Wir empfehlen, die Dateien 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.
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 Befehlsdatei gsutil.cmd mit folgendem Inhalt (vorausgesetzt, Sie haben Python und gsutil wie oben beschrieben installiert):
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.
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, wenn 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
Erforderliche Systempakete installieren
Für die erfolgreiche Installation von gsutil aus PyPI sind mehrere Pakete erforderlich. Diese können Sie mit dem folgenden Befehl installieren:
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.
gsutil aus PyPI installieren
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
Erforderliche Systempakete installieren
Für die erfolgreiche Installation von gsutil aus PyPI sind mehrere Pakete erforderlich. Diese können Sie mit dem folgenden Befehl installieren:
Wir empfehlen die Verwendung des pip-Installationsprogramms. Dieses können Sie mit dem folgenden Befehl installieren:
sudo apt-get install python-pip
gsutil aus PyPI installieren
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
pip installieren
Wir empfehlen die Verwendung des pip-Installationsprogramms. Dieses können Sie mit dem folgenden Befehl installieren:
sudo easy_install -U pip
gsutil aus PyPI installieren
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
pip installieren
Wenn Sie Python in der Version 2.7.9 oder höher verwenden, führen Sie den folgenden Befehl aus:
python -m ensurepip
Laden Sie andernfalls die Datei get-pip.py herunter, mit der Sie pip installieren können, und verwenden Sie dann den folgenden Befehl, um pip zu installieren:
python get-pip.py
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 Objekte 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 des Google Cloud SDK installiert haben, folgen Sie dieser Anleitung. Ansonsten lesen Sie den Abschnitt Eigenständiges gsutil-Tool authentifizieren.
Google Cloud SDK authentifizieren
Wenn Sie gsutil als Teil des Google Cloud SDK 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 des Google Cloud SDK 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.
Öffnen Sie eine Eingabeaufforderung.
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)?
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 das Cloud SDK 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.
Wenn Sie dazu aufgefordert werden, melden Sie sich im Browserfenster mit dem Google-Konto an, das mit Ihren Cloud Storage-Daten verknüpft ist.
Gewähren Sie den Zugriff.
Wenn das Browserfenster automatisch geöffnet wurde, überprüfen Sie die Anwendungsberechtigungen und klicken Sie anschließend auf Akzeptieren. Der Bestätigungscode wird dann automatisch an das Befehlszeilentool gesendet.
Wenn 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 Bestätigungscode eingeben: in die Terminalbefehlszeile ein.
Wählen Sie das Standardprojekt für die Konfiguration aus.
Nachdem Sie Ihre Anmeldedaten eingerichtet haben, fordert Sie das gcloud-Befehlszeilentool zur Angabe eines Standardprojekts für die Konfiguration auf und stellt eine Liste der verfügbaren Projekte bereit. Wählen Sie eine Projekt-ID aus der Liste aus.
Wenn Sie dieses Attribut festlegen, verwenden gsutil-Befehle, für die ein Projekt erforderlich ist, z. B. gsutil mb, die Standardprojekt-ID, es sei denn, Sie überschreiben sie mit dem Flag -p oder legen die Umgebungsvariable CLOUDSDK_CORE_PROJECT fest.
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 des Google Cloud SDK installiert haben.
Öffnen Sie eine neue Eingabeaufforderung.
(Nur Windows): Wechseln Sie in das Verzeichnis, in dem Sie gsutil installiert haben (Standard ist C:\gsutil).
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 zur 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.
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.
Klicken Sie auf "Zugriff erlauben".
Damit autorisieren Sie gsutil für den Zugriff auf Cloud Storage.
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?
Geben Sie eine Projekt-ID in die Eingabeaufforderung von gsutil ein.
Wenn Sie eine Projekt-ID erhalten haben, können Sie diese hier eingeben. Ansonsten kopieren Sie die URL in ein Browserfenster und melden sich bei der Google Cloud Platform 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 den 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 das Google Cloud SDK verwenden, sollten Sie außerdem die Übergabe der Anmeldedaten mithilfe des folgenden Befehls deaktivieren:
gcloud config set pass_credentials_to_gsutil false
Hat Ihnen diese Seite weitergeholfen? Teilen Sie uns Ihr Feedback mit:
Weitere Fragen?