Questa pagina descrive i modi in cui puoi configurare Cloud Shell per 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 gratuito montato come 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
, vengono mantenuti tra una sessione e l'altra.
Poiché .bashrc
persiste da una sessione all'altra, è un ottimo modo per personalizzare
il comportamento di Cloud Shell. Allo stesso modo, per far durare
le installazioni, puoi installare pacchetti nella home directory.
Variabili di ambiente preconfigurate
All'avvio di Cloud Shell, il progetto attivo in Cloud Shell viene propagato alla configurazione di gcloud
in 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 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 gcloud CLI
Quando utilizzi Cloud Shell, le preferenze di gcloud CLI vengono archiviate in una cartella temporanea tmp
, impostate solo per la scheda attuale e non vengono mantenute da una sessione all'altra.
Per mantenere le configurazioni dell'interfaccia a riga di comando gcloud, puoi impostarle utilizzando uno dei seguenti metodi:
Per mantenere la configurazione dellgcloud CLI personalizzabile per ogni scheda, ma personalizzare la configurazione predefinita, puoi aggiungere
gcloud
comandi di configurazione (comegcloud config set compute/region us-central1
per impostare una regione predefinita) alla fine del file$HOME/.bashrc
.In questo modo, ogni nuova scheda eredita il progetto della console Google Cloud e la configurazione predefinita personalizzata, consentendoti inoltre di personalizzare ulteriormente la configurazione di ogni scheda.
Per utilizzare sempre la stessa configurazione dell'interfaccia alla gcloud CLI, aggiungi
export CLOUDSDK_CONFIG=$HOME/.config/gcloud
alla fine del file .bashrc, quindi 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 viene aggiornato in modo da riflettere il progetto attualmente attivo,
nel rispetto di questo formato: [USERNAME]@cloudshell:~ ([PROJECT_NAME])$
Per selezionare l'area geografica che preferisci, esegui:
gcloud config set compute/region us-east1
I comandi riportati sopra sono esempi di configurazioni gcloud CLI che puoi impostare. Per un elenco completo e maggiori dettagli sulle proprietà di impostazione, consulta la guida alle proprietà dell'interfaccia a riga di comando gcloud.
Personalizzazione dell'ambiente
La personalizzazione dell'ambiente consente di installare pacchetti aggiuntivi nell'ambiente Cloud Shell all'avvio.
Script di personalizzazione dell'ambiente
Cloud Shell esegue automaticamente lo script $HOME/.customize_environment
all'avvio dell'istanza. A differenza di .profile
o .bashrc
, questo script viene eseguito una sola volta all'avvio di Cloud Shell
(anziché una volta per ogni accesso alla shell).
Questo script viene eseguito come root e puoi installare tutti i pacchetti che vuoi che esistano in ogni sessione di Cloud Shell utilizzando i comandi di gestione dei pacchetti di Debian.
Ad esempio, se vuoi che erlang sia installato su Cloud Shell, il file .customize_environment
avrà il seguente aspetto:
#!/bin/sh
apt-get update
apt-get -y install erlang
I log di esecuzione dello script .customize_environment
sono disponibili alla pagina /var/log/customize_environment
. Lo script .customize_environment
viene eseguito come processo in background e, se l'esecuzione è riuscita, toccherà
/google/devshell/customize_environment_done
. Poiché l'installazione dei pacchetti viene eseguita parallelamente all'accesso, i pacchetti installati potrebbero diventare disponibili pochi istanti dopo la richiesta di accesso.
Aprire Cloud Shell con un account utente specificato
Il parametro authuser
consente di specificare un account utente da utilizzare con Cloud Shell. Devi accedere con l'account utente specificato.
Se non hai eseguito l'accesso all'account specificato, Cloud Shell si apre con l'account di accesso predefinito. Ad esempio, puoi aprire Cloud Shell dopo aver eseguito l'accesso come client1@example.com
utilizzando l'URL shell.cloud.google.com?authuser=client1@example.com
.
Personalizzazione dell'immagine container
La personalizzazione dell'immagine container consente di creare un'immagine Docker che funziona come ambiente Cloud Shell personalizzato con i pacchetti aggiuntivi e le configurazioni personalizzate specificate. L'immagine Docker deve essere basata sull'immagine Cloud Shell di base ed essere ospitata in Container Registry.
Per informazioni dettagliate su come creare un'immagine container personalizzata, consulta la guida Personalizzazione delle immagini container.
A differenza della personalizzazione dell'ambiente, la personalizzazione delle immagini container non influisce sull'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
per impostazione predefinita, il 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 una macchina diversa, lo stato della sessione non andrà perso.
Cloud Shell supporta le associazioni di chiavi tmux
predefinite. Ad esempio, se premi Ctrl+B e poi %, tmux
suddivide la finestra della sessione corrente in riquadri sinistro e destro, che possono essere utili per il debug.
Per disattivare tmux
in Cloud Shell, fai clic sul pulsante Impostazioni terminale (icona chiave inglese), seleziona Impostazioni tmux e deseleziona l'opzione Abilita integrazione Tmux.
Statistiche sull'utilizzo
Cloud Shell raccoglie statistiche di utilizzo anonimizzate 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 ricollegate al tuo account.
Le metriche non vengono raccolte in base a 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 di utilizzo del terminale nel menu Impostazioni . Qualsiasi modifica alle preferenze nel menu Impostazioni viene applicata alla sessione successiva. Per attivare o disattivare la raccolta delle metriche, chiudi la scheda e apri un'altra scheda dopo aver apportato la modifica.
Nota: è separato dalle statistiche di utilizzo di gcloud, che sono abilitate per impostazione predefinita in Cloud Shell.
Per disabilitare la raccolta delle metriche dell'interfaccia a riga di comando gcloud, esegui questo comando nella sessione di Cloud Shell:
gcloud config set disable_usage_reporting true