In questa pagina vengono descritti i modi in cui puoi configurare Cloud Shell personalizzare la tua esperienza.
File di configurazione nella home directory di Cloud Shell
Cloud Shell esegue il provisioning di 5 GB di spazio
di archiviazione su disco permanente montata
nella directory $HOME
. 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.
Poiché il valore .bashrc
persiste tra una sessione e l'altra, è un ottimo modo per personalizzare
il comportamento di Cloud Shell. Analogamente, per far sì che le tue installazioni
puoi installare pacchetti nella home directory.
Variabili di ambiente preconfigurate
All'avvio di Cloud Shell, il progetto attivo
Cloud Shell viene propagato alla configurazione gcloud
all'interno
per un uso immediato di Cloud Shell. GOOGLE_CLOUD_PROJECT
, la variabile di ambiente utilizzata dal supporto della libreria Credenziali predefinite dell'applicazione per definire l'ID progetto, è impostata anche per puntare al progetto attivo in Cloud Shell.
La variabile di ambiente CLOUD_SHELL
è impostata su true
. Questa variabile può essere controllata dalle applicazioni per determinare se un'applicazione è in esecuzione in Cloud Shell.
Preferenze dell'interfaccia a riga di comando gcloud
Quando utilizzi Cloud Shell, le preferenze della CLI gcloud vengono memorizzate in una cartella temporanea tmp
, impostate solo per la scheda corrente e non rimangono attive nelle sessioni successive.
Per fare in modo che le configurazioni di gcloud CLI rimangano invariate, puoi impostarle utilizzando uno dei seguenti metodi:
Per mantenere la configurazione della gcloud CLI personalizzabile per ogni scheda, personalizzare la configurazione predefinita, puoi aggiungere
gcloud
di configurazione (comegcloud config set compute/region us-central1
per impostare una regione predefinita) su alla fine del tuo file$HOME/.bashrc
.In questo modo, ogni nuova scheda eredita il progetto della console Google Cloud e la configurazione predefinita personalizzata, ma ti consente anche di personalizzare ulteriormente la configurazione di ogni scheda.
Per utilizzare sempre la stessa configurazione dell'interfaccia a riga di comando gcloud, aggiungi
export CLOUDSDK_CONFIG=$HOME/.config/gcloud
alla fine del file .bashrc e poi eseguigcloud config configurations create CONFIG_NAME
per creare la configurazione che vuoi utilizzare.
Proprietà comuni
Per impostare il progetto su cui vuoi lavorare, esegui:
gcloud config set project [PROJECT_NAME]
Il prompt dei comandi si aggiorna in base al progetto attualmente attivo, rispettando questo formato: [USERNAME]@cloudshell:~ ([PROJECT_NAME])$
Per selezionare la regione che preferisci, esegui:
gcloud config set compute/region us-east1
I comandi precedenti sono esempi di configurazioni gcloud CLI che può impostare; per un elenco completo e maggiori dettagli sulle proprietà di impostazione, consulta alla guida alle proprietà dell'interfaccia a riga di comando gcloud.
Personalizzazione dell'ambiente
La personalizzazione dell'ambiente consente di installare pacchetti aggiuntivi dell'ambiente Cloud Shell all'avvio.
Script di personalizzazione dell'ambiente
Cloud Shell esegue automaticamente lo script,
$HOME/.customize_environment
, all'avvio della tua istanza. A differenza di .profile
o .bashrc
, questo script viene eseguito una volta all'avvio di Cloud Shell
(anziché una volta per ogni accesso alla shell).
Questo script viene eseguito come root e ti consente di installare tutti i pacchetti che desideri in ogni sessione di Cloud Shell utilizzando la gestione di pacchetti Debian tramite comandi SQL.
Ad esempio, se vuoi installare erlang su Cloud Shell, il tuo file .customize_environment
avrà il seguente aspetto:
#!/bin/sh
apt-get update
apt-get -y install erlang
Puoi trovare i log di esecuzione del tuo script .customize_environment
alle ore /var/log/customize_environment
. .customize_environment
lo script viene eseguito in background e, al termine dell'esecuzione, toccherà
/google/devshell/customize_environment_done
. Poiché l'installazione dei pacchetti avviene in parallelo con l'accesso, i pacchetti installati potrebbero diventare disponibili alcuni istanti dopo aver raggiunto la richiesta di accesso.
Apri Cloud Shell con un account utente specificato
Il parametro authuser
consente di specificare un account utente da utilizzare con Cloud Shell. Devi aver effettuato l'accesso con l'account utente specificato.
Se non hai eseguito l'accesso all'account specificato, Cloud Shell si apre con l'account predefinito a cui hai eseguito l'accesso. Ad esempio, puoi aprire
Cloud Shell ha eseguito l'accesso come client1@example.com
utilizzando l'URL
shell.cloud.google.com?authuser=client1@example.com
.
Personalizzazione dell'immagine container
La personalizzazione delle immagini dei container ti consente di creare un'immagine Docker che funge da ambiente Cloud Shell personalizzato con i pacchetti aggiuntivi e le configurazioni personalizzate specificati. L'immagine Docker deve essere basata sull'immagine Cloud Shell di base e ospitata in Container Registry.
Per informazioni dettagliate su come creare un'immagine contenitore personalizzata, consulta la guida alla personalizzazione delle immagini contenitore.
A differenza della personalizzazione dell'ambiente, la personalizzazione dell'immagine container non influisce l'esperienza Cloud Shell predefinita. Puoi utilizzare e condividere la tua immagine personalizzata con i link Apri in Cloud Shell.
assistenza tmux
Cloud Shell utilizza tmux
, che consente di migliorare
la persistenza tra le sessioni della scheda del browser. Ad esempio, se aggiorni la console Google Cloud in una scheda o ti connetti a Cloud Shell da un altro computer, lo stato della sessione non andrà perso.
Cloud Shell supporta le associazioni di tasti predefinite
tmux
. Per
ad esempio, se premi Ctrl+b e poi %, tmux
divide il valore attuale
finestra di sessione nei riquadri sinistro e destro, che può essere utile per il debug.
Statistiche sull'utilizzo
Cloud Shell raccoglie statistiche di utilizzo anonime sui comandi eseguiti all'interno del terminale Cloud Shell. Le statistiche vengono raccolte solo sui comandi preinstallati in Cloud Shell. Queste metriche non possono essere collegate al tuo account.
Le metriche non vengono raccolte su informazioni che consentono l'identificazione personale, come gli argomenti passati a questi comandi.
Per modificare le preferenze di raccolta delle metriche in qualsiasi momento, seleziona Statistiche sull'utilizzo del terminale nel menu Impostazioni . Qualsiasi modifica delle preferenze nel menu Impostazioni viene applicata alla sessione successiva. Per attivare o disattivare la raccolta delle metriche, chiudi la scheda e apri in un'altra scheda dopo avere apportato la modifica.
Nota: questo è distinto dalle statistiche di utilizzo di gcloud, che sono attivate per impostazione predefinita in Cloud Shell.
Per disabilitare la raccolta delle metriche di gcloud CLI, esegui questo comando nella sessione di Cloud Shell:
gcloud config set disable_usage_reporting true