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 e gestita da Google Cloud, quindi non verrà visualizzata in nessuno dei tuoi Google Cloud progetti.
Le istanze di Cloud Shell vengono sottoposte a provisioning in base al singolo utente e alla singola 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 ulteriori informazioni sulle quote di utilizzo, consulta la guida alle limitazioni.
Con l'esperienza predefinita di Cloud Shell, ti viene assegnata una VM temporanea 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 l'istanza di 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 senza costi
montato come
directory $HOME nell'istanza della macchina virtuale. Questo spazio di archiviazione è basato sul 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 i software installati, 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.
Quando utilizzi Cloud Shell, non puoi espandere lo spazio di archiviazione su 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 di 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 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 (come 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 per
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 un utilizzo immediato. GOOGLE_CLOUD_PROJECT, la
variabile di ambiente utilizzata dalla libreria di supporto 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 punta al nome host della 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 a Cloud Shell per la prima volta, 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 il seguente comando da una sessione di Cloud Shell:
curl metadata/computeMetadata/v1/instance/zone
Implementazione delle immagini
L'immagine container di Cloud Shell viene aggiornata settimanalmente per mantenere aggiornati gli strumenti preinstallati. Ciò significa che Cloud Shell include sempre le versioni più recenti di gcloud CLI, Docker e altre utilità.
Utente root
Quando configuri una sessione di Cloud Shell, ottieni un account utente Unix normale con un nome utente basato sul tuo indirizzo email. Con questo accesso, hai i privilegi root completi sulla VM allocata e puoi persino eseguire i comandi sudo, se necessario.
Strumenti disponibili
L'istanza della 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 | Google Cloud CLI, inclusa gcloud CLI |
| Editor di testo |
Emacs Vim Nano |
| Strumenti di creazione e pacchettizzazione |
Gradle Helm Make Maven Bazel npm nvm pip uv Composer |
| Strumenti di controllo del codice sorgente |
Git Mercurial |
| Strumenti aggiuntivi |
Docker iPython Client MySQL Compilatore gRPC TensorFlow |
Puoi installare pacchetti software aggiuntivi nell'istanza della macchina virtuale
ma l'installazione non verrà mantenuta dopo l'arresto dell'istanza, a meno che tu non
installi il software nella directory $HOME o crei un
ambiente personalizzato.
Supporto dei linguaggi
L'istanza della macchina virtuale Cloud Shell fornisce il supporto linguistico 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 è la 17. Per modificare la sessione di 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 passare alla versione 21:
sudo update-java-alternatives -s java-1.21.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64
Per tornare alla versione 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 di 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 e infine su Riavvia.
Per eliminare definitivamente tutti i file nella home directory e ripristinare la home directory di Cloud Shell a uno stato pulito, puoi reimpostare la VM Cloud Shell.