Questa pagina mostra come caricare e scaricare oggetti nei bucket di archiviazione dell'appliance air-gapped Google Distributed Cloud (GDC).
Prima di iniziare
Uno spazio dei nomi del progetto gestisce le risorse dei bucket nel server API di gestione. Devi avere un progetto per lavorare con bucket e oggetti.
Devi anche disporre delle autorizzazioni del bucket appropriate per eseguire l'operazione seguente. Consulta Concedere l'accesso ai bucket.
Per eseguire i comandi sul server API di gestione, accedi e genera il file kubeconfig per il server API di gestione, se non ne hai uno.
Linee guida per la denominazione degli oggetti
Utilizza le seguenti linee guida per denominare gli oggetti:
- Utilizza i caratteri UTF-8 quando assegni un nome agli oggetti.
- Evita di includere informazioni che consentono l'identificazione personale (PII).
Caricare oggetti nei bucket di archiviazione
Per caricare un oggetto, esegui i seguenti comandi:
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
Il comando seguente carica tutti i file di testo dalla directory locale in un bucket:
gdcloud storage cp *.txt s3://BUCKET
Il comando seguente carica più file dalla directory locale in un bucket:
gdcloud storage cp abc1.txt abc2.txt s3://BUCKET
Per caricare una cartella in un bucket, utilizza l'opzione --recursive per copiare un intero albero di directory. Il comando seguente carica l'albero di directory dir:
gdcloud storage cp dir s3://BUCKET --recursive
Esegui caricamenti multiparte per oggetti di grandi dimensioni o utilizza automaticamente i caricamenti multiparte quando hai un file da caricare di dimensioni superiori a 15 MB. In questo caso, il file viene suddiviso in più parti, ciascuna di 15 MB. L'ultima parte è più piccola. Ogni parte viene caricata separatamente e ricostruita nella destinazione al termine del trasferimento.
Se il caricamento di una parte non riesce, puoi riavviarlo senza influire sulle altre parti già caricate.
Esistono due opzioni relative ai caricamenti multiparte:
--disable-multipart: disabilita i caricamenti multiparte per tutti i file.--multipart-chunk-size-mb=SIZE: imposta le dimensioni di ogni blocco di un caricamento multiparte.
I file di dimensioni superiori a SIZE vengono caricati automaticamente come multiparte multithread. I file più piccoli vengono caricati utilizzando il metodo tradizionale. SIZE è in megabyte. La dimensione predefinita del blocco è 15 MB. La dimensione minima consentita del blocco è 5 MB e la massima è 5 GB.
Scaricare oggetti dai bucket di archiviazione
Per ottenere oggetti dal bucket:
gdcloud storage cp s3://BUCKET/OBJECT LOCAL_FILE_TO_SAVE
Per scaricare tutti i file di testo da un bucket nella directory corrente:
gdcloud storage cp s3://BUCKET/*.txt .
Per scaricare il file di testo abc.txt da un bucket nella directory corrente:
gdcloud storage cp s3://BUCKET/abc.txt .
Per scaricare una versione precedente del file, elenca prima tutte le versioni del file:
gdcloud storage ls s3://BUCKET/abc.txt --all-versions
Output di esempio:
s3://my-bucket/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND
s3://my-bucket/abc.txt#ODgzNEYzQ0MtMzEzRS0xMUVFLTk2NEItMjI1MTAwQkJENjND
s3://my-bucket/abc.txt#ODNCNDEzNzgtMzEzRS0xMUVFLTlDOUMtQzRDOTAwQjg3RTg3
Quindi, scarica una versione specifica del file di testo abc.txt dal bucket nella directory corrente:
gdcloud storage cp s3://BUCKET/abc.txt#OEQxNTk4MUEtMzEzRS0xMUVFLTk2N0UtQkM4MjAwQkJENjND .