Configura Cloud Shell

Esta página describe la variedad de formas en que puede configurar Cloud Shell para personalizar su experiencia.

Archivos de configuración en el directorio principal de Cloud Shell

Cloud Shell aprovisiona 5 GB de almacenamiento en disco persistente sin cargo, activado como directorio $HOME. Todos los archivos que se almacenen en el directorio principal, incluidos los software instalados, las secuencias de comandos y los archivos de configuración de usuario, como .bashrc y .vimrc, persisten de una sesión a otra. Dado que tu .bashrc persiste en todas las sesiones, es una excelente manera de personalizar tu comportamiento de Cloud Shell. Del mismo modo, puedes instalar paquetes en el directorio principal para que las instalaciones se mantengan.

Variables de entorno preconfiguradas

Cuando se inicia Cloud Shell, el proyecto activo en la consola se propaga a su configuración de gcloud dentro de Cloud Shell para su uso inmediato. GOOGLE_CLOUD_PROJECT, la variable de entorno usada por la asistencia de la biblioteca de credenciales predeterminadas de la aplicación a fin de definir el ID del proyecto, también se configura para apuntar a los proyectos activos en Console.

La variable de entorno CLOUD_SHELL se configura como true. Esta variable se puede verificar desde las aplicaciones para determinar si una aplicación se ejecuta en Cloud Shell.

Preferencias de la herramienta de línea de comandos de gcloud

Para configurar el proyecto en el que te gustaría trabajar, ejecuta lo siguiente:

gcloud config set project [PROJECT_NAME]

El símbolo del sistema se actualizará para reflejar tu proyecto activo actual y respetará el siguiente formato: [USERNAME]@cloudshell:~ ([PROJECT_NAME])$

Para seleccionar su región preferida, ejecute lo siguiente:

gcloud config set compute/region us-east1

Los comandos anteriores son ejemplos de configuraciones de herramientas de línea de comandos de gcloud que puede establecer. Para obtener una lista completa y obtener más detalles sobre la configuración de propiedades, consulte la guía de propiedades del SDK de Cloud.

Personalización del entorno

La personalización del entorno te permite instalar paquetes adicionales en tu entorno de Cloud Shell cuando se inicia.

Secuencia de comandos de personalización del entorno

Cloud Shell ejecuta automáticamente la secuencia de comandos, $HOME/.customize_environment, cuando se inicia su instancia. A diferencia de .profile o .bashrc, esta secuencia de comandos se ejecuta una vez cuando se inicia Cloud Shell (en lugar de una vez para cada inicio de sesión de shell).

Esta secuencia de comandos se ejecuta como raíz y puede instalar cualquier paquete que desee que exista en cada sesión de Cloud Shell mediante los comandos de administración de paquetes de Debian.

Por ejemplo, si desea tener Erlang instalado en Cloud Shell, su archivo .customize_environment se verá así:

#!/bin/sh
apt-get update
apt-get -y install erlang

Los registros de ejecución de su secuencia de comandos .customize_environment se pueden encontrar en /var/log/customize_environment. La secuencia de comandos .customize_environment se ejecuta como un proceso en segundo plano y, cuando se ejecuta con éxito, toca /google/devshell/customize_environment_done. Debido a que la instalación de paquetes se ejecuta en paralelo con su inicio de sesión, los paquetes instalados pueden estar disponibles unos momentos después de que llegue al indicador de inicio de sesión.

Compatibilidad con tmux

Cloud Shell usa tmux de forma predeterminada, lo que permite mejorar la persistencia entre las sesiones de las pestañas del navegador. Por ejemplo, si actualizas Cloud Console en una pestaña o te conectas a Cloud Shell desde una máquina diferente, no se perderá el estado de la sesión.

Cloud Shell es compatible con las vinculaciones de clave tmux predeterminados. Por ejemplo, si presionas Ctrl+b y, luego, %, tmux divide la ventana de sesión actual en paneles izquierdo y derecho, lo que puede sean útiles para la depuración.

Para inhabilitar tmux en Cloud Shell, haga clic en el botón Configuración de terminal (ícono de llave inglesa), seleccione Configuración de tmux y anule la selección de la opción Habilitar integración de tmux.

Estadísticas de uso

Cloud Shell recopila estadísticas anónimas de uso sobre los comandos que se ejecutan en la terminal de Cloud Shell. Las estadísticas se recopilan solo en los comandos que vienen preinstalados en Cloud Shell. Estas métricas no se pueden vincular a tu cuenta.

Las métricas que se recopilan no contienen información de identificación personal, como los argumentos pasados a estos comandos.

Para cambiar las preferencias de recopilación de métricas en cualquier momento, seleccione Estadísticas de uso de la terminal en el menú Configuración Botón de configuración. Cualquier cambio en sus preferencias en el menú Configuración se aplica en la siguiente sesión. Tendrá que cerrar su pestaña y abrir otra una vez que haya realizado su cambio para habilitar o inhabilitar la recopilación de métricas.

Nota: Esto es independiente de las estadísticas de uso de gcloud, que están habilitadas de forma predeterminada en Cloud Shell.

Para inhabilitar la recopilación de métricas de la herramienta de línea de comandos de gcloud, ejecute el siguiente comando en su sesión de Cloud Shell:

gcloud config set disable_usage_reporting true