Objektspeicher mit dem gcloud-Tool erforschen

Auf dieser Seite wird gezeigt, wie Sie grundlegende Aufgaben in Cloud Storage mit dem gcloud-Befehlszeilentool ausführen.

In Cloud Storage entstehende Kosten basieren auf den verwendeten Ressourcen. Die in dieser Kurzanleitung genutzten Cloud Storage-Ressourcen verursachen in der Regel weniger als 0,01 US-Dollar an Kosten.

Vorbereitung

  1. Melden Sie sich bei Ihrem Google Cloud-Konto an. Wenn Sie mit Google Cloud noch nicht vertraut sind, erstellen Sie ein Konto, um die Leistungsfähigkeit unserer Produkte 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.
  2. Klicken Sie in der Google Cloud Console auf der Projektauswahlseite auf Projekt erstellen, um mit der Erstellung eines neuen Google Cloud-Projekts zu starten.

    Zur Projektauswahl

  3. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  4. Installieren Sie die Google Cloud CLI.
  5. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

    gcloud init
  6. Klicken Sie in der Google Cloud Console auf der Projektauswahlseite auf Projekt erstellen, um mit der Erstellung eines neuen Google Cloud-Projekts zu starten.

    Zur Projektauswahl

  7. Die Abrechnung für das Google Cloud-Projekt muss aktiviert sein.

  8. Installieren Sie die Google Cloud CLI.
  9. Führen Sie folgenden Befehl aus, um die gcloud CLI zu initialisieren:

    gcloud init

Bucket erstellen

Buckets sind die grundlegenden Container, die Ihre Daten enthalten.

So erstellen Sie einen Bucket:

  1. Öffnen Sie ein Terminalfenster.
  2. Verwenden Sie den Befehl gcloud storage buckets create und einen nur einmal vorkommenden Namen, um einen Bucket zu erstellen:

    gcloud storage buckets create gs://my-awesome-bucket/ --uniform-bucket-level-access

    Dadurch wird ein Bucket mit dem Namen "my-awesome-bucket" erstellt. Wählen Sie Ihren eigenen global eindeutigen Bucket-Namen aus.

    Wenn der Vorgang erfolgreich ist, gibt der Befehl Folgendes zurück:

    Creating gs://my-awesome-bucket/...

Sie haben gerade einen Bucket erstellt, in dem Sie Ihre Daten speichern können.

Creating gs://my-awesome-bucket/...
ServiceException: 409 Bucket my-awesome-bucket already exists.

Versuchen Sie es noch einmal mit einem anderen Bucket-Namen.

Objekt in den Bucket laden

Das Bild eines Kätzchens

  1. Klicken Sie mit der rechten Maustaste auf das Bild oben und speichern Sie es auf Ihrem Computer, z. B. auf dem Desktop.

  2. Kopieren Sie das Bild mit dem Befehl gcloud storage cp aus seinem Speicherort in den von Ihnen erstellten Bucket:

    gcloud storage cp Desktop/kitten.png gs://my-awesome-bucket

    Wenn der Vorgang erfolgreich ist, gibt der Befehl Folgendes zurück:

    Copying file://Desktop/kitten.png [Content-Type=image/png]...
    Uploading   gs://my-awesome-bucket/kitten.png:       0 B/164.3 KiB
    Uploading   gs://my-awesome-bucket/kitten.png:       164.3 KiB/164.3 KiB

    Damit haben Sie ein Objekt in Ihrem Bucket gespeichert.

Objekt aus dem Bucket herunterladen

  1. Verwenden Sie den Befehl gcloud storage cp, um das in Ihrem Bucket gespeicherte Bild an einen beliebigen Ort auf Ihrem Computer herunterzuladen, z. B. auf den Desktop:

    gcloud storage cp gs://my-awesome-bucket/kitten.png Desktop/kitten2.png

    Wenn der Vorgang erfolgreich ist, gibt der Befehl Folgendes zurück:

    Copying gs://my-awesome-bucket/kitten.png...
    Downloading file://Desktop/kitten2.png:               0 B/164.3 KiB
    Downloading file://Desktop/kitten2.png:               164.3 KiB/164.3 KiB

    Sie haben gerade etwas aus dem Bucket heruntergeladen.

Objekt in einen Ordner im Bucket kopieren

  1. Verwenden Sie den Befehl gcloud storage cp, um einen Ordner zu erstellen und das Bild in diesen zu kopieren:

    gcloud storage cp gs://my-awesome-bucket/kitten.png gs://my-awesome-bucket/just-a-folder/kitten3.png

    Wenn der Vorgang erfolgreich ist, gibt der Befehl Folgendes zurück:

    Copying gs://my-awesome-bucket/kitten.png [Content-Type=image/png]...
    Copying     ...my-awesome-bucket/just-a-folder/kitten3.png: 164.3 KiB/164.3 KiB

    Sie haben soeben Ihr Bild in einen neuen Ordner in Ihrem Bucket kopiert.

