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à di Google Cloude viene gestita da questa organizzazione, pertanto non verrà visualizzata in nessuno dei tuoi progetti Google Cloud .
Le istanze Cloud Shell vengono sottoposte a provisioning in base a utente e sessione. L'istanza persiste mentre la sessione di Cloud Shell è attiva; dopo un'ora di inattività, la sessione termina e la relativa VM viene eliminata. Per saperne di più sulle quote di utilizzo, consulta la guida ai limiti.
Con l'esperienza Cloud Shell predefinita, ti viene allocata una VM effimera preconfigurata e l'ambiente con cui lavori è un container Docker in esecuzione su quella VM. Puoi anche personalizzare automaticamente l'ambiente all'avvio della VM per assicurarti che la tua 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 directory $HOME nell'istanza di macchina virtuale. Questo spazio di archiviazione è per 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 software installato, script e 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.
Quando utilizzi Cloud Shell, non puoi espandere lo spazio di archiviazione del 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, che è 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 vengono persi al termine della sessione.
Autorizzazione
Quando effettui una chiamata all'API Google Cloud o utilizzi uno strumento a riga di comando che richiede le credenziali (come la 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 ulteriori dettagli, consulta la sezione Autorizzazione con Cloud Shell.
Variabili di ambiente preconfigurate
Quando viene avviato Cloud Shell, il progetto attivo nella console viene propagato alla configurazione di gcloud all'interno di Cloud Shell per l'utilizzo immediato. Google Cloud GOOGLE_CLOUD_PROJECT, la
variabile di ambiente utilizzata dal supporto della libreria delle Credenziali predefinite dell'applicazione
per definire l'ID progetto, è impostata anche in modo da puntare al progetto attivo nella
console Google Cloud . La variabile di ambiente WEB_HOST punta al
nome host della tua VM Cloud Shell, che puoi utilizzare per effettuare richieste HTTPS
all'ambiente.
Selezione delle zone
Cloud Shell è distribuito a livello globale in più Google Cloud regioni. 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 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 aggiornati gli strumenti preconfigurati. Ciò significa che Cloud Shell include sempre le versioni più recenti di gcloud CLI, Docker e altre utilità.
Utente root
Quando configuri una sessione Cloud Shell, ottieni un account utente Unix normale con un nome utente basato sul tuo indirizzo email. Con questo accesso, hai privilegi root completi sulla VM allocata e puoi anche eseguire comandi sudo, se necessario.
Strumenti disponibili
L'istanza di macchina virtuale Cloud Shell ha i seguenti strumenti preinstallati:
| Tipo | Strumento |
|---|---|
| Interpreti della 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 creazione 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 sull'istanza di macchina virtuale,
ma l'installazione non verrà mantenuta dopo la terminazione dell'istanza, a meno che tu non
installi il software nella directory $HOME o crei un
ambiente personalizzato.
Supporto dei linguaggi
L'istanza di macchina virtuale Cloud Shell fornisce il supporto linguistico preinstallato per quanto segue:
| 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 il seguente comando 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 passare a 21:
sudo update-java-alternatives -s java-1.21.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-21-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 poter risolvere eventuali problemi nei file.
Per aprire Cloud Shell in modalità provvisoria:
- Aggiungi
cloudshellsafemode=trueall'URL. - In Cloud Shell, fai clic su , fai clic su Modalità provvisoria, quindi fai clic su Riavvia.
Per eliminare definitivamente tutti i file nella tua home directory e ripristinare la home directory di Cloud Shell a uno stato pulito, puoi reimpostare la VM Cloud Shell.