Wie richte ich einen Google-Cloud-Bucket ein?

Verwenden Sie ein Google-Cloud-Projekt, einen privaten Bucket und ein Dienstkonto, das nur für Transloadit vorgesehen ist. Sie benötigen Berechtigungen, um den Bucket zu erstellen, seinen IAM-Zugriff zu verwalten sowie ein Dienstkonto und dessen JSON-Schlüssel zu erstellen. Für die Speicherung in Google Cloud und die Verarbeitung mit Transloadit fallen Gebühren an.

1. Privaten Bucket erstellen

Folgen Sie der Anleitung von Google zum Erstellen eines Buckets. Verwenden Sie den einheitlichen Zugriff auf Bucket-Ebene, damit IAM den Zugriff steuert statt einzelner Objekt-ACLs. Gewähren Sie keinen öffentlichen Zugriff. Notieren Sie den Bucket-Namen und die Projekt-ID für die nächsten Schritte.

2. Einem Dienstkonto Zugriff auf diesen Bucket gewähren

Erstellen Sie ein eigenes Dienstkonto und weisen Sie ihm die Rolle Storage Object Creator für diesen Bucket zu, nicht für Ihr gesamtes Projekt. Diese Rolle kann Objekte erstellen, aber bestehende Objekte weder lesen noch löschen oder überschreiben. Das folgende Beispiel verwendet die standardmäßigen eindeutigen Ausgabepfade des Robots. Wenn Sie feste Pfade wählen oder Import-Steps hinzufügen, prüfen Sie die für diesen Ablauf erforderlichen Berechtigungen, statt umfassende Administratorrechte zu vergeben.

Diese Verbindung mit Transloadit verwendet die JSON-Schlüsseldatei eines Dienstkontos. Folgen Sie der Anleitung von Google zum Erstellen eines Schlüssels und laden Sie einen JSON-Schlüssel für das eigens eingerichtete Dienstkonto herunter. Halten Sie ihn geheim. Wenn Ihre Organisation Dienstkontoschlüssel verbietet, wenden Sie sich an Ihre Administration, statt diese Richtlinie zu umgehen. Eine OAuth-Clientdatei oder ein HMAC-Zugriffsschlüssel ersetzt diesen JSON-Schlüssel nicht.

3. Template-Zugangsdaten speichern

Folgen Sie der Anleitung zum Erstellen von Template-Zugangsdaten und wählen Sie Google Cloud Storage als Dienst. Füllen Sie diese Felder aus:

Konsolenfeld	Wert
Google-Projekt-ID	Die ID Ihres Google-Cloud-Projekts.
Google-Cloud-Storage-Bucket	Der Bucket-Name ohne das Präfix `gs://`.
Google-JSON-Schlüsseldatei	Die heruntergeladene JSON-Schlüsseldatei des Dienstkontos.

Geben Sie diesem Zugangsdaten-Eintrag einen leicht erkennbaren Namen. Verwenden Sie diesen Namen im folgenden Template, nicht den Inhalt der JSON-Datei oder die E-Mail-Adresse des Dienstkontos.

4. Export testen

Erstellen Sie ein Template mit diesen Anweisungen und ersetzen Sie YOUR_GOOGLE_CLOUD_CREDENTIALS durch den Namen des gespeicherten Zugangsdaten-Eintrags:

{
  "steps": {
    ":original": {
      "robot": "/upload/handle"
    },
    "exported": {
      "robot": "/google/store",
      "use": ":original",
      "credentials": "YOUR_GOOGLE_CLOUD_CREDENTIALS",
      "acl": null
    }
  }
}

Behalten Sie "acl": null bei: Damit wird die Objekt-ACL weggelassen und die IAM-Richtlinie des Buckets steuert den Zugriff. Wenn Sie stattdessen acl weglassen, verwendet der Robot seine Standardeinstellung für öffentlichen Lesezugriff. Diese ist mit dem einheitlichen Zugriff auf Bucket-Ebene nicht kompatibel.

Führen Sie das Template mit einem kleinen Test-Upload aus. Prüfen Sie nach Abschluss der Assembly das Exportergebnis. Bestätigen Sie mit Ihrem eigenen authentifizierten Zugriff auf die Google Cloud Console, dass das Objekt vorhanden ist. Eine reine Ergebnis-URL gewährt keinen anonymen Zugriff auf ein privates Objekt. Machen Sie den Bucket nicht öffentlich, nur um diese URL zu testen.

Hinweis

Eine Assembly kann fehlschlagen, wenn ein automatischer Upload-Versuch das Objekt erstellt, aber die Bestätigung verloren geht: Ein automatischer Wiederholungsversuch kann dieses Objekt mit der Rolle Storage Object Creator nicht ersetzen. Prüfen Sie das gemeldete Ziel und den Assembly-Fehler, bevor Sie Berechtigungen ändern. Ein vorhandenes Objekt allein bestätigt nicht, dass der gesamte Export erfolgreich war. Um den Vorgang manuell zu wiederholen, starten Sie eine neue Assembly mit einem neuen Upload und den standardmäßigen eindeutigen Ausgabepfaden des Beispiels, statt Berechtigungen zum Überschreiben oder Löschen hinzuzufügen.

Weiterführendes

Informationen zur Einrichtung und Sicherheit von Templates finden Sie in der Template-Dokumentation.
Informationen zu Pfaden, Berechtigungen und weiteren Exportoptionen finden Sie in der Dokumentation zu 🤖/google/store.

Wie richte ich einen Google-Cloud-Bucket ein?

Weiterführendes

Siehe auch: