En esta página, se describen las formas en que puedes configurar Cloud Shell para personalizar tu 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 almacenes 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
se mantiene en todas las sesiones, es una excelente manera de personalizar tu comportamiento de Cloud Shell. Del mismo modo, para que tus instalaciones
persistentes, puedes instalar paquetes en tu directorio principal.
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 biblioteca compatible con la credencial predeterminada de la aplicación, a fin de definir el ID del proyecto, también se configura para apuntar los proyectos activos en Cloud Shell.
La variable de entorno CLOUD_SHELL
se establece en true
. Esta variable puede ser
verificados desde las aplicaciones para determinar si una aplicación se está ejecutando en
Cloud Shell.
Preferencias de gcloud CLI
Cuando usas Cloud Shell, tus preferencias de gcloud CLI
se almacenan en una carpeta temporal tmp
, se establecen solo para tu pestaña actual, y no
no persisten entre sesiones.
Para que persistan tus parámetros de configuración de gcloud CLI, puedes establecer con uno de los siguientes métodos:
Para mantener la configuración de gcloud CLI personalizable por pestaña, pero personaliza la configuración predeterminada, puedes agregar
gcloud
comandos de configuración (comogcloud config set compute/region us-central1
para establecer una región predeterminada) al final del archivo$HOME/.bashrc
.Esto garantiza que cada pestaña nueva herede tu proyecto de la consola de Google Cloud y tu configuración predeterminada personalizada, pero también te permite personalizar la configuración de cada pestaña.
Para usar siempre la misma configuración de gcloud CLI, agrega
export CLOUDSDK_CONFIG=$HOME/.config/gcloud
al final del archivo .bashrc luego, ejecutagcloud config configurations create CONFIG_NAME
para crear la configuración que quieres usar.
Propiedades comunes
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 actualiza para reflejar el proyecto activo actualmente.
respetando este 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 gcloud CLI puede establecer; para ver una lista completa y más detalles sobre las propiedades de configuración, consulta a la guía de propiedades de la CLI de gcloud.
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.
Abre Cloud Shell con una cuenta de usuario especificada.
El parámetro authuser
te permite especificar la cuenta de usuario con la que se usará
Cloud Shell. Debes acceder con la cuenta de usuario especificada.
Si no accediste a la cuenta especificada, Cloud Shell
se abre con la cuenta predeterminada a la que accediste. Por ejemplo, puedes abrir
Cloud Shell accedió como [email protected]
con la URL
[email protected]
Personalización de imágenes de contenedores
La personalización de imágenes de contenedores permite crear imágenes de Docker funciona como un entorno personalizado de Cloud Shell con la paquetes adicionales y configuraciones personalizadas. Tu imagen de Docker debe estar basada en la base Imagen de Cloud Shell y se aloja en Container Registry.
Para obtener detalles sobre cómo crear una imagen de contenedor personalizada, consulta el Guía para personalizar imágenes de contenedor
A diferencia de la personalización del entorno, la personalización de la imagen del contenedor no afecta tu experiencia predeterminada de Cloud Shell. Puedes usar y compartir tu imagen personalizada con Vínculos Abrir en Cloud Shell
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
La consola de Google Cloud en una pestaña o conéctate a tu Cloud Shell
desde otra máquina, 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. Se recopilan las estadísticas solo en los comandos preinstalados en Cloud Shell. Estas métricas no pueden vincularse 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 .
Cualquier cambio en sus preferencias en el menú Configuración se aplica en la siguiente sesión. Para habilitar o inhabilitar la recopilación de métricas, cierra la pestaña y abre
otra pestaña después de realizar el cambio.
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 gcloud CLI, ejecuta el siguiente comando: comando en tu sesión de Cloud Shell:
gcloud config set disable_usage_reporting true