gsutil installieren

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.

Systemanforderungen

gsutil installieren

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
  1. Geben Sie in der Eingabeaufforderung Folgendes ein:
    curl https://sdk.cloud.google.com | bash
  2. Starten Sie die Shell neu:
    exec -l $SHELL
  3. 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. Das Paket umfasst nur die Befehle von gcloud, gcloud alpha, gcloud beta, gsutil und bq. Es enthält weder kubectl noch die App Engine-Erweiterungen, die zur Bereitstellung einer Anwendung mithilfe von gcloud-Befehlen nötig 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:

  1. Erstellen Sie eine Umgebungsvariable für die richtige Distribution:
    export CLOUD_SDK_REPO="cloud-sdk-$(lsb_release -c -s)"
  2. Fügen Sie den URI der Cloud SDK-Distribution als Paketquelle hinzu:
    echo "deb http://packages.cloud.google.com/apt $CLOUD_SDK_REPO main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list
    Hinweis: Wenn Sie apt-transport-https installiert haben, können Sie in diesem Schritt "https" anstelle von "http" verwenden.
  3. Importieren Sie den öffentlichen Google Cloud-Schlüssel:
    curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -
    Tipp zur Fehlerbehebung: Wenn Sie aufgrund eines abgelaufenen Schlüssels keine aktuellen Updates erhalten können, rufen Sie die aktuelle Schlüsseldatei "apt-get.gpg" ab.
  4. Aktualisieren und installieren Sie das Cloud SDK:
    sudo apt-get update && sudo apt-get install google-cloud-sdk
    Hinweis: Weitere Optionen für apt-get wie das Deaktivieren von Eingabeaufforderungen oder Probeläufe finden Sie auf den Manpages für apt-get.
  5. Sie können eine oder mehrere zusätzliche Komponenten installieren:
    • google-cloud-sdk-app-engine-python
    • google-cloud-sdk-app-engine-python-extras
    • google-cloud-sdk-app-engine-java
    • google-cloud-sdk-app-engine-go
    • google-cloud-sdk-datalab
    • google-cloud-sdk-datastore-emulator
    • google-cloud-sdk-pubsub-emulator
    • google-cloud-sdk-cbt
    • google-cloud-sdk-cloud-build-local
    • google-cloud-sdk-bigtable-emulator
    • kubectl

    Die Komponente google-cloud-sdk-app-engine-java kann beispielsweise so installiert werden:

    sudo apt-get install google-cloud-sdk-app-engine-java
  6. Führen Sie gcloud init aus, um die Initialisierung zu starten:
    gcloud init
macOS
  1. Geben Sie in der Eingabeaufforderung Folgendes ein:
    curl https://sdk.cloud.google.com | bash
  2. Starten Sie die Shell neu:
    exec -l $SHELL
  3. Führen Sie gcloud init aus, um die gcloud-Umgebung zu initialisieren:
    gcloud init
Windows
  1. Laden Sie das Cloud SDK-Installationsprogramm herunter. Das Installationsprogramm ist von Google Inc. signiert.

  2. Starten Sie das Installationsprogramm und folgen Sie den Anweisungen.

    Für 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.

  3. Akzeptieren Sie nach Abschluss der Installation die folgenden Optionen:

    • Start Cloud SDK Shell (Cloud SDK Shell starten)
    • Run gcloud init (gcloud init ausführen)

  4. Das Installationsprogramm startet ein Terminalfenster und führt den Befehl gcloud init aus.

  5. Die App Engine-Erweiterungen, die zur Bereitstellung einer Anwendung mithilfe von gcloud-Befehlen benötigt werden, sind in der Standardinstallation nicht enthalten. Diese Komponenten können mit dem Cloud SDK-Komponentenmanager installiert werden.

Hinweis: Auf Google Compute Engine-Instanzen, die Windows Server ausführen, ist für Internet Explorer die verstärkte Sicherheitskonfiguration aktiviert. Diese Einstellung verhindert die Ausführung des obigen Installationsprogramms. Deaktivieren Sie zuerst "Verstärkte Sicherheitskonfiguration", starten Sie den Internet Explorer neu und führen Sie dann das Installationsprogramm aus. Eine Anleitung zur Deaktivierung von "Verstärkte Sicherheitskonfiguration" für die Windows Server-Instanz erhalten Sie, wenn Sie "Windows-Hilfe und Support" öffnen und nach "Verstärkte Sicherheitskonfiguration für IE" suchen.

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

Informationen zur Verwendung von gsutil finden Sie in Schnellstart: 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 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 unter Python 3.x nicht. 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.

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.

  1. Öffnen Sie eine Eingabeaufforderung.

  2. Führen Sie darin 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 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.

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

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

    Nachdem Sie Ihre Anmeldedaten eingerichtet haben, fordert Sie das Befehlszeilentool gcloud 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 auch schon. 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

Mit HMAC authentifizieren

OAuth 2.0 ist zwar die empfohlene Methode zur Authentifizierung von gsutil, Sie können aber auch die HMAC-Authentifizierung und Entwicklerschlüssel verwenden. Führen Sie dazu den Befehl gsutil config mit dem Flag -a aus:

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 müssen Sie hier Ihre Google-Zugriffsschlüssel-ID und Ihren geheimen Zugriffsschlüssel angeben.

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:

Feedback geben zu...