In questa pagina vengono descritte 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 consente l'accesso immediato in lettura e/o in scrittura ai dati pubblici. L'autenticazione nel servizio Cloud Storage ti consente di accedere in lettura e/o in scrittura ai dati protetti condivisi con te. L'abilitazione della fatturazione ti permette 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.
Se prevedi di utilizzare oggetti composti, devi installare crcmod compilato. Su Windows, è disponibile solo per Python a 32 bit. Per ulteriori informazioni su crcmod, installa gsutil e consulta l'argomento del Centro assistenza utilizzando il comando
gsutil help crc32c
.
Installazione di gsutil
Il metodo di installazione e aggiornamento supportato ufficialmente per gsutil fa parte di Google Cloud CLI.
Installazione di gsutil nell'ambito 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 supportata di Python. Google Cloud CLI richiede Python dalla versione 3.8 alla versione 3.12. Tieni presente che il pacchetto x86_64 Linux 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
. - Scarica uno dei seguenti elementi:
Piattaforma Nome pacchetto Dimensioni Checksum SHA256 Linux a 64 bit (x86_64)
google-cloud-cli-473.0.0-linux-x86_64.tar.gz 129,9 MB e15da3e41f24c072a3e8359dffca08d5ab7ee03f94e2e8711bbfbaf1cc3456f8 Linux a 64 bit (Arm)
google-cloud-cli-473.0.0-linux-arm.tar.gz 51,7 MB c16fa95ea22b27a887aafa9d86e439794b6c80b0f97a1210bf8b7c57afb03c27 Linux a 32 bit (x86)
google-cloud-cli-473.0.0-linux-x86.tar.gz 51,7 MB 85ef8a1303bbc2e919bfc3fb2fe2ea758a196435b935f88a297d6b1cb42ae570 Per scaricare il file di archivio di Linux, esegui questo comando:
curl -O https://dl.google.com/dl/cloudsdk/channels/rapid/downloads/google-cloud-cli-473.0.0-linux-x86_64.tar.gz
Fai riferimento alla tabella precedente e sostituisci google-cloud-cli-473.0.0-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 questo comando:
tar -xf google-cloud-cli-473.0.0-linux-x86_64.tar.gz
Facoltativo: per sostituire un'installazione esistente, rimuovi la directorygoogle-cloud-sdk
esistente, quindi estrai l'archivio nella stessa posizione. - Aggiungi gcloud CLI al tuo percorso. Esegui lo script di installazione dalla directory principale 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 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 abilitare il completamento dei comandi, rispondi aY
quando richiesto.
- Per inviare statistiche sull'utilizzo anonime
per contribuire a migliorare gcloud CLI, rispondi
- Apri un nuovo terminale per applicare le modifiche.
- Per inizializzare gcloud CLI, esegui
gcloud init
: - (Facoltativo) Installa i componenti aggiuntivi utilizzando Gestione componenti.
./google-cloud-sdk/bin/gcloud init
Contenuti del pacchetto
gcloud CLI è disponibile nel formato pacchetto per l'installazione sui sistemi Debian e Ubuntu.
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
. Se vuoi utilizzare questi componenti, devi installarli separatamente.
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
- Ha
apt-transport-https
ecurl
installati: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 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 aggiornamenti più recenti a causa di una chiave scaduta, ottieni il file della chiave apt-get.gpg più recente.
- 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 meno recenti 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
- Per le distribuzioni più recenti (Debian 9 e versioni successive o Ubuntu 18.04 e versioni successive), esegui questo comando:
- Aggiorna e installa gcloud CLI:
sudo apt-get update && sudo apt-get install google-cloud-cli
Per ulteriori opzioni diapt-get
, come la disattivazione dei prompt o delle esecuzioni di prova, consulta le pagine man diapt-get
.Suggerimento Docker: se installi gcloud CLI all'interno di un'immagine Docker, utilizza invece un singolo passaggio di 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 comandogpg --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 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
- 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
Contenuti del pacchetto
L'gcloud CLI è disponibile nel formato dei pacchetti 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.
- Aggiorna DNF con le informazioni del repository gcloud CLI.
Il seguente comando di esempio riguarda 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
-
Se stai installando 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 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
- Esegui
gcloud init
per iniziare:gcloud init
Eseguire il downgrade delle versioni di gcloud CLI
Se vuoi ripristinare 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
-
Verifica di avere una versione supportata di Python:
-
Per controllare la tua versione attuale di Python, esegui
python3 -V
opython -V
. Le versioni supportate sono Python dalla 3.8 alla 3.12. - Lo script di installazione principale offre l'installazione di Python 3.11.
- Altrimenti, per installare una versione Python supportata, visita la pagina Release in Python per macOS di Python.org.
- Se hai più interpreti Python installati sulla tua macchina, imposta la variabile di ambiente CLOUDSDK_PYTHON all'interno della shell in modo che punti al percorso del tuo interprete preferito.
-
Per maggiori informazioni su come scegliere e configurare l'interprete Python, consulta
gcloud topic startup
.
-
Per controllare la tua versione attuale di Python, esegui
- Scarica uno dei seguenti elementi:
-
Estrai l'archivio in qualsiasi posizione sul tuo file system (preferibilmente la home directory). Su macOS, è possibile svolgere questa operazione aprendo il file di archivio
.tar.gz
scaricato nella posizione che preferisci.Per sostituire un'installazione esistente, rimuovi la directory
google-cloud-sdk
esistente, quindi estrai l'archivio nella stessa posizione. -
(Facoltativo) Utilizza lo script di installazione per aggiungere 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 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. -
To initialize the gcloud CLI, run
gcloud init
: - Optional. Install additional components using the component manager.
Piattaforma | Pacchetto | Dimensioni | Checksum SHA256 |
---|---|---|---|
macOS a 64 bit
(x86_64) |
google-cloud-cli-473.0.0-darwin-x86_64.tar.gz | 51,7 MB | 9ddd90144a004d9ff630781e9b8f144c21b2cea8fb45038073b7fb82399ed478 |
macOS a 64 bit
(ARM64, Apple M1 silicon) |
google-cloud-cli-473.0.0-darwin-arm.tar.gz | 51,7 MB | 4b534bf60585b6f6918daf0feeb0b68b39a689a794404e5a4f8fd8ce844de31c |
macOS a 32 bit
(x86) |
google-cloud-cli-473.0.0-darwin-x86.tar.gz | 50,4 MB | 7c15cd239528437f7f8f1718709c653c03edf2ff53907c4e834c5eeab7a3a55e |
./google-cloud-sdk/bin/gcloud init
-
The Google Cloud CLI works on Windows 8.1 and later and Windows Server 2012 and later.
-
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
-
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 che utilizzi tracker di stato anziché spinner Unicode, visualizzare l'avanzamento in percentuale e suddividere le tabelle. Per ulteriori informazioni, consulta la guida alle funzioni di accessibilità. -
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 include 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. Mentre 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 Python esistente. Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie per il menu Start e il desktop, avviare la shell di 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 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.
- Se l'installazione non va a buon fine perché il comando
find
non viene riconosciuto, assicurati che la variabile di ambientePATH
sia impostata in modo da includere la cartella contenentefind
. Di solito, èC:\WINDOWS\system32;
. - Se hai disinstallato gcloud CLI, devi riavviare il sistema prima di installarlo di nuovo.
- 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 qualcun altro ha creato un account Cloud Storage e caricato dati accessibili solo a te o ad altre persone specifiche, per poter accedere a questi dati devi configurare le tue credenziali per il servizio Cloud Storage.
Quando utilizzi gsutil come parte di Google Cloud CLI, viene utilizzato OAuth2 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, tra cui 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 eseguirai di nuovo il comando ti verrà chiesto se vuoi reinizializzare la
configurazione o crearne una nuova. Per maggiori informazioni, consulta
Inizializzare Google Cloud CLI.
Questo è tutto. 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 ancora non riesci ad accedere ai bucket o agli oggetti previsti, il tuo sistema potrebbe avere installato sia la versione legacy autonoma di gsutil sia la versione di gsutil integrata 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. È consigliabile
rimuovere la versione autonoma di gsutil dal sistema; tuttavia, in alternativa, puoi
eseguire l'autenticazione utilizzando gsutil config -a
o gsutil config -e
.
Autenticazione con HMAC
Sebbene OAuth 2.0 sia il modo consigliato per autenticare gsutil, puoi anche utilizzare le chiavi HMAC per le tue credenziali. Per eseguire l'autenticazione con HMAC, utilizza il seguente comando:
gsutil config -a
L'utilizzo di questo comando ti guida in un processo di autenticazione in cui ti viene richiesto l'ID di accesso e il secret associati alla chiave HMAC.
Durante l'autenticazione con chiavi HMAC, devi disabilitare il trasferimento delle credenziali da
Google Cloud CLI utilizzando il comando:
gcloud config set pass_credentials_to_gsutil false
.
Attiva mTLS
Puoi anche attivare il protocollo TLS reciproco (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 uno manualmente nel file .boto impostando i seguenti valori in "Credenziali":
-
use_client_certificate
: un flag che controlla se utilizzare o meno mTLS. -
cert_provider_command
: un comando shell che stampa un certificato in stdout per consentire la lettura a 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