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 uso temporaneo. Questa macchina virtuale è posseduta e gestita da Google Cloud, quindi non verrà visualizzata in nessuno dei tuoi progetti Google Cloud.

Il provisioning delle istanze di Cloud Shell viene eseguito in base al singolo utente e alla singola sessione. L'istanza persiste mentre la sessione Cloud Shell è attiva; dopo un'ora di inattività, la sessione termina e la VM viene scartata. Per ulteriori informazioni sulle quote di utilizzo, consulta la guida alle limitazioni.

Con l'esperienza Cloud Shell predefinita, ti viene assegnata una VM temporanea e preconfigurata e l'ambiente con cui lavori è un container Docker in esecuzione su quella VM. Puoi anche personalizzare automaticamente il tuo ambiente all'avvio delle VM per assicurarti che l'istanza di Cloud Shell includa i tuoi strumenti preferiti.

Archiviazione su disco permanente

Cloud Shell esegue il provisioning di 5 GB di spazio di archiviazione su disco permanente gratuito montato come directory $HOME sull'istanza della macchina virtuale. L'archiviazione viene eseguita per singolo utente ed è disponibile in tutti i progetti. A differenza dell'istanza stessa, questo 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, vengono mantenuti da una sessione all'altra. La directory $HOME è privata e non è accessibile ad altri utenti.

Per un maggiore controllo della persistenza dello spazio di archiviazione, puoi utilizzare Cloud Workstations.

Cloud Shell offre anche la modalità temporanea, ossia l'esperienza di Cloud Shell senza 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 API Google Cloud o utilizzi uno strumento a riga di comando che richiede credenziali (ad esempio Google Cloud CLI) con Cloud Shell per la prima volta, Cloud Shell ti chiede di concedere l'autorizzazione. Fai clic su Autorizza per consentire allo strumento di utilizzare le tue credenziali per effettuare chiamate.

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

Variabili di ambiente preconfigurate

All'avvio di Cloud Shell, il progetto attivo nella console Google Cloud viene propagato alla configurazione di gcloud all'interno di Cloud Shell per consentirne l'uso immediato. Anche GOOGLE_CLOUD_PROJECT, la variabile di ambiente utilizzata dal supporto della libreria delle Credenziali predefinite dell'applicazione per definire l'ID progetto, è impostata in modo da puntare al progetto attivo nella console Google Cloud. La variabile di ambiente WEB_HOST rimanda al nome host della VM Cloud Shell, che puoi utilizzare per effettuare richieste HTTPS all'ambiente.

Selezione zona

Cloud Shell è distribuito a livello globale in diverse 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 seleziona la regione più vicina, quando la VM di Cloud Shell non è in uso, prova a eseguire la migrazione della tua VM Cloud Shell a una regione più vicina.

Per visualizzare la regione attuale, esegui questo comando da una sessione di Cloud Shell:

curl metadata/computeMetadata/v1/instance/zone

Implementazione immagine

L'immagine container di Cloud Shell viene aggiornata settimanalmente per mantenere sempre aggiornati gli strumenti predefiniti. Ciò significa che Cloud Shell include sempre le versioni più recenti di gcloud CLI, Docker e di altre utilità.

Utente root

Quando configuri una sessione di 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 anche eseguire i comandi sudo, se necessario.

Strumenti disponibili

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

Tipo Strumento
Interpreti shell di Linux bah
sh
Utilità Linux Utilità di sistema Debian standard
gcloud CLI e strumenti SDK App Engine
Google Cloud CLI con gcloud CLI
gsutil per Cloud Storage
Editor di testo Emacs
Vim
Nano
Crea e pacchettizza strumenti Gradle
Helm
Crea
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 sull'istanza della macchina virtuale, ma l'installazione non verrà mantenuta al termine dell'istanza, a meno che non installi il software nella directory $HOME o crei un ambiente personalizzato.

Supporto dei linguaggi

L'istanza della macchina virtuale di Cloud Shell fornisce supporto linguistico preinstallato per quanto segue:

Lingua Versione
Java JRE/JDK 17.0.6 (OpenJDK)
Go 1.20.4
Python 3.9.2
Node.js v18.12.1
Ruby 2.7.8
PHP 7.4.33
.NET Core SDK 2.1, 3.1, 5.0 e 6.0
Runtime principali 2.1.30, 3.1.32, 5.0.17 e 6.0.16

La versione predefinita dell'ambiente Java è 11. Per modificare l'attuale sessione di Cloud Shell in modo che utilizzi la versione 1.8 di JRE e JDK, inserisci quanto segue nel prompt dei comandi di Cloud Shell:

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

Per tornare all'11:

sudo update-java-alternatives -s java-1.11.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-11-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 di Cloud Shell e ti accede come 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 lo stato originale della home directory di Cloud Shell, puoi reimpostare la VM Cloud Shell.