Installa gsutil

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

La semplice installazione di gsutil offre accesso immediato in lettura e/o scrittura ai dati pubblici. L'autenticazione nel servizio Cloud Storage ti fornisce l'accesso in lettura e/o scrittura ai dati protetti che sono stati condivisi con te. Se abiliti la fatturazione, puoi 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).

  • gsutil 5.0 e versioni successive richiedono Python 3.

  • Se prevedi di utilizzare oggetti composti, devi installare crcmod compilato. Su Windows, questa funzionalità è 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.

Installazione di gsutil

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

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 da 3.8 a 3.12. 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 il tuo interprete Python, vedi gcloud topic startup.
  2. Scarica uno dei seguenti file:
    Piattaforma Nome pacchetto Dimensioni Checksum SHA256
    Linux a 64 bit

    (x86_64)

    google-cloud-cli-481.0.0-linux-x86_64.tar.gz 130,5 MB cb74575496ee2a0e9eb6cae67349d07de50662b55ada4ff64fc32268b247882e
    Linux a 64 bit

    (Arm)

    google-cloud-cli-481.0.0-linux-arm.tar.gz 52 MB 4feb0d463d9e84e525d9e6e88154352b6503a74459b144fa8eb13c116edd13b3
    Linux a 32 bit

    (x86)

    google-cloud-cli-481.0.0-linux-x86.tar.gz 52,1 MB 2d375ebe1baf200802df6b5a5bd3045cea896192e596a0f4fcf02c268623ae8f

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

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

    Fai riferimento alla tabella precedente e sostituisci google-cloud-cli-481.0.0-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 tua home directory), esegui questo comando:
    tar -xf google-cloud-cli-481.0.0-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 gcloud CLI al tuo percorso. Esegui lo script di installazione dalla directory radice della cartella che hai estratto utilizzando il seguente comando:
    ./google-cloud-sdk/install.sh
    Questa operazione può anche essere eseguita in modo non interattivo (ad esempio utilizzando uno script) e specificando le preferenze sotto forma di flag. Per visualizzare i flag disponibili, esegui:
    ./google-cloud-sdk/install.sh --help
    Facoltativo:
    • Per inviare statistiche sull'utilizzo anonimo per contribuire a migliorare gcloud CLI, rispondi Y quando richiesto.
    • Per aggiungere gcloud CLI a PATH e abilitare il completamento dei comandi, rispondi Y quando richiesto.
  5. Apri un nuovo terminale per applicare le modifiche.
  6. Per inizializzare gcloud CLI, esegui gcloud init:
  7. ./google-cloud-sdk/bin/gcloud init
  8. (Facoltativo) Installa componenti aggiuntivi utilizzando Gestione componenti.
Debian/Ubuntu

Contenuti del pacchetto

gcloud CLI è disponibile in formato di 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 Ubuntu che non ha raggiunto la fine del ciclo di vita o di una release stabile Debian che non ha ancora raggiunto la fine del ciclo di vita.
  • Di recente ha aggiornato i propri pacchetti:
    sudo apt-get update
  • Ha apt-transport-https e curl installati:
    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 e versioni successive) esegui questo 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 questo 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 il file della chiave apt-get.gpg più recente.

  2. Aggiungi l'URI di distribuzione dell'interfaccia a riga di comando gcloud 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
  3. Aggiorna e installa gcloud CLI:
    sudo apt-get update && sudo apt-get install google-cloud-cli
    Per ulteriori opzioni di apt-get, come la disattivazione dei prompt o delle prove, consulta le pagine man di apt-get.

    Suggerimento Docker: se installi gcloud CLI all'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-sdk -y
        
    Per le immagini di base meno recenti 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 il downgrade delle versioni di gcloud CLI

Per ripristinare una versione specifica di gcloud CLI, dove VERSION è nel formato 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

Contenuti del pacchetto

gcloud CLI è disponibile in formato di 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 di 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.

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 tue esigenze di 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
  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 il downgrade delle versioni di gcloud CLI

Se vuoi tornare a una versione specifica di gcloud CLI, dove VERSION è nel formato 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 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.
    • In caso contrario, per installare una versione Python supportata, visita la pagina delle Release Python per macOS di Python.org.
    • Se sulla macchina sono installati più interpreti Python, imposta la variabile di ambiente CLOUDSDK_PYTHON all'interno della shell in modo che punti al percorso dell'interprete preferito.
    • Per maggiori informazioni su come scegliere e configurare il tuo interprete Python, vedi gcloud topic startup.
  2. Scarica uno dei seguenti file:
  3. Piattaforma Pacchetto Dimensioni Checksum SHA256
    macOS a 64 bit

    (x86_64)

    google-cloud-cli-481.0.0-darwin-x86_64.tar.gz 52,1 MB 29064fe40199a9c7322dbb36e8876e7c6433ce16d55559ffaef2316b03028fd9
    macOS a 64 bit

    (ARM64, Apple M1 silicon)

    google-cloud-cli-481.0.0-darwin-arm.tar.gz 52,1 MB 4a140315b3dd634f7ac066317461c1dc88ec38ae3e3d2fa3e1c21eefa7b2fefc
    macOS a 32 bit

    (x86)

    google-cloud-cli-481.0.0-darwin-x86.tar.gz 50,8 MB 0d2dcc35d0ad2da2c837b98664872260754931adbb64ac9c94b801276045fd42
    1. Estrai l'archivio in qualsiasi posizione sul tuo file system (preferibilmente nella tua home directory). Su macOS, puoi farlo aprendo il file di archivio .tar.gz scaricato nella posizione preferita.

      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 sull'utilizzo e installare Python 3.11.

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

      ./google-cloud-sdk/install.sh
      
      This can also be done non-interactively (for example, using a script) by providing preferences as flags. To describe the available flags, run:
      ./google-cloud-sdk/install.sh --help
      
      To run the install script with screen reader mode on:
      ./google-cloud-sdk/install.sh --screen-reader=true
      
      Open a new terminal so that the changes take effect.
    3. To initialize the gcloud CLI, run gcloud init:
    4. ./google-cloud-sdk/bin/gcloud init
      
    5. Optional. Install additional components using the component manager.
Windows
    The Google Cloud CLI works on Windows 8.1 and later and Windows Server 2012 and later.
  1. Download the Google Cloud CLI installer.

    Alternatively, open a PowerShell terminal and run the following PowerShell commands:

    (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à screen reader. Questa opzione consente di configurare gcloud in modo che utilizzi tracker di stato anziché gli spinner Unicode, consente di visualizzare l'avanzamento in percentuale e di rendere più uniformi le tabelle. Per maggiori informazioni, consulta la guida alle funzionalità di accessibilità.

  3. Google Cloud CLI richiede Python; le versioni supportate sono Python dalla 3.8 alla 3.12. Per impostazione predefinita, la versione Windows di Google Cloud CLI è inclusa in 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 Python necessaria. Anche se Google Cloud CLI installa e gestisce Python 3 per impostazione predefinita, se necessario puoi utilizzare un'installazione Python esistente deselezionando l'opzione Installa Python in bundle. Consulta la pagina gcloud topic startup per scoprire come utilizzare un'installazione Python esistente.

  4. Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie per il menu Start e desktop, avviare la shell di Google Cloud CLI e configurare gcloud CLI. Assicurati di lasciare le opzioni per avviare la shell e configurare l'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 di 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 perché il comando find non è stato riconosciuto, assicurati che la variabile di ambiente PATH sia impostata in modo da includere la cartella contenente find. Solitamente, è C:\WINDOWS\system32;.
  • Se hai disinstallato gcloud CLI, devi riavviare il sistema prima di installare di nuovo 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 a dati protetti o scrivere in un bucket protetto, devi configurare le credenziali (autenticazione). Ad esempio, se un altro utente ha creato un account Cloud Storage e 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 tali dati.

Quando utilizzi gsutil in Google Cloud CLI, OAuth2 viene utilizzato per autenticare e autorizzare l'accesso alle tue risorse Cloud Storage. Per stabilire l'accesso, esegui il comando gcloud init e segui le istruzioni fornite nella riga di comando, incluso l'accesso al tuo account utente. Tieni presente che probabilmente hai già eseguito questa configurazione se hai seguito la procedura di installazione riportata sopra. Se hai eseguito gcloud init in precedenza, quando esegui nuovamente il comando ti viene chiesto se vuoi reinizializzare la configurazione o crearne una nuova. Per maggiori 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 ad accedere ai bucket o agli oggetti previsti, nel sistema potrebbe essere installata sia la versione autonoma autonoma di gsutil sia la versione in bundle di Google Cloud CLI di gsutil. 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 dal sistema la versione autonoma di gsutil; tuttavia, 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 eseguire l'autenticazione con HMAC, utilizza questo comando:

gsutil config -a

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

Durante l'autenticazione con chiavi HMAC, devi disabilitare la trasmissione delle credenziali da 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, quest'ultimo tenta di connettersi a storage.mtls.googleapis.com. Prima che la connessione sia consentita, Cloud Storage verifica il certificato sul dispositivo.

Il modo più semplice per ottenere un certificato è tramite Google Cloud CLI. Puoi impostarne una 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 a 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