Installa gsutil

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

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

L'installazione di gsutil fornisce l'accesso immediato ai dati pubblici, consentendoti di leggere e scrivere come consentito. Per interagire con i dati protetti condivisi con te, è necessaria l'autenticazione con il servizio Cloud Storage. 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 5.35 o successive di gsutil richiedono Python 3.9-3.13, che puoi ottenere utilizzando il gestore delle versioni di Python o installando una versione appropriata.

Nota: il supporto di Python 3.8 non è più disponibile in gsutil v5.35. Per garantire la compatibilità con le future release di gsutil, esegui l'upgrade dell'ambiente Python a una versione supportata (3.9 o successive).

Le seguenti istruzioni mostrano come gestire le versioni di Python:

Linux

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

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

     pyenv global 3.13

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

     pyenv local 3.13

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

   python --version

   Dovresti vedere:

   Python 3.13

macOS

Metodo 1: utilizzo di Homebrew (brew)

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

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

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

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

   python --version

   Dovresti vedere:

   Python 3.13

Metodo 2: utilizza pyenv

Prerequisiti: installa il gestore delle versioni di Python (pyenv) e 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.13

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

     pyenv local 3.13

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

   python --version

   Dovresti vedere:

   Python 3.13

Windows

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

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

     pyenv global 3.13

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

     pyenv local 3.13

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

   python --version

   Dovresti vedere:

   Python 3.13

• Se prevedi di utilizzare oggetti compositi, devi installare crcmod 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 stampato 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 puoi 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 di Google Compute Engine. Per un elenco completo, consulta i dettagli del sistema operativo.

Il metodo di installazione e aggiornamento supportato ufficialmente per gsutil è quello che fa parte di Google Cloud CLI.

Prima di iniziare

Google Cloud CLI e gsutil hanno dipendenze dalla versione di Python che potrebbero causare problemi di compatibilità. Google Cloud CLI richiede Python 3.9-3.14, mentre gsutil richiede Python 3.9-3.13.

Per installare gsutil, ti consigliamo di installarlo come parte di Google Cloud CLI. Se scegli di installare gsutil direttamente, utilizza Python 3.9-3.13 per evitare problemi di compatibilità.

Installazione di gsutil come parte di Google Cloud CLI

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

Linux

1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python 3.9-3.14. Il pacchetto Linux x86_64 include un interprete Python in bundle che verrà preferito per impostazione predefinita. Per informazioni su come scegliere e configurare l'interprete Python, consulta la documentazione gcloud topic startup.
2. Scarica uno dei seguenti elementi:
   Nota:per determinare la tua piattaforma Linux, esegui uname -a dalla riga di comando.

   Piattaforma	Nome pacchetto	Dimensioni	Checksum SHA256
   Linux a 64 bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	203 MB	81320cc3042faadbff2875c8b55c6bdcf6ccd439599c6645c27a5a6f213b4736
   Linux a 64 bit (Arm)	google-cloud-cli-linux-arm.tar.gz	57,9 MB	2fced601e0a494e6dcf6dbfb39130aefacabe541d5bcf0a5d53a8c44e71515e9
   Linux a 32 bit (x86)	google-cloud-cli-linux-x86.tar.gz	57,9 MB	8fb22634022aa74d23e877279e034e56d4fed4b5883cbfc51b9dd7134a1b96f0

   Per scaricare il file di archivio Linux, esegui questo comando:

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

   Fai riferimento alla tabella precedente e sostituisci google-cloud-cli-linux-x86_64.tar.gz con il nome del pacchetto *.tar.gz che si applica alla tua configurazione.

3. Per estrarre i contenuti del file nel file system, esegui questo comando:

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

   Per sostituire un'installazione esistente, elimina la directory google-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.
4. Esegui lo script di installazione dalla radice della cartella che hai estratto:

   ./google-cloud-sdk/install.sh

   Lo script ti chiede di eseguire le seguenti azioni di configurazione. Per accettare, rispondi Y quando richiesto.
   • Aggiungi gcloud CLI al tuo PATH.
   • Attiva il completamento dei comandi.
   • Attiva l'invio di statistiche sull'utilizzo anonime per contribuire a migliorare gcloud CLI.
   Puoi anche eseguire l'installazione in modo non interattivo fornendo i flag. Per visualizzare i flag disponibili, esegui:

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

5. (Facoltativo) Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate.
6. Esegui gcloud init per inizializzare, autorizzare e configurare gcloud CLI.
7. (Facoltativo) Installa componenti aggiuntivi utilizzando il gestore di componenti.

Debian/Ubuntu

Contenuti del pacchetto

gcloud CLI è disponibile in formato pacchetto per l'installazione su sistemi Debian e Ubuntu. Questo pacchetto contiene solo gli strumenti a riga di comando 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.

Nota:per configurazioni specifiche, sono disponibili metodi di installazione alternativi:

• Se utilizzi una versione moderna di Ubuntu con Snap Package Manager e vuoi aggiornamenti automatici, puoi installare Google Cloud CLI come pacchetto Snap.
• Se utilizzi un'istanza Compute Engine, gcloud CLI potrebbe essere già installata. Per un elenco delle immagini del sistema operativo che includono la CLI per impostazione predefinita, vedi Dettagli del sistema operativo.

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. Per farlo ora, esegui questo comando:

  sudo apt-get update

• Ha installato apt-transport-https, ca-certificates, gnupg e curl. Per installare questi pacchetti, esegui il seguente comando:

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

Installazione

1. Importa la chiave pubblica Google Cloud .

   • Per le distribuzioni più recenti (Debian 9+ o Ubuntu 18.04+), 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 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 l'ultimo file della chiave apt-get.gpg.

2. Aggiungi l'URI di distribuzione di gcloud CLI come origine pacchetto.
   • Per le distribuzioni più recenti (Debian 9+ o Ubuntu 18.04+), 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 comando seguente:

     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 di non avere voci duplicate per il repository 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 generali, consulta le pagine del manuale di apt-get.

   Suggerimento per Docker: se installi gcloud CLI all'interno di un'immagine Docker, utilizza 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 | 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-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 inizializzare, autorizzare e configurare gcloud CLI.

Eseguire il downgrade delle versioni di gcloud CLI

Per ripristinare una versione specifica di gcloud CLI, dove VERSION ha la forma 123.0.0, esegui questo comando:

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

Le dieci versioni più recenti sono sempre disponibili nel repository. Per le versioni precedenti alla 371.0.0, il nome del pacchetto è google-cloud-sdk

Red Hat/Fedora/CentOS

Contenuti del pacchetto

gcloud CLI è disponibile in formato pacchetto per l'installazione su Red Hat Enterprise Linux 7, 8, 9 e 10; Fedora 41 e 42; e sistemi 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 installate separatamente come descritto più avanti in questa sezione.

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

Installazione

1. Aggiorna DNF con le informazioni sul repository gcloud CLI.

   • Il seguente comando di esempio è per installazioni compatibili con Red Hat Enterprise Linux 7, 8 o 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

   • Per le installazioni compatibili con RHEL 10, utilizza il seguente comando con gpgkey aggiornato:

     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-el10-x86_64
     enabled=1
     gpgcheck=1
     repo_gpgcheck=0
     gpgkey=https://packages.cloud.google.com/yum/doc/rpm-package-key-v10.gpg
     EOM

2. 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 disattivare i prompt o i dry run, con i comandi forniti.

4. (Facoltativo) Installa uno dei seguenti componenti aggiuntivi:
   • 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, per installare il componente google-cloud-cli-app-engine-java, esegui il comando seguente:

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

5. Esegui gcloud init per inizializzare, autorizzare e configurare gcloud CLI.

Eseguire il downgrade delle versioni di gcloud CLI

Per ripristinare una versione specifica di gcloud CLI, esegui questo comando. Sostituisci 123.0.0 con la versione che vuoi installare:

sudo dnf downgrade google-cloud-cli-123.0.0

Nel repository sono disponibili le dieci versioni più recenti. Per le versioni precedenti alla 371.0.0, utilizza google-cloud-sdk come nome del pacchetto.

macOS

1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python 3.9-3.14.

   Per controllare la versione di Python, esegui python3 -V o python -V.

   Se necessario, lo script di installazione può installare Python. Per farlo sono necessari gli strumenti a riga di comando Xcode. Per installarli, esegui sudo xcode-select --install. In alternativa, puoi installare una versione di Python supportata da python.org.

   Per ulteriori informazioni sulla configurazione dell'interprete Python, soprattutto se hai installato più versioni, consulta la documentazione gcloud topic startup.

