Alcune o tutte le informazioni in questa pagina potrebbero non essere applicabili a Trusted Cloud by S3NS.

Questa pagina è stata tradotta dall'API Cloud Translation.

Installa l'interfaccia a riga di comando gcloud

Questa pagina contiene istruzioni per scegliere e gestire un'installazione di Google Cloud CLI. Google Cloud CLI include gli strumenti a riga di comando gcloud, gsutil e bq. Per un elenco delle funzionalità di gcloud CLI, vedi Tutte le funzionalità.

Per accedere alle API Google Cloud utilizzando un linguaggio di programmazione supportato, puoi scaricare le librerie client di Cloud.

Prima di seguire le istruzioni di questa guida, leggi Configurare Google Cloud CLI per Trusted Cloud.

Istruzioni di installazione

Queste istruzioni riguardano l'installazione di Google Cloud CLI. Per informazioni sull'installazione di componenti aggiuntivi, come i comandi gcloud CLI a livello di rilascio alpha o beta, consulta Gestione dei componenti gcloud CLI.

Linux

Verifica di avere una versione supportata di Python. Google Cloud CLI richiede Python 3.9-3.13. Tieni presente che 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, vedi gcloud topic startup.

Scarica uno dei seguenti elementi:

Nota: per determinare la tua piattaforma Linux, esegui uname -a nella riga di comando.

