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 degli ACL di oggetti e bucket.

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

Dovresti utilizzare gsutil?

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

  • Lo strumento gsutil è un'interfaccia a riga di comando Cloud Storage precedente e viene gestito minimamente.

  • Lo strumento gsutil non supporta il lavoro con le funzionalità più recenti di Cloud Storage, come l'eliminazione soft e le cartelle gestite.

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

Eseguire la migrazione gcloud CLI

Se sei un utente di gsutil che vuole 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 alla gcloud CLI, inizia installando la gcloud CLI.

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

Una volta installata gcloud CLI, puoi utilizzare i comandi gcloud storage come faresti con i comandi gsutil. Le seguenti risorse possono aiutarti a iniziare:

Sintassi per accedere alle risorse

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

gs://BUCKET_NAME/OBJECT_NAME

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

Guida integrata

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

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

Per 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 offrirti volontario 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