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 è di proprietà 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 a singolo utente e sessione. L'istanza persiste mentre la sessione di Cloud Shell è attiva; dopo un'ora di inattività, la sessione viene terminata e la relativa VM viene scartata. Per ulteriori informazioni sulle quote di utilizzo, consulta la guida alle limitazioni.

Con l'esperienza Cloud Shell predefinita, ti viene allocata con una VM temporanea e preconfigurata e l'ambiente con cui lavori è un container Docker in esecuzione su quella VM. Puoi inoltre personalizzare l'ambiente automaticamente all'avvio della 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. Lo spazio di archiviazione viene calcolato in base all'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 i software installati, gli script e i file di configurazione degli utenti come .bashrc e .vimrc, vengono mantenuti tra una sessione e l'altra. La tua directory $HOME è privata e non è accessibile agli altri utenti.

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

Cloud Shell offre anche la modalità temporanea, ovvero 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 richiede l'autorizzazione. Fai clic su Autorizza per consentire allo strumento di utilizzare le tue credenziali per effettuare chiamate.

Per ulteriori dettagli, consulta la pagina relativa all'autorizzazione con Cloud Shell.

Variabili di ambiente preconfigurate

All'avvio di Cloud Shell, il progetto attivo nella console Google Cloud viene propagato alla configurazione gcloud all'interno di Cloud Shell per 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 sceglie la regione più vicina, Cloud Shell tenta di eseguire la migrazione della tua VM di Cloud Shell a una regione più vicina quando la VM di Cloud Shell non è in uso.

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

curl metadata/computeMetadata/v1/instance/zone

Implementazione dell'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 altre utilità.

Utente root

Quando imposti una sessione di Cloud Shell, ottieni un normale account utente Unix con un nome utente basato sul tuo indirizzo email. Con questo accesso, disponi di privilegi root completi sulla VM allocata e puoi anche eseguire 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 buffa
sh
Utilità Linux Utilità di sistema Debian standard
Gcloud CLI e strumenti SDK App Engine
Google Cloud CLI che include gcloud CLI
gsutil per Cloud Storage
Editor di testo Emacs
Vim
Nano
Strumenti per creare e pacchettizzare 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:

linguaggio 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 a 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 la home directory di Cloud Shell allo stato pulito, puoi reimpostare la VM Cloud Shell.