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.
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. Abilitazione in corso... di fatturazione ti dà la possibilità 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.0 e successive di gsutil richiedono Python 3.5-3.11, che puoi ottenere utilizzando il gestore delle versioni di Python o installando una versione appropriata. Le istruzioni seguenti mostrano come gestire le versioni Python:
Prerequisiti: installa un gestore delle versioni di Python (pyenv) e una versione di Python adatta (consigliata 3.11).
-
Imposta la versione Python globale:
-
Per impostare Python 3.11.9 come versione globale:
pyenv global 3.11.9
-
In alternativa, imposta la versione di Python localmente per una cartella del progetto specifica:
pyenv local 3.11.9
-
Per impostare Python 3.11.9 come versione globale:
-
Verifica che sia in uso la versione Python corretta:
python --version
Dovresti vedere:
Python 3.11.9
Metodo 1: utilizzo di Homebrew (brew)
Prerequisiti: installa Homebrew e installa una versione Python adatta (3.11 consigliata) tramite homebrew.
-
Imposta una versione Python specifica come predefinita:
-
Aggiungi la versione che vuoi a
$PATH
. Ad esempio, per utilizzare Python 3.11:export PATH="/usr/local/opt/python@3.11/bin:$PATH"
-
Per rendere permanente questa modifica, aggiungi il percorso al file di configurazione della shell
(
~/.bash_profile
,~/.zshrc
o~/.bashrc
).
-
Aggiungi la versione che vuoi a
-
Verifica che sia in uso la versione Python corretta:
python --version
Dovresti vedere:
Python 3.11.9
Metodo 2: utilizzo di pyenv
Prerequisiti: installa il gestore delle versioni di Python (pyenv) e installa una versione di Python adatta (consigliata 3.11) tramite pyenv.
-
Imposta la versione Python globale:
-
Per impostare la versione Python a livello globale (per tutti i terminali):
pyenv global 3.11.9
-
Oppure imposta la versione Python localmente per una cartella di progetto specifica:
pyenv local 3.11.9
-
Per impostare la versione Python a livello globale (per tutti i terminali):
-
Verifica che sia in uso la versione Python corretta:
python --version
Dovresti vedere:
Python 3.11.9
Prerequisiti: installa Python Version Manager (pyenv-win) e installa una versione Python adatta (consigliata la 3.11) tramite pyenv.
-
Imposta la versione globale di Python:
-
Per impostare Python 3.11.9 come versione globale:
pyenv global 3.11.9
-
In alternativa, imposta la versione di Python localmente per una cartella del progetto specifica:
pyenv local 3.11.9
-
Per impostare Python 3.11.9 come versione globale:
-
Verifica che sia in uso la versione Python corretta:
python --version
Dovresti vedere:
Python 3.11.9
- Se prevedi di utilizzare oggetti composti, devi installare
crcmod. 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
.
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:
- Verifica di avere una versione di Python supportata. Google Cloud CLI richiede
Python 3.8-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
- Scarica una delle seguenti opzioni:
Piattaforma Nome pacchetto Dimensioni Checksum SHA256 Linux a 64 bit (x86_64)
google-cloud-cli-linux-x86_64.tar.gz 131,4 MB 0b03c1b005413efb7518d9245d4518660c9f597f2008ebbc84cc52de5ec7ecf6 Linux a 64 bit (Arm)
google-cloud-cli-linux-arm.tar.gz 53,6 MB 2ced8397708a130f81687e7b7e0b058ff1e7d5976997ff50099c37dd55cd1400 Linux a 32 bit (x86)
google-cloud-cli-linux-x86.tar.gz 53,6 MB b4ae77ef924b20d08fd1fdf1357bc90bf62bac69c3ca59f3c95541e7ba2f2f99 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 sopra e sostituisci google-cloud-cli-linux-x86_64.tar.gz con il nome del pacchetto
*.tar.gz
applicabile alla tua configurazione. - Per estrarre i contenuti del file nel file system (preferibilmente nella home directory), esegui il seguente comando:
(Facoltativo) Per sostituire un'installazione esistente, rimuovi la directorytar -xf google-cloud-cli-linux-x86_64.tar.gz
google-cloud-sdk
esistente ed estrae l'archivio nella stessa posizione. - 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:
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
(Facoltativo)./google-cloud-sdk/install.sh --help
- Per inviare statistiche sull'utilizzo anonime
per contribuire a migliorare l'interfaccia a riga di comando gcloud, rispondi
Y
quando richiesto. -
Per aggiungere gcloud CLI a
PATH
e attivare il completamento dei comandi, rispondiY
quando richiesto.
- Per inviare statistiche sull'utilizzo anonime
per contribuire a migliorare l'interfaccia a riga di comando gcloud, rispondi
- Apri un nuovo terminale per applicare le modifiche.
- Per inizializzare l'interfaccia a riga di comando gcloud, esegui
gcloud init
: - (Facoltativo) Installa componenti aggiuntivi utilizzando il gestore dei componenti.
./google-cloud-sdk/bin/gcloud init
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
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 installare gcloud CLI, assicurati che il tuo sistema operativo soddisfi i seguenti requisiti 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
- Sono installati
apt-transport-https
ecurl
:sudo apt-get install apt-transport-https ca-certificates gnupg curl
- 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 comando 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.
- Aggiungi l'URI di distribuzione della gcloud CLI 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
- Per le distribuzioni più recenti (Debian 9 o versioni successive o Ubuntu 18.04 o versioni successive), esegui il seguente comando:
- Aggiorna e installa gcloud CLI:
Per ulteriori opzioni disudo apt-get update && sudo apt-get install google-cloud-cli
apt-get
, come la disattivazione dei prompt o delle prove, consulta le pagine man diapt-get
.Suggerimento per Docker: se installi l'interfaccia a riga di comando gcloud all'interno di un'immagine Docker, utilizza invece un singolo passaggio RUN:
Per le immagini di base meno recenti che non supportano il comandoRUN 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
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
- (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 apt-get install google-cloud-cli-app-engine-java
- 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
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
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.
- 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
-
Se esegui l'installazione su Fedora 34 o 35, installa
libxcrypt-compat.x86_64
.sudo dnf install libxcrypt-compat.x86_64
- Installa l'interfaccia a riga di comando gcloud:
sudo dnf install google-cloud-cli
- (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
- 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
-
Verifica di avere una versione di Python supportata:
-
Per controllare la versione di Python attualmente in uso, esegui
python3 -V
opython -V
. Le versioni supportate sono da Python 3.8 a 3.12. - Lo script di installazione principale offre la possibilità di installare 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 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
.
-
Per controllare la versione di Python attualmente in uso, esegui
- Scarica una delle seguenti opzioni:
-
Estrai l'archivio in qualsiasi posizione sul tuo file system (preferibilmente nella tua home directory). Su
macOS, puoi farlo aprendo il file dell'archivio
.tar.gz
scaricato nella posizione che preferisci.Per sostituire un'installazione esistente, rimuovi quella esistente
google-cloud-sdk
ed estrai l'archivio nella stessa posizione. -
(Facoltativo) Utilizza lo script di installazione per aggiungere gli strumenti dell'interfaccia a riga di comando gcloud 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:
Questa operazione può essere eseguita anche in modo non interattivo (ad esempio utilizzando uno script) specificando le preferenze come flag. Per descrivere i flag disponibili, esegui:./google-cloud-sdk/install.sh
Per eseguire lo script di installazione con la modalità dello screen reader attiva:./google-cloud-sdk/install.sh --help
Apri un nuovo terminale per rendere effettive le modifiche../google-cloud-sdk/install.sh --screen-reader=true
-
Per inizializzare l'interfaccia a riga di comando gcloud, esegui
gcloud init
: - Facoltativo. Installa componenti aggiuntivi utilizzando il gestore dei componenti.
Piattaforma | Pacchetto | Dimensioni | Checksum SHA256 |
---|---|---|---|
macOS a 64 bit
(x86_64) |
google-cloud-cli-darwin-x86_64.tar.gz | 53,7 MB | 6d978eecbf96d152413cf8e9d01dbf6d4abc99823a4f4ed4df73b823714dc7f3 |
macOS a 64 bit
(ARM64, Apple M1 silicon) |
google-cloud-cli-darwin-arm.tar.gz | 53,7 MB | 9a10cf8fcf7a66ec978ad2ffbc8ae561498433236e4a954c1f99dbf58fdd5949 |
macOS a 32 bit
(x86) |
google-cloud-cli-darwin-x86.tar.gz | 52,4 MB | 641b507bc314bbd69ef9acb58d9c2b57059aaf8788504a63d5202b8acf6da457 |
./google-cloud-sdk/bin/gcloud init
-
Google Cloud CLI funziona su Windows 8.1 e versioni successive e Windows Server 2012 e versioni successive.
-
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
-
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à. -
Google Cloud CLI richiede Python, le versioni supportate sono Python dalla 3.8 alla 3.12. Per impostazione predefinita, la versione di Google Cloud CLI per Windows è 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 di Python richiesta. 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
gcloud topic startup
per scoprire come utilizzare un'installazione di Python esistente. 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
.- 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.
- Se l'installazione non va a buon fine
a causa del mancato riconoscimento del comando
find
, assicurati che la variabile di ambientePATH
sia impostata in modo da includere la cartella contenentefind
. Di solito, questo èC:\WINDOWS\system32;
. - Se hai disinstallato gcloud CLI, devi riavviare il sistema prima di reinstallarlo.
- 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, per configurare le credenziali (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 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 le
procedura di installazione riportata 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 di 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, 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 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
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 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 riga di comando Google Cloud utilizzando il comando:
gcloud config set pass_credentials_to_gsutil false
.
Abilita mTLS
Ti consigliamo inoltre di attivare TLS reciproco (mTLS). Quando mTLS è abilitato sul tuo dispositivo, il dispositivo tenta di connettersi all'endpoint di richiesta mTLS l'API JSON. Prima che la connessione sia consentita, Cloud Storage verifica il certificato sul tuo dispositivo.
Il modo più semplice per ottenere un certificato è tramite Google Cloud CLI. Puoi impostarne uno manualmente nel file .boto impostando quanto segue nella sezione "Credenziali":
-
use_client_certificate
: un flag che controlla se utilizzare o meno mTLS. -
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