Piattaforma	Nome pacchetto	Dimensioni	Checksum SHA256
Linux a 64 bit (x86_64)	google-cloud-cli-linux-x86_64.tar.gz	149,7 MB	1ec7d351de14277c00c430f9fb939255c4b63940417da2f24ff6413a9e221c2f
Linux a 64 bit (Arm)	google-cloud-cli-linux-arm.tar.gz	56,3 MB	e6153461e3154ebce61d35b73005bdd14a0ecacd42e5008f66e25b4ad231e5c9
Linux a 32 bit (x86)	google-cloud-cli-linux-x86.tar.gz	56,3 MB	09690f1b126ccc8e777c4a1ef2c0b74a08103d89329b03856d688071baa9fc07

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 riportata sopra 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 (preferibilmente nella home directory), esegui questo comando:
```
tar -xf google-cloud-cli-linux-x86_64.tar.gz
```
(Facoltativo) Per sostituire un'installazione esistente, rimuovi la directory google-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.
(Facoltativo) Aggiungi gcloud CLI al tuo PATH. Puoi anche attivare il completamento dei comandi per la shell e la raccolta delle statistiche di utilizzo. Esegui lo script di installazione (dalla radice della cartella che hai estratto nell'ultimo passaggio) utilizzando questo comando:
```
./google-cloud-sdk/install.sh
```
Questa operazione può essere eseguita anche 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
```
- Per inviare statistiche sull'utilizzo anonime per contribuire a migliorare gcloud CLI, rispondi Y quando ti viene richiesto.
- Per aggiungere gcloud CLI a PATH e attivare il completamento dei comandi, rispondi Y quando ti viene chiesto.
Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate.
Per inizializzare gcloud CLI, esegui gcloud init:

./google-cloud-sdk/bin/gcloud init

(Facoltativo) Installa componenti aggiuntivi utilizzando il gestore di componenti.

macOS

Verifica di avere una versione supportata di Python:
- Per controllare la versione attuale di Python, esegui python3 -V o python -V. Le versioni supportate sono Python 3.9-3.13.
- Lo script di installazione principale offre l'installazione di Python 3.12 di CPython.
  - Per installare Python sono necessari gli strumenti a riga di comando Xcode.
  - Verifica che Xcode Command Line Tools sia installato eseguendo: xcode-select -p.
  - Se Xcode Command Line Tools non è installato, installalo eseguendo: sudo xcode-select --install.
- In caso contrario, per installare una versione di Python supportata, visita la pagina Python Releases for macOS su Python.org.
- Se sulla tua macchina sono installati più interpreti Python, imposta la variabile di ambiente CLOUDSDK_PYTHON all'interno della shell in modo che punti al percorso dell'interprete che preferisci.
- Per ulteriori informazioni su come scegliere e configurare l'interprete Python, consulta gcloud topic startup.
Scarica uno dei seguenti elementi:
Nota: per determinare il nome dell'hardware della macchina, esegui uname -m da una riga di comando.

Piattaforma	Pacchetto	Dimensioni	Checksum SHA256
macOS a 64 bit (x86_64)	google-cloud-cli-darwin-x86_64.tar.gz	56,4 MB	0c0101a65f3473a5db6a2ebc1867c3294cdbd88fef34da91050869f76149a822
macOS a 64 bit (ARM64, Apple silicon)	google-cloud-cli-darwin-arm.tar.gz	56,4 MB	80cfba6da278d0ce8a8a0625bec9648ea5a39ea42daf2536068f19edb175dc70
macOS a 32 bit (x86)	google-cloud-cli-darwin-x86.tar.gz	54,9 MB	53c23a16a66a2d38966fc7080cd2e29afe1d5c85b1c52985c19f7fd2c09f995a

Estrai l'archivio in una posizione qualsiasi del file system (preferibilmente nella directory Home). Su macOS, puoi farlo aprendo il file .tar.gz archivio scaricato nella posizione che preferisci. In alternativa, esegui questo comando:
```
tar -xf google-cloud-cli-darwin-arm.tar.gz
```
(Facoltativo) Per sostituire un'installazione esistente, rimuovi la directory google-cloud-sdk esistente ed estrai l'archivio nella stessa posizione.
Esegui lo script di installazione (dalla radice della cartella estratta nell'ultimo passaggio) utilizzando il seguente comando:
```
./google-cloud-sdk/install.sh
```
Lo script ti chiederà di installare Python 3.12 e alcuni moduli consigliati.
L'installazione può essere eseguita anche in modo non interattivo (ad esempio, utilizzando uno script) fornendo le preferenze come flag. Per descrivere i flag disponibili, esegui:
```
./google-cloud-sdk/install.sh --help
```
Per eseguire lo script di installazione con la modalità screen reader attiva:
```
./google-cloud-sdk/install.sh --screen-reader=true
```
(Facoltativo)
- Per inviare statistiche sull'utilizzo anonime per contribuire a migliorare gcloud CLI, rispondi Y quando ti viene richiesto.
- Per aggiungere gcloud CLI a PATH e attivare il completamento dei comandi, rispondi Y quando ti viene chiesto.
Se hai aggiornato PATH nel passaggio precedente, apri un nuovo terminale in modo che le modifiche vengano applicate.
Per inizializzare gcloud CLI, esegui gcloud init:

./google-cloud-sdk/bin/gcloud init

Facoltativo. Installa componenti aggiuntivi utilizzando il gestore di componenti.

Windows

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

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.13. 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 di Python esistente, se necessario, deselezionando l'opzione Installa Python in bundle. Consulta gcloud topic startup per scoprire come utilizzare un'installazione di Python esistente.
Al termine dell'installazione, il programma di installazione ti offre la possibilità di creare scorciatoie nel menu Start e sul desktop, avviare la shell 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 App Engine necessarie per il deployment di un'applicazione utilizzando i comandi gcloud. Questi componenti possono essere installati utilizzando il gestore di componenti 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.

Altre opzioni di installazione

A seconda delle tue esigenze di sviluppo, anziché l'installazione consigliata, puoi utilizzare un metodo alternativo per installare gcloud CLI:

Utilizzi gcloud CLI con script o integrazione/deployment continui? Scarica un archivio con controllo delle versioni per un'installazione non interattiva di una versione specifica di gcloud CLI.
Utilizzi Ubuntu e preferisci gli aggiornamenti automatici? Utilizza un pacchetto snap per installare gcloud CLI.
Per le installazioni interattive di Windows e macOS e per tutti gli altri casi d'uso, esegui il programma di installazione interattivo per installare l'ultima release di gcloud CLI.

Gestire un'installazione

Dopo aver installato gcloud CLI, puoi utilizzare i comandi nel gruppo di comandi gcloud components per gestire l'installazione. Ciò include la visualizzazione dei componenti installati, l'aggiunta e la rimozione di componenti e l'upgrade a una nuova versione o il downgrade a una versione specifica dellgcloud CLIoud.

Versioni precedenti di gcloud CLI

Se hai bisogno di una versione diversa di gcloud CLI, installa la versione attuale seguendo le istruzioni riportate in precedenza in questa pagina e poi accedi. Una volta eseguito l'accesso, puoi scaricare le versioni precedenti. Per visualizzare le versioni ordinate per data, assicurati di attivare Ordina e filtra e fai clic sulla colonna Creato.

Versioni di Python supportate

Google Cloud CLI richiede Python 3.9-3.13. Per informazioni su come scegliere e configurare l'interprete Python, vedi gcloud topic startup.