Installa gsutil

Questa pagina descrive l'installazione e la configurazione di gsutil, uno strumento che consente di accedere a Cloud Storage dalla riga di comando utilizzando HTTPS.

Importante: nella maggior parte dei casi, gli utenti che vogliono utilizzare un'interfaccia a riga di comando Cloud Storage non deve utilizzare lo strumento gsutil. Dovresti invece lavorare con Google Cloud CLI e utilizzare i comandi gcloud storage.

La semplice installazione di gsutil offre accesso immediato in lettura e/o scrittura al e i dati pubblici. L'autenticazione nel servizio Cloud Storage ti offre e/o l'accesso in scrittura ai dati protetti che sono stati condivisi con te. L'attivazione della fatturazione ti consente di creare e gestire i tuoi bucket.

Requisiti di sistema

• Lo strumento gsutil viene eseguito su Linux/Unix, Mac OS e Windows (XP o versioni successive).

• Le versioni di gsutil 5.0 e successive richiedono Python 3.

• Se prevedi di utilizzare oggetti composti, devi installare crcmod. Su Windows, questa funzionalità è disponibile solo per Python a 32 bit. Per ulteriori informazioni informazioni su crcmod, installa gsutil e consulta l'argomento della guida utilizzando comando gsutil help crc32c.

Avviso: su alcune distribuzioni Linux, c'è un altro strumento denominato gsutil, GrandStream BudgeTone è preinstallato. Se esegui questo comando anziché gsutil per Cloud Storage, verrà probabilmente stampato un messaggio di errore simile a "Choose one of -b, -d, -e, or -r to do something". In questo caso, puoi puoi spostare la versione gsutil di Cloud Storage in primo piano PATH oppure puoi specificare il percorso completo durante l'esecuzione gsutil per Cloud Storage (ad esempio, /home/users/joan/gsutil/gsutil ls).

Installazione di gsutil

Nota: se hai già installato Google Cloud CLI, gsutil è già incluso. Inoltre, la CLI Google Cloud, incluso gsutil, è installata per impostazione predefinita su una serie di immagini Google Compute Engine. Per un elenco completo, consulta Dettagli OS.

Il metodo di installazione e aggiornamento ufficialmente supportato per gsutil fa parte dell'interfaccia a riga di comando Google Cloud.

Installazione di gsutil come parte di Google Cloud CLI

Segui le istruzioni relative al tuo sistema operativo per installare gsutil come parte di Google Cloud CLI:

Linux

1. Verifica di avere una versione di Python supportata. Google Cloud CLI richiede Python dalla versione 3.8 alla versione 3.12. Nota che il pacchetto Linux x86_64 include un interprete Python in bundle che sarà preferito per impostazione predefinita. Per informazioni su come scegliere e configurare l'interprete Python, consulta gcloud topic startup.
2. Scarica uno dei seguenti file:
   Nota: per determinare la tua versione di Linux, esegui getconf LONG_BIT dalla riga di comando.

   Piattaforma	Nome pacchetto	Dimensioni	Checksum SHA256
   Linux a 64 bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	130,8 MB	3df5d64fe6b428e90087964e767aea876363f95485bc9bf81e5aae9ac0fc8d1e
   Linux a 64 bit (Arm)	google-cloud-cli-linux-arm.tar.gz	53,3 MB	96b183e15a986da36a61a9af3ff0b8d30e423acb1b3f6ab526ad380bff2f6ac2
   Linux a 32 bit (x86)	google-cloud-cli-linux-x86.tar.gz	53,3 MB	564fa97a387b548dde9634f5c71a1c4815b27ca317a2d181f44b8c2c9cd33dd2

   Per scaricare il file dell'archivio Linux, esegui il seguente comando:

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-linux-x86_64.tar.gz

   Fai riferimento alla tabella sopra e sostituisci google-cloud-cli-linux-x86_64.tar.gz con il nome del pacchetto *.tar.gz applicabile alla tua configurazione.

3. Per estrarre i contenuti del file nel file system (preferibilmente nella home directory), esegui questo comando:

   tar -xf google-cloud-cli-linux-x86_64.tar.gz

   (Facoltativo) Per sostituire un'installazione esistente, rimuovi quella esistente google-cloud-sdk ed estrai l'archivio nella directory nella stessa località.
