Installa Google Cloud CLI

Prima di iniziare

1. In the Cloud de Confiance console, on the project selector page, select or create a Cloud de Confiance 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

2. Verify that billing is enabled for your Cloud de Confiance project.

Al termine delle attività descritte in questo documento, puoi evitare l'addebito di ulteriori costi eliminando le risorse che hai creato. Per saperne di più, consulta Esegui la pulizia.

Installa gcloud CLI versione 549.0.0

Linux

1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python 3.9-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 gcloud topic startup.
2. Scarica uno dei seguenti elementi:

   Piattaforma	Nome pacchetto	Dimensioni	Checksum SHA256
   Linux a 64 bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	203 MB	81320cc3042faadbff2875c8b55c6bdcf6ccd439599c6645c27a5a6f213b4736
   Linux a 64 bit (Arm)	google-cloud-cli-linux-arm.tar.gz	57,9 MB	2fced601e0a494e6dcf6dbfb39130aefacabe541d5bcf0a5d53a8c44e71515e9
   Linux a 32 bit (x86)	google-cloud-cli-linux-x86.tar.gz	57,9 MB	8fb22634022aa74d23e877279e034e56d4fed4b5883cbfc51b9dd7134a1b96f0

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

   curl -O https://storage.s3nsapis.fr/cloud-sdk-release/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.

3. 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.
4. 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

5. (Facoltativo) Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate.

macOS

1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python 3.9-3.14.

   Per controllare la versione di Python, esegui python3 -V o python -V.

   Se necessario, lo script di installazione può installare Python. Per farlo sono necessari gli strumenti a riga di comando Xcode. Per installarli, esegui sudo xcode-select --install. In alternativa, puoi installare una versione di Python supportata da python.org.

   Per ulteriori informazioni sulla configurazione dell'interprete Python, soprattutto se hai installato più versioni, consulta la documentazione gcloud topic startup.

2. Scarica uno dei seguenti elementi:

   Piattaforma	Pacchetto	Dimensioni	Checksum SHA256
   macOS a 64 bit (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	58 MB	9f4b289e4545d146410e87363489d11ce30c1326eae0930cd77c81a499336682
   macOS a 64 bit (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	57,9 MB	20aa219e61d7ac2b4bf78f9080c0fcf2c0b79d48ce47b9833d4087a468d749d9
   macOS a 32 bit (x86)	google-cloud-cli-darwin-x86.tar.gz	56,4 MB	979b7f6e4014d41222b8354495d4e89285021c1b69bf07f751aecdf929024422

   In alternativa, puoi scaricare l'archivio dalla riga di comando. Sostituisci FILE_NAME con il nome del pacchetto per la tua piattaforma dalla tabella precedente.

   curl -O https://storage.s3nsapis.fr/cloud-sdk-release/FILE_NAME

3. Estrai i contenuti del file nella posizione che preferisci nel tuo file system. È prassi comune estrarlo nella directory home.

   Su macOS, puoi farlo aprendo il file .tar.gz scaricato nella posizione che preferisci. In alternativa, dalla riga di comando, esegui:

   tar -xf FILE_NAME

   Per sostituire un'installazione esistente, elimina la directory google-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.

4. 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.
   • Se necessario, installa Python 3.13 e i moduli consigliati.
   • Aggiungi gcloud CLI a PATH e 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

   Per eseguire lo script di installazione con la modalità screen reader attivata:

   ./google-cloud-sdk/install.sh --screen-reader=true

5. (Facoltativo) Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate.

Windows

Google Cloud CLI su Windows richiede Windows 8.1 e versioni successive o Windows Server 2012 e versioni successive.

1. 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://storage.s3nsapis.fr/cloud-sdk-release/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
   
   & $env:Temp\GoogleCloudSDKInstaller.exe
       

2. Avvia il programma di installazione e segui le istruzioni nei prompt. Il programma di installazione è firmato da Google LLC.

   • Se utilizzi uno screen reader, seleziona la casella di controllo Attiva la modalità screen reader. Questa opzione configura gcloud in modo che utilizzi indicatori di stato anziché spinner Unicode, mostri l'avanzamento come percentuale e appiattisca le tabelle. Per ulteriori informazioni, consulta la Guida alle funzionalità di accessibilità.
   • Google Cloud CLI richiede Python; le versioni supportate sono Python 3.9-3.14. Per impostazione predefinita, la versione Windows di Google Cloud CLI viene fornita in bundle con 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 di Python richiesta. Anche se 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 di Python esistente.

3. Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie nel menu Start e sul desktop e di avviare la shell Google Cloud CLI. Deseleziona l'opzione per avviare la shell. Nei passaggi successivi eseguirai e configurerai gcloud CLI.

Suggerimenti per la risoluzione dei problemi

• Se l'installazione non va a buon fine perché il comando find non viene riconosciuto, assicurati che la variabile di ambiente PATH sia impostata in modo da includere la cartella contenente find. In genere, si tratta di C:\WINDOWS\system32;.
• Se hai disinstallato gcloud CLI, devi riavviare il sistema prima di installarla di nuovo.
• Se la decompressione non va a buon fine, esegui il programma di installazione come amministratore.

Inizializza e autorizza gcloud CLI

Se utilizzi un proxy o un firewall, consulta Configurazione del proxy per attivare l'accesso alla rete per gcloud CLI.

Dopo aver installato gcloud CLI, inizializzala per autorizzare l'accesso a Cloud de Confiance e configurare una configurazione predefinita. Per ulteriori informazioni, consulta gcloud init.

1. Esegui gcloud init per inizializzare gcloud CLI:

   gcloud init
   

   Per impostazione predefinita, questo comando apre un browser web per autorizzare l'accesso. Per autorizzare dalla riga di comando, aggiungi il flag --console-only. Per l'autorizzazione non interattiva, crea un service account con gli ambiti appropriati nella Cloud de Confiance console, quindi utilizza gcloud auth activate-service-account con il relativo file della chiave JSON.

2. Segui le istruzioni per autorizzare e configurare:

   • Quando ti viene chiesto di accedere, accetta e poi accedi al tuo Account Google nel browser. Fai clic su Consenti per concedere l'autorizzazione di accesso alle risorse.

   • Seleziona un progetto dall'elenco di progetti per i quali disponi delle autorizzazioni Proprietario, Editor o Visualizzatore. Se hai un solo progetto, gcloud init lo seleziona automaticamente.

     Se hai più di 200 progetti, ti viene chiesto di inserire un ID progetto, creare un progetto o elencare i progetti. Se scegli di creare un progetto, devi anche abilitare la fatturazione.

   • Se hai abilitato l'API Compute Engine, seleziona una zona Compute Engine predefinita.

3. (Facoltativo) Per un'esperienza migliore con lo screen reader, attiva la proprietà accessibility/screen_reader con il seguente comando:

   gcloud config set accessibility/screen_reader true
   

   Per saperne di più, consulta la guida Attivare le funzionalità di accessibilità.

Esegui i comandi principali

Esegui i comandi principali per visualizzare le informazioni sull'installazione di gcloud CLI:

1. Elenca gli account le cui credenziali sono archiviate nel sistema locale:

   gcloud auth list
   

   gcloud CLI mostra un elenco di account con credenziali:

   Credentialed Accounts
   ACTIVE             ACCOUNT
   *                  principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
   

2. Elenca le proprietà della configurazione dell'interfaccia a riga di comando gcloud attiva:

   gcloud config list
   

   gcloud CLI mostra l'elenco delle proprietà:

   [core]
   account = principal://iam.googleapis.com/locations/global/workforcePools/my-pool/subject/my-user@example.com
   disable_usage_reporting = False
   project = my-project
   

3. Visualizza informazioni sui comandi gcloud e altri argomenti:

   gcloud help
   

   Ad esempio, per visualizzare la guida per gcloud compute instances create:

   gcloud help compute instances create
   

   gcloud CLI mostra un argomento della guida che contiene una descrizione del comando, un elenco di flag e argomenti del comando ed esempi di come utilizzare il comando.

(Facoltativo) Installa i componenti aggiuntivi

Per installare componenti aggiuntivi, come gli emulatori App Engine, kubectl o i comandi gcloud CLI a livello di release alpha o beta, consulta Gestione dei componenti gcloud CLI.

Esegui la pulizia

Per evitare che al tuo account Cloud de Confiance vengano addebitati costi relativi alle risorse utilizzate in questa pagina, segui questi passaggi.

Passaggi successivi

• Leggi la guida di gcloud CLI per una panoramica dell'interfaccia a riga di comando gcloud, inclusa una rapida introduzione ai concetti chiave, alle convenzioni dei comandi e ai suggerimenti utili.
• Consulta la guida di riferimento di gcloud CLI per pagine dettagliate su ogni comando gcloud CLI, incluse descrizioni, flag ed esempi, che puoi utilizzare per eseguire una serie di attività su Cloud de Confiance.
• Consulta la scheda di riferimento di gcloud CLI per un elenco di comandi di uso comune e concetti chiave.