In questa pagina viene descritta l'installazione e la configurazione di gsutil, uno strumento che consente per 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).
gsutil 5.0 e versioni successive richiedono Python 3.
Se prevedi di utilizzare oggetti composti, devi installare crcmod. Su Windows, questa funzionalità è disponibile solo per Python a 32 bit. Per ulteriori informazioni informazioni su crcmod, installa gsutil e consulta l'argomento della guida utilizzando 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 dalla versione 3.8 alla versione 3.12. Nota 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 uno dei seguenti file:
Piattaforma Nome pacchetto Dimensioni Checksum SHA256 Linux a 64 bit (x86_64)
google-cloud-cli-linux-x86_64.tar.gz 130,2 MB 8ef27e11273a04bfb0e6569340b98524f9b0c2fbb549d7a4c27039d24d16cb00 Linux a 64 bit (Arm)
google-cloud-cli-linux-arm.tar.gz 52,7 MB a7213a01c6a24e9db43ac59978265ad60ffc600bb0519ef80c99653b3ec7fb12 Linux a 32 bit (x86)
google-cloud-cli-linux-x86.tar.gz 52,7 MB 33e3d2b1442ebf029555c219eb4b00c44e09bf802a23df6a8eaa649085364179 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
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-linux-x86_64.tar.gz
(Facoltativo) Per sostituire un'installazione esistente, rimuovi quella esistentegoogle-cloud-sdk
ed estrai l'archivio nella directory nella stessa località. - Aggiungi gcloud CLI al tuo percorso. Esegui lo script di installazione dalla directory radice del
cartella che hai estratto con il seguente comando:
./google-cloud-sdk/install.sh
Ciò può essere fatto anche in modo non interattivo (ad esempio, utilizzando uno script) e indicando le preferenze come flag. Per visualizzare i flag disponibili, esegui:./google-cloud-sdk/install.sh --help
(Facoltativo)- Per inviare statistiche sull'utilizzo anonimizzate.
per contribuire a migliorare gcloud CLI, rispondi
Y
quando richiesto. -
Per aggiungere gcloud CLI a
PATH
e abilitare completamento comando, rispondiY
quando richiesto.
- Per inviare statistiche sull'utilizzo anonimizzate.
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 in formato di pacchetto per l'installazione su sistemi Debian e Ubuntu.
Questo pacchetto contiene gcloud
, gcloud alpha
,
Solo i comandi 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
- Ha
apt-transport-https
ecurl
hanno installato: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 o versioni successive), esegui il comando 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 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 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
- 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 altre opzioni diapt-get
, come la disattivazione dei prompt o delle prove, consulta le pagine man diapt-get
.Suggerimento Docker: se installi gcloud CLI all'interno di un'immagine Docker, utilizza un'interfaccia a riga di comando 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 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 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 App Engine
necessarie per eseguire il deployment di un'applicazione utilizzando i comandi gcloud
, che possono essere
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 stai eseguendo l'installazione su Fedora 34 o 35, installa
libxcrypt-compat.x86_64
.sudo dnf install libxcrypt-compat.x86_64
- Installa la gcloud CLI:
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 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
-
Verifica di avere una versione di Python supportata:
-
Per controllare la tua versione Python attuale, 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 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 CLOUDSDK_PYTHON all'variabile di ambiente della shell per puntare al percorso dell'interprete preferito.
-
Per ulteriori informazioni su come scegliere e configurare il tuo interprete Python, vedi
gcloud topic startup
-
Per controllare la tua versione Python attuale, esegui
- Scarica uno dei seguenti file:
-
Estrai l'archivio in qualsiasi posizione sul tuo file system (preferibilmente nella tua home directory). Attivato
macOS, puoi farlo aprendo lo strumento
.tar.gz
file di archivio 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 della gcloud CLI al tuo
PATH
.Puoi anche attivare il completamento dei comandi per la tua shell, raccolta delle statistiche sull'utilizzo e installa Python 3.11.Esegui lo script (dalla radice della cartella estratta nell'ultimo passaggio) utilizzando questo :
./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-darwin-x86_64.tar.gz | 52,7 MB | b30e19ab6c5f6eef7541967aec72cb33fb6ba772741fb6a2f24c1fef2a829064 |
macOS a 64 bit
(ARM64, Apple M1 silicon) |
google-cloud-cli-darwin-arm.tar.gz | 52,7 MB | bb0db456b605c4f7630bb65860641e81c698d31c03c81f7ea6eac539fbe2d8ec |
macOS a 32 bit
(x86) |
google-cloud-cli-darwin-x86.tar.gz | 51,4 MB | 5b806f83c4c4d000ab137698f202a43aed7bc6006347589e8e5b45c016af84cd |
./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à screen reader. Questo l'opzione configura
gcloud
in modo che usi tracker di stato anziché rotellina Unicode, visualizzare l'avanzamento in percentuale e rendere più uniformi le tabelle. Per ulteriori informazioni, consulta Guida alle funzioni di accessibilità. -
Google Cloud CLI richiede Python, le versioni supportate sono Python dalla 3.8 alla 3.12. Di per impostazione predefinita, la versione Windows di Google Cloud CLI viene 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 Python necessaria. 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 le
gcloud topic startup
per imparerai a utilizzare un'installazione Python esistente. Al termine dell'installazione, il programma di installazione ti dà la possibilità di creare un menu Start e sul desktop, avvia la shell di Google Cloud CLI e con gcloud CLI. Assicurati di lasciare le opzioni per avviare la shell e configurare installazione selezionata. Il programma di installazione apre una finestra del terminale ed esegue Comando
gcloud init
.- L'installazione predefinita non include le estensioni di App Engine necessarie per eseguire il deployment di un'istanza
utilizzando i comandi
gcloud
. Questi componenti possono essere installati utilizzando Gestore dei componenti dell'interfaccia a riga di comando gcloud.
- Se l'installazione non va a buon fine
poiché il comando
find
non è stato riconosciuto, verifica chePATH
la variabile di ambiente è impostata per includere la cartella contenentefind
. Di solito, questo èC:\WINDOWS\system32;
. - Se hai disinstallato gcloud CLI, devi riavviare il tuo prima di installare nuovamente 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, per impostare 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 come parte di Google Cloud CLI, OAuth2 viene utilizzato per
di autenticare e autorizzare l'accesso alle risorse Cloud Storage. A
per stabilire l'accesso, esegui il comando gcloud init
e segui le
istruzioni fornite nella riga di comando, tra cui l'accesso all'account
. 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 nuovamente il comando, ti viene chiesto se desideri reinizializzare
configurazione o crearne una nuova. Per ulteriori informazioni, vedi
Inizializza 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 continui a
di accesso ai bucket o agli oggetti previsti, il sistema potrebbe avere
la versione standalone precedente di gsutil e il bundle Google Cloud CLI
di gsutil installata. 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
in alternativa, 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 eseguire l'autenticazione con HMAC, utilizza questo comando:
gsutil config -a
Questo comando ti guiderà attraverso un processo di autenticazione in cui Vengono richiesti l'ID di accesso e il segreto associati alla chiave HMAC.
Durante l'autenticazione con chiavi HMAC, devi disabilitare il trasferimento delle credenziali
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, il dispositivo tenta di connettersi
storage.mtls.googleapis.com
. Per consentire la connessione,
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 per non utilizzare 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