2. Scarica uno dei seguenti elementi:
   Nota: per determinare la tua piattaforma, 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	58 MB	9f4b289e4545d146410e87363489d11ce30c1326eae0930cd77c81a499336682
   macOS a 64 bit (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	57,9 MB	20aa219e61d7ac2b4bf78f9080c0fcf2c0b79d48ce47b9833d4087a468d749d9
   macOS a 32 bit (x86)	google-cloud-cli-darwin-x86.tar.gz	56,4 MB	979b7f6e4014d41222b8354495d4e89285021c1b69bf07f751aecdf929024422

   In alternativa, puoi scaricare l'archivio dalla riga di comando. Sostituisci FILE_NAME con il nome del pacchetto per la tua piattaforma dalla tabella precedente.

   curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/FILE_NAME

3. Estrai i contenuti del file nella posizione che preferisci nel tuo file system. È prassi comune estrarlo nella directory home.

   Su macOS, puoi farlo aprendo il file .tar.gz scaricato nella posizione che preferisci. In alternativa, dalla riga di comando, esegui:

   tar -xf FILE_NAME

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

4. Esegui lo script di installazione dalla radice della cartella che hai estratto:

   ./google-cloud-sdk/install.sh

   Lo script ti chiede di eseguire le seguenti azioni di configurazione. Per accettare, rispondi Y quando richiesto.
   • Se necessario, installa Python 3.13 e i moduli consigliati.
   • Aggiungi gcloud CLI a PATH e attiva il completamento dei comandi.
   • Attiva l'invio di statistiche sull'utilizzo anonime per contribuire a migliorare gcloud CLI.
   Puoi anche eseguire l'installazione in modo non interattivo fornendo i flag. Per visualizzare i flag disponibili, esegui:

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

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

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

5. (Facoltativo) Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate.
6. Esegui gcloud init per inizializzare, autorizzare e configurare gcloud CLI.
7. (Facoltativo) Installa componenti aggiuntivi utilizzando il gestore di componenti.

Windows

Google Cloud CLI su Windows richiede Windows 8.1 e versioni successive o 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. Il programma di installazione è 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 che utilizzi indicatori di stato anziché spinner Unicode, mostri l'avanzamento come percentuale e appiattisca le tabelle. Per ulteriori informazioni, consulta la Guida alle funzionalità di accessibilità.
   • Google Cloud CLI richiede Python; le versioni supportate sono Python 3.9-3.14. Per impostazione predefinita, la versione Windows di Google Cloud CLI viene fornita in bundle con Python 3. Per utilizzare Google Cloud CLI, il 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 di Python richiesta. Anche se Google Cloud CLI installa e gestisce Python 3 per impostazione predefinita, puoi utilizzare un'installazione Python esistente, se necessario, deselezionando l'opzione per installare Python in bundle. Consulta gcloud topic startup per scoprire come utilizzare un'installazione di Python esistente.
3. 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. Lascia 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 per inizializzare, autorizzare e configurare gcloud CLI.
4. 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 di componenti gcloud CLI.

Suggerimenti per la risoluzione dei problemi

• Se l'installazione non va a buon fine perché il comando find non viene riconosciuto, 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 installarla di nuovo.
• Se la decompressione 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 per utilizzare la versione corretta di Python. Per ulteriori dettagli, consulta 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 (autenticazione). Ad esempio, se un'altra persona 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 come parte di Google Cloud CLI, viene utilizzato OAuth2 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. Se hai eseguito gcloud init in precedenza, quando esegui di nuovo il comando ti viene chiesto se vuoi reinizializzare la configurazione o crearne una nuova. Per saperne di più, consulta Inizializza 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 ad accedere ai bucket o agli oggetti previsti, è possibile che sul tuo sistema siano installate sia la versione legacy 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 False, il sistema utilizza la versione autonoma di gsutil quando esegui i comandi. Ti consigliamo di rimuovere la versione autonoma di gsutil dal sistema. In alternativa, puoi eseguire 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 l'autenticazione con HMAC, utilizza questo comando:

gsutil config -a

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

Quando esegui l'autenticazione con le chiavi HMAC, devi disattivare il trasferimento delle credenziali da Google Cloud CLI utilizzando il comando: gcloud config set pass_credentials_to_gsutil false.

Abilita mTLS

Potresti anche voler abilitare mutual TLS (mTLS). Quando mTLS è abilitato sul tuo dispositivo, quest'ultimo 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 effettua 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 "Credenziali":

1. use_client_certificate: un flag che controlla se utilizzare o meno mTLS.
2. cert_provider_command: un comando shell che stampa un certificato su stdout 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 workload.

Prova Cloud Storage gratuitamente