Auf dieser Seite wird beschrieben, wie Sie Übertragungsjobs zwischen einem Dateisystem (entweder lokal oder in der Cloud) und Cloud Storage erstellen.
Übertragungen von Dateisystemen in Cloud Storage sind Agent-basierte Übertragungen. Das bedeutet, dass Sie Software-Agents auf einem Computer mit Zugriff auf Ihr Dateisystem installieren, um die Übertragung zu koordinieren.
Berechtigungen konfigurieren
Bevor Sie eine Übertragung erstellen, müssen Sie Berechtigungen für die folgenden Einheiten konfigurieren:
Das Nutzerkonto, das zum Erstellen der Übertragung verwendet wird. Dies ist das Konto, mit dem Sie in der Google Cloud -Konsole angemeldet sind, oder das Konto, das bei der Authentifizierung in der `gcloud`-Befehlszeile angegeben wird. Das Nutzerkonto kann ein reguläres Nutzerkonto oder ein nutzerverwaltetes Dienstkonto sein. | |
Das von Google verwaltete Dienstkonto, auch als Dienst-Agent bezeichnet, das von Storage Transfer Service verwendet wird. Dieses Konto wird in der Regel durch seine E-Mail-Adresse im Format project-PROJECT_NUMBER@storage-transfer-service.iam.gserviceaccount.com identifiziert.
|
|
![]() |
Das Transfer-Agent-Konto, das Google Cloud-Berechtigungen für Transfer-Agents bereitstellt. Für die Authentifizierung von Transfer-Agent-Konten werden die Anmeldedaten des Nutzers verwendet, der sie installiert, oder die Anmeldedaten eines nutzerverwalteten Dienstkontos. |
Eine Anleitung finden Sie unter Berechtigungen für die agentbasierte Übertragung.
Agents in einem Agent-Pool installieren
Bei Übertragungen mit Agent werden Software-Agents verwendet, um Übertragungen zu orchestrieren. Diese Agents müssen auf einem Computer mit Zugriff auf das Dateisystem installiert werden, das an der Übertragung beteiligt ist.
- Erstellen Sie einen Agent-Pool. Verwenden Sie für diese Aktion Ihr Nutzerkonto
.
- Installieren Sie Agents im Agent-Pool. Verwenden Sie für diese Aktion Ihr Transfer-Agent-Konto
.
Wir empfehlen, mit drei Agenten in Ihrem Quellagentenpool zu beginnen. Sobald die Übertragung läuft, können Sie die Übertragungsgeschwindigkeit im Blick behalten. Sie können dem Pool während der Übertragung weitere Agents hinzufügen.
Wir empfehlen eine VM pro Agent mit jeweils mindestens 4 CPUs und 8 GiB RAM.
Übertragungsoptionen
Die folgenden Storage Transfer Service-Funktionen sind für Übertragungen von Dateisystemen zu Cloud Storage verfügbar.
- Bestimmte Dateien mithilfe eines Manifests übertragen
- Sie können eine Liste von Dateien übergeben, auf die der Storage Transfer Service reagieren soll. Weitere Informationen finden Sie unter Bestimmte Dateien oder Objekte mithilfe eines Manifests übertragen.
- Speicherklasse angeben
- Sie können die
Cloud Storage-Speicherklasse angeben, die für Ihre Daten im Ziel-Bucket verwendet werden soll. Weitere Informationen zu REST finden Sie in den
StorageClass
-Optionen. Alternativ können Sie das Flag--custom-storage-class
mit der Google Cloud CLI verwenden.Alle Einstellungen für Speicherklassen werden ignoriert, wenn für den Ziel-Bucket Autoclass aktiviert ist. Wenn Autoclass aktiviert ist, werden in den Bucket übertragene Objekte anfangs auf Standard Storage festgelegt.
- Metadaten beibehalten
-
Wenn Sie Dateien aus Dateisystemen übertragen, kann Storage Transfer Service optional bestimmte Attribute als benutzerdefinierte Metadaten beibehalten. Wenn diese Dateien später in ein Dateisystem zurückgeschrieben werden, kann Storage Transfer Service die beibehaltenen Metadaten zurück in POSIX-Attribute umwandeln.
Weitere Informationen dazu, welche Metadaten beibehalten werden können und wie Sie die Übertragung konfigurieren, finden Sie im Abschnitt Übertragungen von POSIX-Dateisystemen unter Metadatenaufbewahrung.
- Netzwerkbandbreite verwalten
- Storage Transfer Service verwendet standardmäßig so viel Bandbreite wie möglich, um Dateien aus Ihrem Dateisystem zu übertragen. Sie können ein Bandbreitenlimit festlegen, um zu verhindern, dass eine Übertragung andere Netzwerkaktivitäten beeinträchtigt. Bandbreitenlimits werden auf Agent-Poolebene angewendet.
Weitere Informationen finden Sie unter Netzwerkbandbreite verwalten.
Für Ihr Nutzerkonto ist die Rolle Storage Transfer-Administrator (
roles/storagetransfer.admin
) erforderlich, um Bandbreitenlimits festzulegen oder zu ändern. - Logging
- Storage Transfer Service unterstützt Cloud Logging für Storage Transfer Service (empfohlen) sowie agentbasierte Übertragungsprotokolle.
Übertragung erstellen
Der Name des Übertragungsjobs darf keine vertraulichen Informationen wie personenidentifizierbare Informationen (PII) oder Sicherheitsdaten enthalten. Ressourcennamen können an die Namen anderer Google Cloud Ressourcen weitergegeben und für Google-interne Systeme außerhalb Ihres Projekts verfügbar gemacht werden.
Der Storage Transfer Service bietet mehrere Schnittstellen zum Erstellen einer Übertragung.
Google Cloud console
Rufen Sie in der Google Cloud -Console die Seite Storage Transfer Service auf.
Klicken Sie auf Übertragung erstellen. Die Seite Übertragungsjob erstellen wird angezeigt.
Wählen Sie POSIX-Dateisystem als Quelle aus.
Wählen Sie Cloud Storage als Zieltyp aus und klicken Sie auf Nächster Schritt.
Wählen Sie einen vorhandenen Agent-Pool aus oder wählen Sie Agent-Pool erstellen aus und folgen Sie der Anleitung zum Erstellen eines neuen Pools.
Geben Sie den vollständig qualifizierten Pfad des Dateisystemverzeichnisses an.
Klicken Sie auf Nächster Schritt.
Geben Sie im Feld Bucket oder Ordner den Ziel-Bucket und optional den Ordnernamen ein. Sie können auch auf Durchsuchen klicken, um einen Bucket aus einer Liste der vorhandenen Buckets im aktuellen Projekt auszuwählen. Zum Erstellen eines neuen Buckets klicken Sie auf
Neuen Bucket erstellen.
Klicken Sie auf Nächster Schritt.
Wählen Sie die gewünschten Zeitplanoptionen aus.
Klicken Sie auf Nächster Schritt.
Wählen Sie die Einstellungen für den Übertragungsjob aus.
Geben Sie im Feld Beschreibung eine Beschreibung der Übertragung ein. Geben Sie als Best Practice eine aussagekräftige Beschreibung ein, damit Sie die Jobs unterscheiden können.
Verwenden Sie unter Metadatenoptionen die Standardoptionen oder aktualisieren Sie einen oder mehrere Werte. Weitere Informationen finden Sie unter Metadatenaufbewahrung.
Wählen Sie unter Wann überschreiben? eine der folgenden Optionen aus:
Nie: Storage Transfer Service überspringt die Übertragung von Dateien aus der Quelle, die denselben Namen wie eine Datei im Ziel haben.
Falls unterschiedlich: Überschreibt Zieldateien, wenn die Quelldatei mit demselben Namen unterschiedliche ETags oder Prüfsummenwerte hat.
Immer: Zieldateien werden immer geschrieben, wenn die Quelldatei denselben Namen hat, auch wenn sie identisch sind.
Wählen Sie unter Löschzeitpunkt eine der folgenden Optionen aus:
Nie: Dateien werden niemals aus der Quelle oder dem Ziel gelöscht.
Datei nach der Übertragung aus der Quelle löschen: Dateien werden aus der Quelle gelöscht, nachdem sie an das Ziel übertragen wurden. Wenn eine Quelldatei nicht übertragen wird, z. B. weil sie bereits am Ziel vorhanden ist, wird sie nicht gelöscht.
Dateien aus dem Ziel löschen, wenn sie nicht auch in der Quelle sind: Wenn sich Dateien im Cloud Storage-Ziel-Bucket nicht auch in der Quelle befinden, löschen Sie die Dateien aus dem Cloud Storage-Bucket.
Mit dieser Option wird sichergestellt, dass der Cloud Storage-Ziel-Bucket genau mit Ihrer Quelle übereinstimmt.
Wählen Sie aus, ob Sie Logging in Cloud Storage aktivieren und/oder Logging in Cloud Logging aktivieren möchten. Weitere Informationen finden Sie unter Dateisystem-Übertragungsprotokolle und Cloud Logging für Storage Transfer Service.
Klicken Sie zum Erstellen des Übertragungsjobs auf Erstellen.
gcloud
Bevor Sie gcloud
-Befehle verwenden, müssen Sie die Google Cloud CLI installieren.
Verwenden Sie zum Erstellen eines neuen Übertragungsjobs den Befehl gcloud transfer jobs create
. Das Erstellen eines neuen Jobs initiiert die angegebene Übertragung, sofern weder ein Zeitplan noch --do-not-run
angegeben ist.
gcloud transfer jobs create \ posix:///SOURCE \ gs://DESTINATION/ \ --source-agent-pool=SOURCE_POOL_NAME
Wobei:
SOURCE ist ein absoluter Pfad vom Stamm des Dateisystems. Es hat das Präfix
posix://
, sodass der endgültige Wert drei Schrägstriche enthält. Beispiel:posix:///tmp/data/
DESTINATION ist der Name eines Cloud Storage-Bucket und optional ein Ordnerpfad, gefolgt von einem Schrägstrich. Beispiel:
gs://example-bucket/data/
--source-agent-pool
gibt den für diese Übertragung zu verwendenden Quell-Agent-Pool an.
Weitere Optionen:
--do-not-run
verhindert, dass Storage Transfer Service nach dem Senden des Befehls den Job ausführt. Zum Ausführen des Jobs aktualisieren Sie ihn, um einen Zeitplan hinzuzufügen, oder verwendenjobs run
, um ihn manuell zu starten.--manifest-file
gibt den Pfad zu einer CSV-Datei in Cloud Storage an, die eine Liste der Dateien enthält, die von Ihrer Quelle übertragen werden sollen. Informationen zur Formatierung von Manifestdateien finden Sie unter Bestimmte Dateien oder Objekte mithilfe eines Manifests übertragen.Jobinformationen: Sie können
--name
und--description
angeben.Zeitplan: Geben Sie
--schedule-starts
,--schedule-repeats-every
und--schedule-repeats-until
oder--do-not-run
an.Übertragungsoptionen: Bestimmen Sie, ob Zieldateien überschrieben werden sollen (
--overwrite-when=different
oderalways
) und ob bestimmte Dateien während oder nach der Übertragung gelöscht werden sollen (--delete-from=destination-if-unique
odersource-after-transfer
); welche Metadatenwerte beibehalten werden (--preserve-metadata
); und legen Sie optional eine Speicherklasse für übertragene Objekte fest (--custom-storage-class
).
Führen Sie gcloud transfer jobs create --help
aus oder sehen Sie sich die gcloud
-Referenzdokumentation an, um alle Optionen aufzurufen.
Hinweis: Nicht alle Optionen werden für agentenbasierte Übertragungen unterstützt. Nicht unterstützte Optionen enthalten einen entsprechenden Hinweis in ihrem Hilfetext.
REST
Im folgenden Beispiel wird gezeigt, wie Sie den Storage Transfer Service über die REST API verwenden.
Wenn Sie Übertragungsjobs mithilfe der Storage Transfer Service API konfigurieren oder bearbeiten, muss die Zeit in UTC angegeben werden. Weitere Informationen zum Angeben des Zeitplans eines Übertragungsjobs finden Sie unter Zeitplan.
Wenn Sie Dateien aus einem POSIX-Dateisystem in einen Cloud Storage-Bucket verschieben möchten, verwenden Sie transferJobs.create mit einem posixDataSource
:
POST https://storagetransfer.googleapis.com/v1/transferJobs { "name":"transferJobs/sample_transfer", "description": "My First Transfer", "status": "ENABLED", "projectId": "my_transfer_project_id", "schedule": { "scheduleStartDate": { "year": 2022, "month": 5, "day": 2 }, "startTimeOfDay": { "hours": 22, "minutes": 30, "seconds": 0, "nanos": 0 } "scheduleEndDate": { "year": 2022, "month": 12, "day": 31 }, "repeatInterval": { "259200s" }, }, "transferSpec": { "posixDataSource": { "rootDirectory": "/bar/", }, "sourceAgentPoolName": "my_example_pool", "gcsDataSink": { "bucketName": "destination_bucket" "path": "foo/bar/" }, } }
Das Feld schedule
ist optional. Ist dies nicht der Fall, muss der Übertragungsjob mit einer transferJobs.run
-Anfrage gestartet werden.
Mit transferJobs.get
können Sie den Status Ihrer Übertragung nach dem Erstellen eines Jobs prüfen:
GET https://storagetransfer.googleapis.com/v1/transferJobs/sample_transfer?project_id=my_transfer_project_id
Clientbibliotheken
Die folgenden Beispiele zeigen, wie Sie den Storage Transfer Service programmatisch mit Go, Java, Node.js und Python verwenden.
Wenn Sie Übertragungsjobs programmatisch konfigurieren oder bearbeiten, muss die Zeit in UTC angegeben werden. Weitere Informationen zum Angeben des Zeitplans eines Übertragungsjobs finden Sie unter Zeitplan.
Weitere Informationen zu den Storage Transfer Service-Clientbibliotheken finden Sie unter Erste Schritte mit Storage Transfer Service-Clientbibliotheken.
So verschieben Sie Dateien aus einem POSIX-Dateisystem in einen Cloud Storage-Bucket: