Mit einem Cloud Storage-Bucket können Sie Dateien wie Filme, Bilder oder andere statische Inhalte speichern und bereitstellen. In diesem Dokument wird beschrieben, wie Sie Ihre Umgebung für die Verwendung der App Engine-Clientbibliothek für Cloud Storage einrichten.
Projekt wird eingerichtet
Erstellen Sie ein Google Cloud-Projekt und machen Sie sich mit der Struktur von Go 1.11-Anwendungen in App Engine vertraut. Sie sollten sich die Projekt-ID Ihrer Anwendung notieren.
Cloud Storage-Buckets aktivieren
Zur Verwendung von Cloud Storage müssen Sie mindestens einen Bucket aktivieren. Am besten verwenden Sie den Standard-Bucket, mit dem die ersten 5 GB Speicherplatz kostenlos zur Verfügung gestellt werden. Sie können einen weiteren Cloud Storage-Bucket aktivieren und verwenden. Der Standard-Bucket enthält die ersten 5 GB Speicherplatz kostenlos. Der Standard-Bucket enthält auch ein kostenloses Kontingent für Cloud Storage-E-/A-Vorgänge. Weitere Informationen finden Sie unter Preise, Kontingente und Beschränkungen.
So aktivieren Sie den Cloud Storage-Standard-Bucket für Ihre Anwendung:
Klicken Sie auf der Seite App Engine-Einstellungen des Projekts unter Standardmäßiger Cloud Storage-Bucket auf Erstellen. Hinweis: Der Name dieses Buckets hat das Format
<project-id>.appspot.com
.Wenn Sie mehr als 5 GB Speicherplatz benötigen, können Sie die Beschränkung aufheben, indem Sie die Abrechnung für das Projekt aktivieren. Der Bucket wird damit zu einem bezahlten Bucket. Speicherressourcen, die über die Beschränkung von 5 GB hinausgehen, werden Ihnen in Rechnung gestellt.
Wenn Sie einen oder mehrere bezahlte Buckets aktivieren möchten, finden Sie eine entsprechende Anleitung unter Bucket erstellen.
Bucket- und Objektberechtigungen festlegen
Informationen dazu, wie Sie den Zugriff auf den Storage-Bucket und seinen Inhalt durch das Dienstkonto Ihrer App oder andere Nutzer zulassen, finden Sie unter Bucket-Berechtigungen festlegen und Objektberechtigungen festlegen.
Clientbibliothek herunterladen
Die App Engine-Clientbibliothek für Cloud Storage ist über das go
-Tool verfügbar.
So laden Sie die Bibliothek herunter:
Richten Sie bei Bedarf Ihren
GOPATH
ein. Unter Linux und macOS können Sie denGOPATH
so festlegen:Laden Sie die Pakete
oauth2
,storage
undappengine
herunter:
Clientbibliothek mit dem Entwicklungs-Anwendungsserver verwenden
Sie können die Clientbibliothek mit dem Entwicklungsserver verwenden. Da Cloud Storage jedoch nicht lokal emuliert wird, müssen alle Lese- und Schreibanfragen für Dateien über das Internet an einen tatsächlichen Cloud Storage-Bucket gesendet werden.
So verwenden Sie die Clientbibliothek mit dem Entwicklungs-Anwendungsserver:
Führen Sie
dev_appserver.py
mit dem Flag--default_gcs_bucket_name [BUCKET_NAME]
aus und ersetzen Sie[BUCKET_NAME]
durch den Namen des Cloud Storage-Buckets, den Sie verwenden.Mit diesem Flag wird gesteuert, welcher Bucket zurückgegeben wird, wenn die Anwendung
file.DefaultBucketName(ctx)
aufruft.
Preise, Kontingente und Beschränkungen
Für das Aufrufen von Cloud Storage über die App Engine-Clientbibliothek fallen keine Bandbreitengebühren an. Es fallen jedoch Vorgangsgebühren an. Außerdem werden die Aufrufe von Ihrem URL-Abrufkontingent abgezogen, da die Bibliothek den URL-Abrufdienst nutzt, um mit Cloud Storage zu interagieren.
Beachten Sie, dass Cloud Storage ein kostenpflichtiger Dienst ist. Die Gebühren richten sich nach der Preisübersicht für Cloud Storage.
Alternative Möglichkeiten zum Zugriff auf Cloud Storage
Anstelle der Clientbibliothek können Sie Folgendes verwenden:
- Den Cloud Storage-Browser in der Google Cloud Console, der zum schnellen Hochladen von Objekten nützlich ist
- Das Befehlszeilentool gsutil zur Bearbeitung von Dateien in Cloud Storage
Weitere Informationen
- API-Referenzdokumentation
- Mit der App Engine-Clientbibliothek in Cloud Storage lesen und schreiben
- Beispiel für App Engine und Google Cloud Storage ansehen
- Umfassende Cloud Storage-Dokumentation mit zusätzlichen Beispielen und Anleitungen