Come funziona Cloud Shell

Cloud Shell esegue il provisioning di una macchina virtuale Compute Engine che esegue un sistema operativo Linux basato su Debian per il tuo utilizzo temporaneo. Questa macchina virtuale è di proprietà e gestita da Google Cloud, pertanto non verrà visualizzata in nessuno dei tuoi progetti Google Cloud.

Nota: è la tua organizzazione a stabilire se hai accesso a Cloud Shell.

Il provisioning delle istanze Cloud Shell viene eseguito su base per utente e per sessione. L'istanza persiste mentre la sessione Cloud Shell è attiva. Dopo un'ora di inattività, la sessione viene interrotta e la VM viene eliminata. Per saperne di più sulle quote di utilizzo, consulta la guida alle limitazioni.

Con l'esperienza Cloud Shell predefinita, ti viene allocata una VM preconfigurata ed effimera e l'ambiente di lavoro è un container Docker in esecuzione su quella VM. Puoi anche personalizzare il tuo ambiente automaticamente all'avvio della VM per assicurarti che l'istanza Cloud Shell includa gli strumenti che preferisci.

Archiviazione su disco permanente

Cloud Shell esegue il provisioning di 5 GB di spazio di archiviazione su disco permanente gratuito montato come la tua directory $HOME nell'istanza della macchina virtuale. Questo spazio di archiviazione è basato su ciascun utente ed è disponibile in tutti i progetti. A differenza dell'istanza stessa, lo spazio di archiviazione non scade in caso di inattività. Tutti i file archiviati nella home directory, inclusi il software installato, gli script e i file di configurazione utente come .bashrc e .vimrc, persistono da una sessione all'altra. La directory $HOME è riservata esclusivamente a te e non è accessibile da altri utenti.

Avviso: se elimini la directory $HOME o se non accedi a Cloud Shell per 120 giorni, Cloud Shell elimina automaticamente la directory $HOME e non può recuperare i tuoi file. Riceverai una notifica via email prima che ciò accada. L'avvio di una sessione Cloud Shell impedisce il riciclo dello spazio di archiviazione permanente della directory $HOME.

Quando utilizzi Cloud Shell, non puoi espandere lo spazio di archiviazione dei disco permanente. Per un maggiore controllo della persistenza dello spazio di archiviazione e per avere più spazio di archiviazione, puoi utilizzare Cloud Workstations.

Cloud Shell offre anche la modalità temporanea, ovvero l'esperienza Cloud Shell senza spazio di archiviazione su disco permanente. Con la modalità temporanea, i tempi di avvio sono più rapidi, ma tutti i file creati nella sessione andranno persi alla fine della sessione.

Autorizzazione

Quando effettui una chiamata all'API Google Cloud o utilizzi uno strumento a riga di comando che richiede le credenziali (ad esempio Google Cloud CLI) con Cloud Shell per la prima volta, Cloud Shell ti chiede di autorizzare. Fai clic su Autorizza per consentire allo strumento di utilizzare le tue credenziali per effettuare chiamate.

Per maggiori dettagli, consulta la sezione Autorizzazione con Cloud Shell.

Variabili di ambiente preconfigurate

Quando viene avviato Cloud Shell, il progetto attivo nella console Google Cloud viene propagato alla configurazione di gcloud all'interno di Cloud Shell per un utilizzo immediato. GOOGLE_CLOUD_PROJECT, la variabile di ambiente utilizzata dal supporto della libreria delle Credenziali predefinite dell'applicazione per definire l'ID progetto, è impostata anche per puntare al progetto attivo nella console Google Cloud. La variabile di ambiente WEB_HOST fa riferimento al nome host della VM Cloud Shell che puoi utilizzare per effettuare richieste HTTPS all'ambiente.

Nota: anche se GOOGLE_CLOUD_PROJECT eredita il progetto attivo dalla console Google Cloud, l'istanza Cloud Shell non è direttamente associata o gestita da questo progetto.

Selezione della zona

Cloud Shell è distribuito a livello globale in più regioni Google Cloud. Quando ti connetti per la prima volta a Cloud Shell, ti viene assegnata automaticamente la regione disponibile più vicina. Non puoi scegliere la tua regione e, se Cloud Shell non sceglie la regione più vicina, tenta di eseguire la migrazione della VM Cloud Shell a una regione più vicina quando la VM Cloud Shell non è in uso.

Per visualizzare la regione corrente, esegui il seguente comando da una sessione Cloud Shell:

curl metadata/computeMetadata/v1/instance/zone

Implementazione delle immagini

L'immagine del contenitore Cloud Shell viene aggiornata settimanalmente per mantenere aggiornati gli strumenti precompilati. Ciò significa che Cloud Shell è sempre fornito con le versioni più recenti di gcloud CLI, Docker e altre utilità.

Utente root

Quando configuri una sessione Cloud Shell, ottieni un normale account utente Unix con un nome utente basato sul tuo indirizzo email. Con questo accesso, hai privilegi root completi sulla VM allocata e puoi persino eseguire comandi sudo se necessario.

Strumenti disponibili

L'istanza della macchina virtuale Cloud Shell ha i seguenti strumenti preinstallati:

Tipo	Strumento
Interpreti di shell Linux	bash sh
Utilità Linux	Utilità di sistema Debian standard
Gcloud CLI e strumenti	App Engine SDK Google Cloud CLI, inclusa gcloud CLI gsutil per Cloud Storage
Editor di testo	Emacs Vim Nano
Strumenti di compilazione e pacchettizzazione	Gradle Helm Make Maven Bazel npm nvm pip Composer
Strumenti di controllo del codice sorgente	Git Mercurial
Strumenti aggiuntivi	Docker iPython Client MySQL Compilatore gRPC TensorFlow Terraform

Puoi installare pacchetti software aggiuntivi nell'istanza della macchina virtuale, ma l'installazione non verrà mantenuta dopo la terminazione dell'istanza, a meno che non installi il software nella directory $HOME o crei un ambiente personalizzato.

Supporto dei linguaggi

Nota: le versioni in lingua potrebbero cambiare. Tuttavia, se necessario, puoi installare versioni diverse utilizzando lo script di personalizzazione dell'ambiente.

L'istanza della macchina virtuale Cloud Shell fornisce il supporto preinstallato per i seguenti linguaggi:

Lingua	Versione
Java	JRE/JDK 17 (OpenJDK)
Vai	Più recenti
Python	3,12
Node.js	LTS
Ruby	3.2
PHP	8,3
.NET Core	SDK 6.0, 7.0 e 8.0

La versione predefinita dell'ambiente Java è 17. Per modificare la sessione Cloud Shell corrente in modo che utilizzi la versione 1.11 di JRE e JDK, inserisci quanto segue al prompt dei comandi di Cloud Shell:

sudo update-java-alternatives -s java-1.11.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64

Per tornare a 17:

sudo update-java-alternatives -s java-1.17.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/jre

Modalità provvisoria

Se si verifica un problema nei file .bashrc o .tmux.conf, Cloud Shell si chiude immediatamente dopo la connessione. La modalità provvisoria riavvia l'istanza Cloud Shell e ti consente di accedere come utente root, in modo da risolvere eventuali problemi nei file.

Per aprire Cloud Shell in modalità provvisoria:

• Aggiungi cloudshellsafemode=true all'URL.
• In Cloud Shell, fai clic su , poi su Modalità provvisoria e infine su Riavvia.

Per eliminare definitivamente tutti i file nella home directory e ripristinare la home directory di Cloud Shell in uno stato pulito, puoi reimpostare la VM Cloud Shell.