4. Aggiungi gcloud CLI al tuo percorso. Esegui lo script di installazione dalla radice della cartella in cui hai eseguito l'estrazione utilizzando il seguente comando:

   ./google-cloud-sdk/install.sh

   Ciò può essere fatto anche in modo non interattivo (ad esempio, utilizzando uno script) e indicando le preferenze come flag. Per visualizzare i flag disponibili, esegui:

   ./google-cloud-sdk/install.sh --help

   (Facoltativo)
   • Per inviare statistiche sull'utilizzo anonimizzate. per contribuire a migliorare gcloud CLI, rispondi Y quando richiesto.
   • Per aggiungere gcloud CLI a PATH e abilitare completamento comando, rispondi Y quando richiesto.
5. Apri un nuovo terminale per applicare le modifiche.
6. Per inizializzare gcloud CLI, esegui gcloud init:

./google-cloud-sdk/bin/gcloud init

7. (Facoltativo) Installa i componenti aggiuntivi utilizzando Gestione componenti.

Debian/Ubuntu

Nota:a seconda della configurazione, puoi scegliere altri metodi di installazione:

• Se vuoi che gcloud si aggiorni automaticamente alla versione più recente e con una release moderna di Ubuntu che utilizza Snap Package Manager, puoi installare Google Cloud CLI come pacchetto snapshot.
• Se utilizzi un'istanza su Compute Engine, la gcloud CLI installato per impostazione predefinita su alcune immagini di sistema operativo. Per un elenco completo, consulta Dettagli del sistema operativo.

Contenuti del pacchetto

gcloud CLI è disponibile in formato di pacchetto per l'installazione su sistemi Debian e Ubuntu. Questo pacchetto contiene gcloud, gcloud alpha, Solo i comandi gcloud beta, gsutil e bq. Non includi kubectl o le estensioni di App Engine necessarie per eseguire il deployment di un'applicazione utilizzando Comandi gcloud. Per utilizzare questi componenti, è necessario installali separatamente.

Prima di iniziare

Prima di installare gcloud CLI, assicurati che il tuo sistema operativo soddisfi i seguenti requisiti:

• Si tratta di una release Ubuntu che non è ancora disponibile end-of-life o una release stabile Debian che non abbia raggiunto la fine del ciclo di vita
• Di recente ha aggiornato i propri pacchetti:

  sudo apt-get update

• Ha apt-transport-https e curl hanno installato:

  sudo apt-get install apt-transport-https ca-certificates gnupg curl

Installazione

1. Importa la chiave pubblica di Google Cloud.

   • Per le distribuzioni più recenti (Debian 9 e versioni successive o Ubuntu 18.04 o versioni successive), esegui la seguente comando:

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg

   • Per le distribuzioni precedenti, esegui questo comando:

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key --keyring /usr/share/keyrings/cloud.google.gpg add -

   • Se il comando apt-key della tua distribuzione non supporta l'argomento --keyring, esegui il seguente comando:

     curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo apt-key add -

   • Se non riesci a ricevere gli ultimi aggiornamenti a causa di una chiave scaduta: ottieni le ultime novità apt-get.gpg.

2. Aggiungi l'URI di distribuzione della gcloud CLI come origine del pacchetto.
   • Per le distribuzioni più recenti (Debian 9 e versioni successive o Ubuntu 18.04 e versioni successive), esegui questo comando:

     echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   • Per le distribuzioni precedenti che non supportano l'opzione firmato da, esegui questo comando:

     echo "deb https://packages.cloud.google.com/apt cloud-sdk main" | sudo tee -a /etc/apt/sources.list.d/google-cloud-sdk.list

   Nota: assicurati che non siano presenti voci duplicate per il cloud-sdk repository in /etc/apt/sources.list.d/google-cloud-sdk.list.
3. Aggiorna e installa gcloud CLI:

   sudo apt-get update && sudo apt-get install google-cloud-cli

   Per altre opzioni di apt-get, ad esempio la disattivazione dei prompt o delle prove, consulta le pagine di manuali di apt-get.

   Suggerimento Docker: se installi gcloud CLI all'interno di un'immagine Docker, utilizza un'interfaccia a riga di comando singolo passaggio RUN:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | sudo gpg --dearmor -o /usr/share/keyrings/cloud.google.gpg && apt-get update -y && apt-get install google-cloud-cli -y
       

   Per le immagini di base precedenti che non supportano il comando gpg --dearmor:

   RUN echo "deb [signed-by=/usr/share/keyrings/cloud.google.gpg] https://packages.cloud.google.com/apt cloud-sdk main" | tee -a /etc/apt/sources.list.d/google-cloud-sdk.list && curl https://packages.cloud.google.com/apt/doc/apt-key.gpg | apt-key --keyring /usr/share/keyrings/cloud.google.gpg  add - && apt-get update -y && apt-get install google-cloud-cli -y
         

4. (Facoltativo) Installa uno dei seguenti componenti aggiuntivi:
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   Ad esempio, il componente google-cloud-cli-app-engine-java può essere installato come che segue:

   sudo apt-get install google-cloud-cli-app-engine-java

5. Esegui gcloud init per iniziare:

   gcloud init

Eseguire il downgrade delle versioni di gcloud CLI

Per tornare a una versione specifica di gcloud CLI, dove VERSION è il dal modulo 123.0.0, esegui questo comando:

sudo apt-get update && sudo apt-get install google-cloud-cli=123.0.0-0

Le dieci release più recenti sono sempre disponibili nel repository.

NOTA: per le release precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

Cappello rosso/Fedora/CentOS

Nota: se utilizzi un'istanza su Compute Engine, Google Cloud CLI installato per impostazione predefinita su alcune immagini di sistema operativo. Consulta Dettagli del sistema operativo per un elenco completo.

Contenuti del pacchetto

gcloud CLI è disponibile in formato di pacchetto per l'installazione su Red Hat Enterprise Linux 7, 8 e 9; Fedora 33 e 34; e CentOS 7 e 8. Questo pacchetto contiene solo i comandi gcloud, gcloud alpha, gcloud beta, gsutil e bq. Non include kubectl o App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud, che possono essere separatamente, come descritto più avanti in questa sezione.

Installazione

1. Aggiorna DNF con le informazioni del repository gcloud CLI. Il seguente comando di esempio è per un modello compatibile con Red Hat Enterprise Linux 9 installazione, ma assicurati di aggiornare le impostazioni in base alle tue esigenze configurazione:

   sudo tee -a /etc/yum.repos.d/google-cloud-sdk.repo << EOM
   [google-cloud-cli]
   name=Google Cloud CLI
   baseurl=https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-x86_64
   enabled=1
   gpgcheck=1
   repo_gpgcheck=0
   gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key.gpg
   EOM

2. Se stai eseguendo l'installazione su Fedora 34 o 35, installa libxcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. Installa l'interfaccia a riga di comando gcloud:

   sudo dnf install google-cloud-cli

Nota: se non hai effettuato la migrazione a dnf sul tuo sistema, puoi eseguire questi comandi utilizzando yum.

Puoi anche utilizzare le opzioni dnf/yum, come la disattivazione dei prompt o delle prove, con i comandi forniti.

4. (Facoltativo) Installa una delle seguenti app componenti aggiuntivi:
   • google-cloud-cli
   • google-cloud-cli-anthos-auth
   • google-cloud-cli-app-engine-go
   • google-cloud-cli-app-engine-grpc
   • google-cloud-cli-app-engine-java
   • google-cloud-cli-app-engine-python
   • google-cloud-cli-app-engine-python-extras
   • google-cloud-cli-bigtable-emulator
   • google-cloud-cli-cbt
   • google-cloud-cli-cloud-build-local
   • google-cloud-cli-cloud-run-proxy
   • google-cloud-cli-config-connector
   • google-cloud-cli-datastore-emulator
   • google-cloud-cli-firestore-emulator
   • google-cloud-cli-gke-gcloud-auth-plugin
   • google-cloud-cli-kpt
   • google-cloud-cli-kubectl-oidc
   • google-cloud-cli-local-extract
   • google-cloud-cli-minikube
   • google-cloud-cli-nomos
   • google-cloud-cli-pubsub-emulator
   • google-cloud-cli-skaffold
   • google-cloud-cli-spanner-emulator
   • google-cloud-cli-terraform-validator
   • google-cloud-cli-tests
   • kubectl

   Ad esempio, il componente google-cloud-cli-app-engine-java può essere installato come che segue:

   sudo dnf install google-cloud-cli-app-engine-java

5. Esegui gcloud init per iniziare:

   gcloud init

Eseguire il downgrade delle versioni di gcloud CLI

Se vuoi ripristinare una versione specifica dell'interfaccia a riga di comando gcloud, dove VERSION è del tipo 123.0.0, esegui: sudo dnf downgrade google-cloud-cli-VERSION Le dieci release più recenti saranno sempre disponibili nel repository. NOTA: per le release precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

macOS

