Auf dieser Seite wird beschrieben, wie Sie Objekte in und aus Google Distributed Cloud (GDC) Air-Gapped Appliance-Speicher-Buckets hochladen und herunterladen.
Hinweis
Ein Projekt-Namespace verwaltet Bucket-Ressourcen auf dem Management API-Server. Sie benötigen ein Projekt, um mit Buckets und Objekten zu arbeiten.
Außerdem benötigen Sie die entsprechenden Bucket-Berechtigungen, um den folgenden Vorgang auszuführen. Weitere Informationen finden Sie unter Bucket-Zugriff gewähren.
Wenn Sie Befehle für den Management API-Server ausführen möchten, melden Sie sich an und generieren Sie die kubeconfig-Datei für den Management API-Server, falls Sie noch keine haben.
Benennungsrichtlinien für Objekte
Beachten Sie die folgenden Richtlinien zum Benennen von Objekten:
- Verwenden Sie beim Benennen von Objekten UTF-8-Zeichen.
- Geben Sie keine personenbezogenen Daten (personenidentifizierbare Informationen) an.
Objekte in Speicher-Buckets hochladen
Führen Sie die folgenden Befehle aus, um ein Objekt hochzuladen:
gdcloud storage cp LOCAL_PATH s3://REMOTE_PATH
gdcloud storage cp s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
gdcloud storage mv s3://REMOTE_SOURCE_PATH s3://REMOTE_MOVE_DESTINATION_PATH
Mit dem folgenden Befehl werden alle Textdateien aus dem lokalen Verzeichnis in einen Bucket hochgeladen:
gdcloud storage cp *.txt s3://BUCKET
Mit dem folgenden Befehl werden mehrere Dateien aus dem lokalen Verzeichnis in einen Bucket hochgeladen:
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
Wenn Sie einen Ordner in einen Bucket hochladen möchten, verwenden Sie die Option `--recursive`, um einen gesamten Verzeichnisbaum zu kopieren. Mit dem folgenden Befehl wird der Verzeichnisbaum „dir“ hochgeladen:
gdcloud storage cp dir s3://BUCKET --recursive
Führen Sie mehrteilige Uploads für große Objekte aus oder verwenden Sie mehrteilige Uploads automatisch, wenn Sie eine Datei hochladen möchten, die größer als 15 MB ist. In diesem Fall wird die Datei in mehrere Teile aufgeteilt, wobei jeder Teil 15 MB groß ist. Der letzte Teil ist kleiner. Jeder Teil wird separat hochgeladen und am Ziel wieder zusammengesetzt, wenn die Übertragung abgeschlossen ist.
Wenn ein Teil nicht hochgeladen werden kann, können Sie den Upload neu starten, ohne dass sich dies auf die bereits hochgeladenen Teile auswirkt.
Es gibt zwei Optionen für mehrteilige Uploads:
--disable-multipart: Deaktiviert mehrteilige Uploads für alle Dateien.--multipart-chunk-size-mb=SIZE: Legt die Größe von jedem Teil eines mehrteiligen Uploads fest.
Dateien, die größer als SIZE sind, werden automatisch als mehrteilige Uploads mit mehreren Threads hochgeladen. Kleinere Dateien werden mit der herkömmlichen Methode hochgeladen. SIZE wird in Megabyte angegeben. Die Standard-Chunkgröße beträgt 15 MB. Die zulässige Mindest-Chunkgröße beträgt 5 MB und die maximale Größe 5 GB.
Objekte aus Speicher-Buckets herunterladen
So rufen Sie Objekte aus dem Bucket ab:
gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE
So laden Sie alle Textdateien aus einem Bucket in Ihr aktuelles Verzeichnis herunter:
gdcloud storage cp s3://BUCKET/*.txt .
So laden Sie die Textdatei abc.txt aus einem Bucket in Ihr aktuelles Verzeichnis herunter:
gdcloud storage cp s3://BUCKET/abc.txt .
Wenn Sie eine ältere Version der Datei herunterladen möchten, listen Sie zuerst alle Versionen der Datei auf:
gdcloud storage ls s3://BUCKET/abc.txt --all-versions
Beispielausgabe:
s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3
Laden Sie dann eine bestimmte Version der Textdatei abc.txt aus dem Bucket in Ihr aktuelles Verzeichnis herunter:
gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .