Installa gsutil

Importante: gsutil non è la CLI consigliata per Cloud Storage. Utilizza invece i comandi gcloud storage in Google Cloud CLI.

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.

Basta installare gsutil per avere accesso immediato in lettura e/o scrittura ai dati pubblici. L'autenticazione al servizio Cloud Storage ti consente di accedere in lettura e/o 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 funziona su Linux/Unix, Mac OS e Windows (XP o versioni successive).

• Le versioni di gsutil 5.32 e successive richiedono Python 3.8-3.12, che puoi ottenere utilizzando il gestore delle versioni di Python o installando una versione appropriata.

Le istruzioni riportate di seguito mostrano come gestire le versioni di Python:

Linux

Prerequisiti: installa un gestore delle versioni di Python (pyenv) e installa una versione di Python adatta.

1. Imposta la versione Python globale:
   • Per impostare Python 3.12.x come versione globale:

     pyenv global 3.12.x

   • In alternativa, imposta la versione di Python localmente per una cartella del progetto specifica:

     pyenv local 3.12.x

2. Verifica che sia in uso la versione Python corretta:

   python --version

   Dovresti vedere:

   Python 3.12.x

macOS

Metodo 1: utilizzo di Homebrew (brew)

Prerequisiti: installa Homebrew e installa una versione di Python adatta tramite homebrew.

1. Imposta una versione Python specifica come predefinita:
   • Aggiungi la versione che preferisci al $PATH. Ad esempio, per utilizzare Python 3.12:

     export PATH="/usr/local/opt/python@3.12/bin:$PATH"

   • Per rendere permanente questa modifica, aggiungi il percorso del file di configurazione della shell (~/.bash_profile, ~/.zshrc o ~/.bashrc).
2. Verifica che sia in uso la versione Python corretta:

   python --version

   Dovresti vedere:

   Python 3.12.x

Metodo 2: utilizzo di pyenv

Prerequisiti: installa il gestore delle versioni di Python (pyenv) e installa una versione di Python adatta tramite pyenv.

1. Imposta la versione Python globale:
   • Per impostare la versione di Python a livello globale (per tutti i terminali):

     pyenv global 3.12.x

   • In alternativa, imposta la versione di Python localmente per una cartella del progetto specifica:

     pyenv local 3.12.x

2. Verifica che sia in uso la versione Python corretta:

   python --version

   Dovresti vedere:

   Python 3.12.x

Windows

Prerequisiti: installa il gestore delle versioni di Python (pyenv-win) e installa una versione di Python adatta tramite pyenv.

1. Imposta la versione Python globale:
   • Per impostare Python 3.12.x come versione globale:

     pyenv global 3.12.x

   • In alternativa, imposta la versione di Python localmente per una cartella del progetto specifica:

     pyenv local 3.12.x

2. Verifica che sia in uso la versione Python corretta:

   python --version

   Dovresti vedere:

   Python 3.12.x

• Se prevedi di utilizzare gli oggetti compositi, devi installare il modulo CRC compilato. Su Windows, questa opzione è disponibile solo per Python a 32 bit. Per ulteriori informazioni su crcmod, installa gsutil e consulta l'argomento della guida utilizzando il comando gsutil help crc32c.

Avviso: su alcune distribuzioni Linux è preinstallato un altro strumento denominato gsutil di GrandStream BudgeTone. Se esegui questo comando anziché gsutil di Cloud Storage, è probabile che venga visualizzato un messaggio di errore simile a"Choose one of -b, -d, -e, or -r to do something". In questo caso, puoi spostare la versione di gsutil di Cloud Storage all'inizio della variabile di ambiente PATH oppure specificare il percorso completo quando esegui gsutil di 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, Google Cloud CLI, 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 dellGoogle Cloud CLI.

Installazione di gsutil nell'ambito di Google Cloud CLI

Segui le istruzioni per il tuo sistema operativo per installare gsutil come parte dellGoogle Cloud CLI:

Linux

1. Verifica di avere una versione di Python supportata. Google Cloud CLI richiede Python 3.8-3.13. Tieni presente 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 una delle seguenti opzioni:
   Nota: per determinare la tua piattaforma Linux, esegui uname -a nella riga di comando.

   Piattaforma	Nome pacchetto	Dimensioni	Checksum SHA256
   Linux a 64 bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	132,3 MB	c5e14c769aff2e0af939b886e5f025597ba162af5e21c8c0073a9008f477b3d5
   Linux a 64 bit (Arm)	google-cloud-cli-linux-arm.tar.gz	54,5 MB	611130fd6e5dc36c5f16e3453bc527f7e4c54d5695c0016a1e51af8659bd3858
   Linux a 32 bit (x86)	google-cloud-cli-linux-x86.tar.gz	54,5 MB	bdfeeae12e62fcb4ca50da424ed9853f85ebc7accdfb0ac8084c92d3a4c8c82c

   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 il seguente comando:

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

   (Facoltativo) Per sostituire un'installazione esistente, rimuovi la directory google-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.
4. Aggiungi l'interfaccia a riga di comando gcloud al 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

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

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

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

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

7. (Facoltativo) Installa componenti aggiuntivi utilizzando il gestore dei componenti.

Debian/Ubuntu

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

• Se vuoi che gcloud venga aggiornato automaticamente all'ultima versione e utilizzi una release Ubuntu moderna che utilizza il gestore pacchetti Snap, puoi installare Google Cloud CLI come pacchetto snap.
• Se utilizzi un'istanza su Compute Engine, l'gcloud CLI è installata per impostazione predefinita su una serie di immagini del sistema operativo. Per un elenco completo, consulta Dettagli del sistema operativo.

Contenuti del pacchetto

Gcloud CLI è disponibile in formato pacchetto per l'installazione su sistemi Debian e Ubuntu. Questo pacchetto contiene solo i comandi gcloud, gcloud alpha, gcloud beta, gsutil e bq. Non include kubectl o le estensioni App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud. Se vuoi questi componenti, devi installarli separatamente.

Prima di iniziare

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

• Si tratta di una release di Ubuntu che non ha raggiunto la fine del ciclo di vita o di una release stabile di Debian che non ha raggiunto la fine del ciclo di vita
• Di recente ha aggiornato i suoi pacchetti:

  sudo apt-get update

• Sono installati apt-transport-https e curl:

  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 o versioni successive o Ubuntu 18.04 o versioni successive), esegui il 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 il seguente 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 aggiornamenti più recenti a causa di una chiave scaduta, ottieni il file della chiave apt-get.gpg più recente.

2. Aggiungi l'URI della distribuzione dell'interfaccia a riga di comando gcloud come origine del pacchetto.
   • Per le distribuzioni più recenti (Debian 9 o versioni successive o Ubuntu 18.04 o versioni successive), esegui il seguente 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 signed-by, esegui il seguente 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 repo cloud-sdk 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 per Docker: se installi l'interfaccia alla gcloud CLI;interno di un'immagine Docker, utilizza invece un 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 segue:

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

5. Esegui gcloud init per iniziare:

   gcloud init

Eseguire gcloud CLI#39;interfaccia a riga di comando gcloud

Per ripristinare una versione specifica di gcloud CLI, dove VERSION è del formato 123.0.0, esegui il seguente 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

Red Hat/Fedora/CentOS

Nota: se utilizzi un'istanza su Compute Engine, Google Cloud CLI è installato per impostazione predefinita su una serie di immagini del sistema operativo. Per un elenco completo, consulta Dettagli sistema operativo.

Contenuti del pacchetto

La gcloud CLI è disponibile in formato pacchetto per l'installazione su sistemi 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 le estensioni App Engine necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud, che possono essere installati 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'installazione compatibile con Red Hat Enterprise Linux 9, ma assicurati di aggiornare le impostazioni in base alle esigenze della tua 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 esegui l'installazione su Fedora 34 o 35, installa libxcrypt-compat.x86_64.

   sudo dnf install libxcrypt-compat.x86_64

3. Installa gcloud CLI:

   sudo dnf install google-cloud-cli

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

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

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 segue:

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

5. Esegui gcloud init per iniziare:

   gcloud init

Eseguire gcloud CLI#39;interfaccia a riga di comando gcloud

Se vuoi ripristinare una versione specifica dell'interfaccia alla gcloud CLI, 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 versione di Python attualmente in uso, esegui python3 -V o python -V. Le versioni supportate sono da Python 3.8 a 3.13.
   • Lo script di installazione principale offre di installare Python 3.11 di CPython.
   • In caso contrario, per installare una versione di Python supportata, visita la pagina Uscite di Python per macOS su Python.org.
   • Se sulla tua macchina sono installati più interpreti Python, imposta la variabile di ambiente CLOUDSDK_PYTHON all'interno della shell in modo che indichi il percorso dell'interprete che preferisci.
   • Per ulteriori informazioni su come scegliere e configurare l'interprete Python, consulta gcloud topic startup.
2. Scarica una delle seguenti opzioni:
   Nota: per determinare il nome dell'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	54,6 MB	da13597081ec23f2d7973c5566f7004c2e2fff6c4339d37cb754bf854059b6b1
macOS a 64 bit (ARM64, Apple M1 silicon)	google-cloud-cli-darwin-arm.tar.gz	54,5 MB	a8432ae5b54a981c5495c9bab77add277da3c734a387167cc8112d813737429b
macOS a 32 bit (x86)	google-cloud-cli-darwin-x86.tar.gz	53,2 MB	ce1329de6a30d4736ba9c2eae5b9ef5e095d7ec61d76fd60f7e0dc8d1ec43757

1. Estrai l'archivio in qualsiasi posizione del file system (preferibilmente nella home directory). Su macOS, puoi farlo aprendo il file dell'archivio .tar.gz scaricato nella posizione che preferisci.

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

2. (Facoltativo) Utilizza lo script di installazione per aggiungere gli strumenti gcloud CLI a PATH.Puoi anche attivare il completamento dei comandi per la shell, la raccolta delle statistiche di utilizzo e installare Python 3.11.

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

   ./google-cloud-sdk/install.sh

   Questa operazione può essere eseguita anche in modo non interattivo (ad esempio utilizzando uno script) specificando le preferenze come flag. Per descrivere gli indicatori disponibili, esegui:

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

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

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

   Apri un nuovo terminale per rendere effettive le modifiche.
3. Per inizializzare la 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/GoogleCloudSDKInstaller.exe", "$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à dello 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 la guida alle funzionalità di accessibilità.

3. Google Cloud CLI richiede Python; le versioni supportate sono da Python 3.8 a 3.13. Per impostazione predefinita, la versione di Google Cloud CLI per Windows è fornita in bundle con Python 3. Per utilizzare Google Cloud CLI, il 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 di Python richiesta. Anche se Google Cloud CLI installa e gestisce Python 3 per impostazione predefinita, se necessario puoi utilizzare un'installazione di Python esistente deselezionando l'opzione Installa Python incluso. Consulta gcloud topic startup per scoprire come utilizzare un'installazione di Python esistente.

4. Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie nel menu Start e sul desktop, avviare la shell Google Cloud CLI e configurare gcloud CLI. Assicurati di lasciare selezionate le opzioni per avviare la shell e configurare l'installazione. 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 il 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 sistema prima di reinstallarlo.
• Se l'estrazione non va a buon fine, esegui il programma di installazione come amministratore.

Nell'ambito dell'installazione di gsutil, devi impostare la variabile di ambiente CLOUDSDK_PYTHON in modo da utilizzare la versione corretta di Python. Per ulteriori dettagli, consulta la pagina gcloud startup topic.

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 qualcun altro ha creato un account Cloud Storage e ha caricato dati accessibili solo a te o ad altre persone specifiche, devi configurare le tue credenziali per il servizio Cloud Storage per poter accedere a questi dati.

Quando utilizzi gsutil nell'ambito di Google Cloud CLI, 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 di nuovo il comando ti viene chiesto se vuoi inizializzare nuovamente la configurazione o crearne una nuova. Per ulteriori informazioni, consulta Inizializzare Google Cloud CLI.

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

Risoluzione dei problemi

Se provi ad autenticare gsutil utilizzando il comando gcloud init, ma non riesci ancora a accedere ai bucket o agli oggetti previsti, sul tuo sistema potrebbero essere installate sia la versione precedente autonoma di gsutil sia la versione di gsutil inclusa in Google Cloud CLI. Esegui il comando gsutil version -l e controlla il valore di using cloud sdk. Se il valore è False, il sistema utilizza la versione autonoma di gsutil quando esegui i comandi. Ti consigliamo di rimuovere la versione autonoma di gsutil dal tuo sistema. Tuttavia, in alternativa, puoi effettuare l'autenticazione utilizzando gsutil config -a o gsutil config -e.

Autenticazione con HMAC

Sebbene OAuth 2.0 sia il metodo consigliato per autenticare gsutil, puoi anche utilizzare le chiavi HMAC per le tue credenziali. Per autenticarti con HMAC, utilizza il seguente comando:

gsutil config -a

L'utilizzo di questo comando ti guida attraverso una procedura di autenticazione in cui ti viene richiesto l'ID di accesso e il secret associati alla chiave HMAC.

Quando esegui l'autenticazione con chiavi HMAC, devi disattivare il passaggio delle credenziali dall'interfaccia a Google Cloud CLI utilizzando il comando: gcloud config set pass_credentials_to_gsutil false.

Abilita mTLS

Ti consigliamo inoltre di attivare TLS reciproca (mTLS). Quando mTLS è abilitato sul dispositivo, il dispositivo tenta di connettersi all'endpoint di richiesta mTLS per l'API JSON. Prima che la connessione sia consentita, Cloud Storage verifica il certificato sul tuo dispositivo.

Nota: questa funzionalità funziona solo quando gsutil invia richieste tramite l'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 utilizzare o meno mTLS.
2. cert_provider_command: un comando shell che stampa un certificato nell'output standard per la lettura da parte 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