1. Verifica di avere una versione di Python supportata:
   • Per controllare la tua versione Python attuale, esegui python3 -V o python -V. Le versioni supportate sono Python dalla 3.8 alla 3.12.
   • Lo script di installazione principale offre l'installazione di Python 3.11 di CPython.
   • Altrimenti, per installare una versione Python supportata, visita il sito Python.org Release Python per macOS.
   • Se sulla tua macchina sono installati più interpreti Python, imposta CLOUDSDK_PYTHON all'variabile di ambiente della shell per puntare al percorso dell'interprete preferito.
   • Per ulteriori informazioni su come scegliere e configurare il tuo interprete Python, vedi gcloud topic startup
2. Scarica uno dei seguenti file:
   Nota: per determinare il nome hardware della tua macchina, esegui uname -m da una riga di comando.

Piattaforma	Pacchetto	Dimensioni	Checksum SHA256
macOS a 64 bit (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	53,4 MB	3c305a258cd2a1a3d2985c434e327fa965ce02be1fc713adacc58ad79d6a7cae
macOS a 64 bit (ARM64, Apple M1 silicon)	google-cloud-cli-darwin-arm.tar.gz	53,3 MB	2ebb4776571771147d9729c05af6172d757874d781f559878dfc5c20ed0fdef4
macOS a 32 bit (x86)	google-cloud-cli-darwin-x86.tar.gz	52 MB	9efded7a419793882fb51342e11f680bb754f3db68b72e29989dfe7dba1eb4ed

1. Estrai l'archivio in qualsiasi posizione sul tuo file system (preferibilmente nella tua home directory). Attivato macOS, puoi farlo aprendo lo strumento .tar.gz file di archivio nella posizione che preferisci.

   Per sostituire un'installazione esistente, rimuovi quella esistente google-cloud-sdk ed estrai l'archivio nella stessa posizione.

2. (Facoltativo) Utilizza lo script di installazione per aggiungere gli strumenti della gcloud CLI al tuo PATH.Puoi anche attivare il completamento dei comandi per la tua shell, raccolta delle statistiche sull'utilizzo e installa Python 3.11.

   Esegui lo script (dalla radice della cartella estratta nell'ultimo passaggio) utilizzando questo :

   ./google-cloud-sdk/install.sh

   Questa operazione può essere eseguita anche in modo non interattivo, ad esempio utilizzando uno script, indicando le preferenze come flag. Per descrivere i flag disponibili, esegui:

   ./google-cloud-sdk/install.sh --help

   Per eseguire lo script di installazione con la modalità screen reader su:

   ./google-cloud-sdk/install.sh --screen-reader=true

   Apri un nuovo terminale per applicare le modifiche.
3. Per inizializzare gcloud CLI, esegui gcloud init:

./google-cloud-sdk/bin/gcloud init

4. Facoltativo. Installa componenti aggiuntivi utilizzando il gestore dei componenti.

Windows

Google Cloud CLI funziona su Windows 8.1 e versioni successive e Windows Server 2012 e versioni successive.

1. Scarica il programma di installazione di Google Cloud CLI.

   In alternativa, apri un terminale PowerShell ed esegui i seguenti comandi PowerShell:

   (New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/", "$env:Temp\GoogleCloudSDKInstaller.exe")
   
   & $env:Temp\GoogleCloudSDKInstaller.exe
       

2. Avvia il programma di installazione e segui le istruzioni nei prompt. L'installatore è firmato da Google LLC.

   Se utilizzi uno screen reader, seleziona la casella di controllo Attiva la modalità screen reader. Questa opzione configura gcloud in modo da utilizzare gli indicatori di stato anziché gli spinner Unicode, visualizzare l'avanzamento come percentuale e appiattire le tabelle. Per ulteriori informazioni, consulta Guida alle funzioni di accessibilità.

3. Google Cloud CLI richiede Python, le versioni supportate sono Python dalla 3.8 alla 3.12. Di per impostazione predefinita, la versione Windows di Google Cloud CLI viene fornita in bundle con Python 3. Per utilizzare Google Cloud CLI sul tuo sistema operativo deve essere in grado di eseguire una versione supportata di Python.

   Il programma di installazione installa tutte le dipendenze necessarie, inclusa la versione Python necessaria. Anche se Google Cloud CLI installa e gestisce Python 3 per impostazione predefinita, puoi utilizzare una libreria Installazione di Python se necessaria, deselezionando l'opzione Installa Python in bundle. Consulta le gcloud topic startup per imparerai a utilizzare un'installazione Python esistente.

4. Al termine dell'installazione, il programma di installazione ti dà la possibilità di creare un menu Start e sul desktop, avvia la shell di Google Cloud CLI e con gcloud CLI. Assicurati di lasciare le opzioni per avviare la shell e configurare installazione selezionata. Il programma di installazione avvia una finestra del terminale ed esegue il comando gcloud init.

5. L'installazione predefinita non include le estensioni App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud. Questi componenti possono essere installati utilizzando Gestore dei componenti dell'interfaccia a riga di comando gcloud.

Suggerimenti per la risoluzione dei problemi:

• Se l'installazione non va a buon fine a causa del mancato riconoscimento del comando find, assicurati che la variabile di ambiente PATH sia impostata in modo da includere la cartella contenente find. In genere, si tratta di C:\WINDOWS\system32;.
• Se hai disinstallato gcloud CLI, devi riavviare il tuo prima di installare nuovamente gcloud CLI.
• Se la decompressione non riesce, esegui il programma di installazione come amministratore.

Esegui gli aggiornamenti con il comando components update: gcloud components update.

Configurazione delle credenziali per accedere ai dati protetti

Per accedere ai dati protetti o scrivere in un bucket protetto, devi configurare le credenziali (eseguire l'autenticazione). Ad esempio, se un'altra persona ha creato un l'account Cloud Storage e i dati caricati a cui solo tu puoi accedere o altre persone specifiche, devi impostare le tue credenziali per per poter accedere a questi dati.

Quando utilizzi gsutil nell'ambito dell'interfaccia a riga di comando Google Cloud, OAuth2 viene utilizzato per autenticare e autorizzare l'accesso alle risorse Cloud Storage. Per stabilire l'accesso, esegui il comando gcloud init e segui le istruzioni fornite nella riga di comando, che includono l'accesso al tuo account utente. Tieni presente che probabilmente hai già eseguito questa configurazione se hai seguito i passaggi di installazione riportati sopra. Se hai eseguito gcloud init in precedenza, quando esegui nuovamente il comando, ti viene chiesto se desideri reinizializzare configurazione o crearne una nuova. Per ulteriori informazioni, vedi Inizializza Google Cloud CLI.

Questo è tutto. Ora puoi accedere ai dati protetti. Per visualizzare un elenco di gsutil digita gsutil al prompt dei comandi.

Risoluzione dei problemi

Se provi ad autenticare gsutil utilizzando il comando gcloud init, ma continui a di accesso ai bucket o agli oggetti previsti, il sistema potrebbe avere la versione standalone precedente di gsutil e il bundle Google Cloud CLI di gsutil installata. Esegui il comando gsutil version -l e controlla il valore di using cloud sdk. Se False, il tuo sistema utilizza versione autonoma di gsutil quando esegui i comandi. Ti consigliamo di rimuovere la versione autonoma di gsutil dal sistema; ma puoi in alternativa, puoi eseguire l'autenticazione usando gsutil config -a o gsutil config -e.

Autenticazione con HMAC

Anche se OAuth 2.0 è il metodo consigliato per autenticare gsutil, puoi anche utilizza le chiavi HMAC per le credenziali. Per eseguire l'autenticazione con HMAC, utilizza questo comando:

gsutil config -a

Questo comando ti guiderà attraverso un processo di autenticazione in cui Vengono richiesti l'ID di accesso e il segreto associati alla chiave HMAC.

Durante l'autenticazione con chiavi HMAC, devi disabilitare il trasferimento delle credenziali Google Cloud CLI utilizzando il comando: gcloud config set pass_credentials_to_gsutil false.

Abilita mTLS

Puoi anche attivare il protocollo TLS reciproca (mTLS). Quando mTLS è abilitato sul tuo dispositivo, il dispositivo tenta di connettersi storage.mtls.googleapis.com. Prima che la connessione sia consentita, Cloud Storage verifica il certificato sul tuo dispositivo.

Nota: questa funzionalità funziona solo quando gsutil invia richieste tramite il API JSON di Cloud Storage.

Il modo più semplice per ottenere un certificato è tramite Google Cloud CLI. Puoi impostarne uno manualmente nel file .boto impostando i seguenti valori in "Credentials":

1. use_client_certificate: un flag che controlla se per non utilizzare mTLS.
2. cert_provider_command: un comando shell che stampa un allo stdout per la lettura di gsutil.

Provalo

Se non conosci Google Cloud, crea un account per valutare le prestazioni di Cloud Storage in scenari reali. I nuovi clienti ricevono anche 300 $ di crediti gratuiti per l'esecuzione, il test e il deployment dei carichi di lavoro.

Prova Cloud Storage gratuitamente