Inhalt eines Buckets oder Ordners auflisten

  1. Verwenden Sie den Befehl gcloud storage ls, um den Inhalt auf oberster Ebene des Buckets aufzulisten:

    gcloud storage ls gs://my-awesome-bucket

    Wenn der Vorgang erfolgreich durchgeführt wurde, wird eine Meldung folgender Art angezeigt:

    gs://my-awesome-bucket/kitten.png
    gs://my-awesome-bucket/just-a-folder/

    Sie haben gerade den Inhalt auf der obersten Ebene des Buckets angesehen.

Details zu einem Objekt auflisten

  1. Verwenden Sie den Befehl gcloud storage ls mit dem Flag --long, um Details zu einem Ihrer Bilder abzurufen:

    gcloud storage ls gs://my-awesome-bucket/kitten.png --long

    Wenn der Vorgang erfolgreich durchgeführt wurde, wird eine Meldung folgender Art angezeigt:

    2638  2016-02-26T23:05:14Z  gs://my-awesome-bucket/kitten.png
    TOTAL: 1 objects, 168243.2 bytes (164.3 KiB)

    Sie haben gerade Informationen zur Größe und zum Erstellungsdatum des Bildes abgerufen.

Objekte öffentlich zugänglich machen

  1. Verwenden Sie den Befehl gcloud storage buckets add-iam-policy-binding, um allen Nutzern die Berechtigung zu erteilen, die in Ihrem Bucket gespeicherten Bilder auszulesen:

    gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer

    Der Befehl ist erfolgreich, wenn Ihre Antwort Folgendes enthält:

    bindings:
      - members:
        - allUsers
        role: roles/storage.objectViewer
    

    Jetzt kann jeder Ihre Bilder abrufen.

  2. Wenn Sie diesen Zugriff entfernen, möchten verwenden Sie den folgenden Befehl:

    gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=allUsers --role=roles/storage.objectViewer

    Der Befehl ist erfolgreich, wenn kein Fehler zurückgegeben wird.

    Sie haben den öffentlichen Zugriff auf die Bilder in Ihrem Bucket entfernt.

Zugriff auf Ihren Bucket gewähren

  1. Verwenden Sie den Befehl gcloud storage buckets add-iam-policy-binding, um einer bestimmten E-Mail-Adresse die Berechtigung zum Hinzufügen von Objekten zum Bucket zu erteilen:

    gcloud storage buckets add-iam-policy-binding gs://my-awesome-bucket --member=user:jane@gmail.com --role=roles/storage.objectCreator

    Der Befehl ist erfolgreich, wenn Ihre Antwort Folgendes enthält:

    bindings:
      - members:
        - user:jane@gmail.com
        role: roles/storage.objectCreator
    

    Nun kann jemand anderes Ihrem Bucket Elemente hinzufügen.

  2. Mit dem folgenden Befehl heben Sie diese Berechtigung wieder auf:

    gcloud storage buckets remove-iam-policy-binding gs://my-awesome-bucket --member=user:jane@gmail.com --role=roles/storage.objectCreator

    Der Befehl ist erfolgreich, wenn kein Fehler zurückgegeben wird.

    Damit haben Sie den Zugriff des Nutzers auf diesen Bucket entfernt.

Objekt löschen

  1. Verwenden Sie den Befehl gcloud storage rm, um eines Ihrer Bilder zu löschen:

    gcloud storage rm gs://my-awesome-bucket/kitten.png

    Wenn der Vorgang erfolgreich ist, gibt der Befehl Folgendes zurück:

    Removing gs://my-awesome-bucket/kitten.png...

    Diese Kopie des Bildes wird nicht mehr in Cloud Storage gespeichert. Die Kopie im Ordner just-a-folder/ ist jedoch noch vorhanden.

Bereinigen

Mit den folgenden Schritten vermeiden Sie, dass Ihrem Google Cloud-Konto die in dieser Anleitung verwendeten Ressourcen in Rechnung gestellt werden:

  1. Öffnen Sie ein Terminalfenster, wenn nicht bereits geschehen.
  2. Verwenden Sie den gcloud storage rm-Befehl mit dem Flag --recursive, um den Bucket und seinen Inhalt zu löschen:

    gcloud storage rm gs://my-awesome-bucket --recursive

    Wenn der Vorgang erfolgreich durchgeführt wurde, wird eine Meldung folgender Art angezeigt:

    Removing gs://my-awesome-bucket/just-a-folder/cloud-storage.logo.png#1456530077282000...
    Removing gs://my-awesome-bucket/...

    Der Bucket und sein Inhalt wurden gelöscht.

Nächste Schritte