Google utilizza la tecnologia AI per tradurre i contenuti nella tua lingua preferita. Le traduzioni generate dall'AI potrebbero contenere errori.

Installa Google Cloud CLI

Questa guida rapida descrive il metodo consigliato per installare e inizializzare Google Cloud CLI. Dopo l'inizializzazione, esegui alcuni comandi principali dell'interfaccia a riga di comando gcloud CLI per visualizzare le informazioni sull'installazione e verificare che sia andata a buon fine.

Per seguire le indicazioni dettagliate per questa attività direttamente nella console Google Cloud , fai clic su Procedura guidata:

Procedura guidata

Prima di iniziare

Accedi al tuo account Google Cloud . Se non conosci Google Cloud, crea un account per valutare le prestazioni dei nostri prodotti in scenari reali. I nuovi clienti ricevono anche 300 $di crediti senza costi per l'esecuzione, il test e il deployment dei carichi di lavoro.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

In the Google Cloud console, on the project selector page, select or create a Google Cloud project.

Roles required to select or create a project

Select a project: Selecting a project doesn't require a specific IAM role—you can select any project that you've been granted a role on.
Create a project: To create a project, you need the Project Creator role (roles/resourcemanager.projectCreator), which contains the resourcemanager.projects.create permission. Learn how to grant roles.

Go to project selector

Verify that billing is enabled for your Google Cloud project.

Installa gcloud CLI versione 584.0.0

Linux

Verifica di avere una versione di Python supportata. Google Cloud CLI richiede Python 3.10-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 di gcloud topic startup.

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	87,2 MB	309a8fd47df8d4d5694c798b9d0d8968ae736a58f5dceba60eb2cf520b541460
Linux a 64 bit (Arm)	google-cloud-cli-linux-arm.tar.gz	52,4 MB	f4953cde989e8fa7cb0f9f350fa2e01678370e0fe7c7e836d6655be342e38930
Linux a 32 bit (x86)	google-cloud-cli-linux-x86.tar.gz	52,5 MB	b651d37b53e96570522e6804788fd917f6463121eb9caba0be421f558d78e50e

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.

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.
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
```
(Facoltativo) Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate.

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.

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
```
Sono installati ca-certificates, gnupg e curl. Per installare questi pacchetti, esegui il seguente comando:
```
sudo apt-get install ca-certificates gnupg curl
```

Installazione

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.
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 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
```
Nota:assicurati di non avere voci duplicate per il repository cloud-sdk in /etc/apt/sources.list.d/google-cloud-sdk.list.
Aggiorna e installa gcloud CLI:
```
sudo apt-get update && sudo apt-get install google-cloud-cli
```
Nota:se l'installazione viene eseguita in macchine virtuali, immagini container o runner CI/CD automatizzati con risorse limitate, puoi esportare la variabile di ambiente CLOUDSDK_SKIP_PY_COMPILATION=1 durante l'installazione per ignorare la compilazione di Python lato host. In questo modo, il tempo di installazione del pacchetto passa da minuti a secondi:
```
sudo CLOUDSDK_SKIP_PY_COMPILATION=1 apt-get install google-cloud-cli
```
L'impostazione di questa variabile salta la compilazione dei byte durante l'installazione, scambiando un po' di velocità di configurazione del pacchetto con un piccolo sovraccarico di esecuzione dei comandi interattivi.
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
      
```
(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-tools
- 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
```

Eseguire il downgrade delle versioni della 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 versioni dei pacchetti pubblicate negli ultimi 365 giorni vengono conservate nel repository.

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.

Installazione

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 il valore 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
```
- Per le installazioni ARM64 (aarch64), utilizza https://packages.cloud.google.com/yum/repos/cloud-sdk-el9-aarch64 (compatibile con RHEL 7, 8 o 9) o https://packages.cloud.google.com/yum/repos/cloud-sdk-el10-aarch64 (compatibile con RHEL 10) come valore di baseurl.

Installa libxcrypt-compat.x86_64.

sudo dnf install libxcrypt-compat.x86_64

Installa gcloud CLI:
```
sudo dnf install google-cloud-cli
```
Nota:se l'installazione viene eseguita in macchine virtuali, immagini container o runner CI/CD automatizzati con risorse limitate, puoi esportare la variabile di ambiente CLOUDSDK_SKIP_PY_COMPILATION=1 durante l'installazione per ignorare la compilazione di Python lato host. In questo modo, il tempo di installazione del pacchetto passa da minuti a secondi:
```
sudo CLOUDSDK_SKIP_PY_COMPILATION=1 dnf install google-cloud-cli
```
L'impostazione di questa variabile salta la compilazione dei byte durante l'installazione, scambiando un po' di velocità di configurazione del pacchetto con un piccolo sovraccarico di esecuzione dei comandi interattivi.
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.
(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 questo comando:
```
sudo dnf install google-cloud-cli-app-engine-java
```

Eseguire il downgrade delle versioni della 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

Le versioni dei pacchetti pubblicate negli ultimi 365 giorni vengono conservate nel repository.

macOS

Verifica di avere una versione di Python supportata. Google Cloud CLI richiede Python 3.10-3.14.
Per controllare la versione di Python, esegui python3 -V o python -V.

Il programma di installazione di gcloud installer installerà Python v3.14 e i moduli di estensione richiesti per impostazione predefinita.

Per ulteriori informazioni sulla configurazione dell'interprete Python, consulta la documentazione di gcloud topic startup.
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