Strumento gsutil

gsutil è un'applicazione Python che ti consente di accedere a Cloud Storage dalla riga di comando. Puoi utilizzare gsutil per eseguire un'ampia gamma di attività di gestione di bucket e oggetti, tra cui:

  • Creazione ed eliminazione di bucket.
  • Caricamento, download ed eliminazione di oggetti.
  • Elenco di bucket e oggetti.
  • Spostamento, copia e ridenominazione di oggetti.
  • Modifica delle ACL di oggetti e bucket.

gsutil esegue tutte le operazioni, inclusi caricamenti e download, utilizzando HTTPS e TLS (Transport Layer Security).

Devi utilizzare gsutil?

In genere, devi utilizzare i gcloud storage comandi anziché i gsutil comandi:

  • Lo strumento gsutil è una CLI di Cloud Storage legacy e la manutenzione è minima.

  • Lo strumento gsutil non supporta l'utilizzo delle funzionalità più recenti di Cloud Storage, come l'eliminazione temporanea e le cartelle gestite.

  • I comandi gcloud storage richiedono meno ottimizzazioni manuali per ottenere le velocità di caricamento e download più elevate.

Eseguire la migrazione a gcloud CLI

Se utilizzi gsutil e vuoi eseguire la migrazione a gcloud CLI, devi prima verificare se stai utilizzando una versione autonoma di gsutil eseguendo il seguente comando:

gsutil version -l

  • Se il risultato del comando include using cloud sdk: False, significa che stai utilizzando una versione autonoma di gsutil. Per eseguire la migrazione a gcloud CLI, inizia installando gcloud CLI.

  • Se il risultato del comando include using cloud sdk: True, significa che hai già installato gcloud CLI.

Una volta installato gcloud CLI, puoi utilizzare i comandi gcloud storage esattamente come utilizzi i comandi gsutil. Le seguenti risorse possono aiutarti a iniziare:

Sintassi per l'accesso alle risorse

gsutil utilizza il prefisso gs:// per indicare una risorsa in Cloud Storage:

gs://BUCKET_NAME/OBJECT_NAME

Oltre a specificare le risorse esatte, gsutil supporta l'utilizzo di caratteri jolly nei comandi.

Accedere a un elenco di file

Per le operazioni che coinvolgono un numero elevato di file, puoi passare un elenco di file di origine a gsutil utilizzando il flag -I. In questo modo, gsutil legge l'elenco dei file o degli URL degli oggetti da stdin anziché dagli argomenti della riga di comando.

L'input deve essere un elenco di percorsi di file locali o URL di oggetti Cloud Storage, con un percorso per riga. Ad esempio, puoi creare un file denominato example_file_list.txt che contiene i seguenti percorsi:

gs://example-source-bucket/data-01.csv
gs://example-source-bucket/images/logo.png
/local/logs/error_log_20251226.txt

I seguenti comandi di esempio leggono i percorsi dei file da example_file_list.txt e li copiano in un bucket di destinazione denominato gs://example-destination-bucket:

cat example_file_list.txt | gsutil -m cp -I gs://example-destination-bucket/

Puoi anche generare l'elenco dei percorsi in tempo reale e inviarlo direttamente a gsutil. Ad esempio, i seguenti comandi caricano tutti i file JPG trovati nella directory corrente e li copiano in gs://example-destination-bucket:

find . -name "*.jpg" | gsutil -m cp -I gs://example-destination-bucket

Guida integrata

gsutil contiene una guida integrata completa su ogni comando, nonché su una serie di argomenti che puoi elencare e leggere con il comando gsutil help.

Per ottenere informazioni su un comando o un argomento specifico, utilizza gsutil help seguito dal nome del comando o dell'argomento previsto. Ad esempio, gsutil help cp e gsutil help options sono rispettivamente una pagina di guida dei comandi e una pagina di guida degli argomenti.

Per ottenere informazioni sull'installazione di gsutil, utilizza il comando gsutil version:

gsutil version -l

Statistiche sull'utilizzo

Durante la procedura di installazione, puoi attivare il monitoraggio delle statistiche sull'utilizzo, che contribuisce a migliorare lo strumento gsutil. Se in un secondo momento decidi di disattivare queste statistiche sull'utilizzo, consulta Statistiche sull'utilizzo.

Informazioni su gsutil

gsutil è un progetto open source. Per scaricare la versione per sviluppatori di gsutil o per contribuire allo sviluppo di gsutil, visita il progetto gsutil su GitHub.

Limitazioni

  • Quando utilizzi gsutil con Windows, i comandi che utilizzano il flag globale -m non possono essere annullati utilizzando Ctrl-C.

Passaggi successivi