Configura Cloud Shell

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 software installato, script e file di configurazione utente come .bashrc e .vimrc, persistono da una sessione all'altra. Poiché .bashrc persiste tra le sessioni, è un ottimo modo per personalizzare il comportamento di Cloud Shell. Allo stesso modo, per rendere persistenti le installazioni, puoi installare i pacchetti nella tua home directory.

Variabili di ambiente preconfigurate

Quando viene avviato Cloud Shell, il progetto attivo in Cloud Shell viene propagato alla configurazione di gcloud all'interno di Cloud Shell per l'utilizzo immediato. GOOGLE_CLOUD_PROJECT, la variabile di ambiente utilizzata dal supporto della libreria delle 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 di gcloud CLI

Quando utilizzi Cloud Shell, le preferenze di gcloud CLI vengono archiviate in una cartella temporanea tmp, impostata solo per la scheda corrente e non vengono mantenute tra le sessioni.

Per rendere persistenti le configurazioni di gcloud CLI, puoi impostarle utilizzando uno dei seguenti metodi:

• Per mantenere la configurazione di gcloud CLI personalizzabile per ogni scheda, ma personalizzare la configurazione predefinita, puoi aggiungere comandi di configurazione gcloud (ad esempio gcloud 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, ma ti consente anche di personalizzare ulteriormente la configurazione di ogni scheda.

• Per utilizzare sempre la stessa configurazione di gcloud CLI, aggiungi export CLOUDSDK_CONFIG=$HOME/.config/gcloud alla fine del file .bashrc e poi esegui gcloud 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, rispettando questo formato: [USERNAME]@cloudshell:~ ([PROJECT_NAME])$

Per selezionare la regione che preferisci, esegui:

gcloud config set compute/region us-east1

I comandi riportati sopra sono esempi di configurazioni di gcloud CLI che puoi impostare. Per un elenco completo e maggiori dettagli sull'impostazione delle proprietà, consulta la guida alle proprietà di gcloud CLI.

Personalizzazione dell'ambiente

Nota: se vuoi che un pacchetto specifico venga incluso in Cloud Shell per impostazione predefinita, invia il tuo suggerimento come feedback.

La personalizzazione dell'ambiente ti 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 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 Debian.

Ad esempio, se vuoi installare Erlang 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 all'indirizzo /var/log/customize_environment. Lo script .customize_environment viene eseguito come processo in background e, se l'esecuzione va a buon fine, tocca /google/devshell/customize_environment_done. Poiché l'installazione dei pacchetti viene eseguita in parallelo all'accesso, i pacchetti installati potrebbero diventare disponibili alcuni istanti dopo aver raggiunto 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 aver eseguito l'accesso 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 con accesso come [e-mail] utilizzando l'URL shell.cloud.google.com?authuser=[e-mail].

Personalizzazione delle immagini container

La personalizzazione delle immagini 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 Artifact Registry.

A differenza della personalizzazione dell'ambiente, la personalizzazione dell'immagine container non influisce sull'esperienza Cloud Shell predefinita. Puoi utilizzare e condividere la tua immagine personalizzata con i link Apri in Cloud Shell.

Supporto di tmux

Cloud Shell utilizza tmux, che consente di migliorare la persistenza nelle sessioni delle schede del browser. Ad esempio, se aggiorni la consoleGoogle Cloud in una scheda o ti connetti a Cloud Shell da un'altra macchina, lo stato della sessione non andrà perso.

Cloud Shell supporta le associazioni di tasti tmux predefinite. Ad esempio, se premi Ctrl+b e poi %, tmux divide la finestra della sessione corrente in riquadri sinistro e destro, il 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 associate al tuo account.

Le metriche non vengono raccolte su informazioni che consentono l'identificazione personale, ad esempio 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 aprine un'altra dopo aver apportato la modifica.

Nota:questa impostazione è diversa dalle statistiche di utilizzo di gcloud, che sono attive per impostazione predefinita in Cloud Shell.

Per disattivare la raccolta delle metriche di gcloud CLI, esegui questo comando nella sessione Cloud Shell:

gcloud config set disable_usage_reporting true