Installa Google Cloud CLI

Prima di seguire le istruzioni riportate in questa guida, leggi Configura Google Cloud CLI per Cloud de Confiance.

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

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.

Installa gcloud CLI versione 591.0.0

Linux
  1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python dalla versione 3.10 alla 3.15. I pacchetti Linux x86_64 e Arm includono un interprete Python integrato che verrà preferito per impostazione predefinita. Per informazioni su come scegliere e configurare l'interprete Python, consulta la documentazione di 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 94,4 MB 8b8c1be16284f7072359de05d31fe5ce52b6052fb295404a62a54b7d03ec4326
    Linux a 64 bit

    (Arm)

    		 google-cloud-cli-linux-arm.tar.gz 90,4 MB c134c741f7232131e2556d77991bc8eaeb70054cfad426e06c533b3586ab69e6
    Linux a 32 bit

    (x86)

    		 google-cloud-cli-linux-x86.tar.gz 54,4 MB de8c17292832482c411cbfa0fe203b89cb4679325530e24aedfcc77898160efe

    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

    Consulta la tabella precedente e sostituisci google-cloud-cli-linux-x86_64.tar.gz con il nome del pacchetto *.tar.gz applicabile 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, quindi estrai l'archivio nella stessa posizione.
  4. Esegui lo script di installazione dalla directory principale 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.
    • Abilita 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 per applicare le modifiche.
macOS
  1. Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python dalla versione 3.10 alla 3.15.

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

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

    Per saperne di più sulla configurazione dell'interprete Python, consulta la documentazione di 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 54,6 MB c2381ccfdeb7ed1c0a7186a8d030c317375092232d8135331d826eece6bc48f5
    macOS a 64 bit

    (ARM64, Apple silicon)

    		 google-cloud-cli-darwin-arm.tar.gz 54,5 MB 3b7bbaaf2dd0287fab5320359fb61c678cbd6e8d6d58b884470def1bf96589a1
    macOS a 32 bit

    (x86)

    		 google-cloud-cli-darwin-x86.tar.gz 52,9 MB a0a2214f423215221801fad85210e853cdf737fec576eeaab8ea2e83fe2a1497

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

    curl -O https://storage.s3nsapis.fr/cloud-sdk-release/FILE_NAME
  3. Estrai i contenuti del file nella posizione che preferisci nel file system. Una pratica 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, quindi estrai l'archivio nella stessa posizione.

  4. Esegui lo script di installazione dalla directory principale 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.14 e i moduli consigliati.
    • Aggiungi gcloud CLI a PATH e abilita 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 per applicare le modifiche.
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 i tracker di stato anziché gli spinner Unicode, visualizzi l'avanzamento come percentuale e appiattisca le tabelle. Per ulteriori informazioni, consulta la guida alle funzioni di accessibilità.
    • Google Cloud CLI richiede Python; le versioni supportate sono Python dalla 3.10 alla 3.15. Per impostazione predefinita, la versione per Windows di Google Cloud CLI è integrata 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. Sebbene Google Cloud CLI installi e gestisca Python 3 per impostazione predefinita, se necessario puoi utilizzare un'installazione Python esistente deselezionando l'opzione per l'installazione di Python in bundle. Consulta gcloud topic startup per scoprire come utilizzare un'installazione Python esistente.

  3. Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie nel menu Start e collegamenti sul desktop e di avviare la shell di 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 abilitare 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 saperne di più, 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 eseguire l'autorizzazione dalla riga di comando, aggiungi il flag --console-only. Per l'autorizzazione non interattiva, crea un service account con gli ambiti appropriati nella consoleCloud de Confiance , 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 accedi al tuo Account Google nel browser. Fai clic su Consenti per concedere l'autorizzazione ad accedere alle risorse.

    • Dall'elenco dei progetti per i quali disponi delle autorizzazioni Proprietario, Editor o Visualizzatore, seleziona un progetto. Se hai un solo progetto, gcloud init lo seleziona per te.

      Se hai più di 200 progetti, ti verrà 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 di screen reader migliorata, attiva la proprietà accessibility/screen_reader con il seguente comando:

    gcloud config set accessibility/screen_reader true

    Per saperne di più, consulta la guida Attivazione delle funzioni 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 visualizza 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 visualizza 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 le informazioni sui comandi gcloud e altri argomenti:

    gcloud help

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

    gcloud help compute instances create

    gcloud CLI visualizza 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.

Passaggi successivi

  • Leggi la guida di gcloud CLI per una panoramica di gcloud CLI, inclusa una rapida introduzione ai concetti chiave, alle convenzioni dei comandi e ai suggerimenti utili.
  • Leggi 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.