Configura Cloud Shell

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 las instalaciones persistan, 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 se puede verificar desde aplicaciones para determinar si una aplicación se ejecuta en Cloud Shell.

Preferencias de gcloud CLI

Cuando usas Cloud Shell, tus preferencias de gcloud CLI se almacenan en una carpeta temporal tmp, se configuran solo para tu pestaña actual y no se conservan entre sesiones.

Para conservar la configuración de gcloud CLI, puedes establecerla mediante uno de los siguientes métodos:

  • Para que tu configuración de gcloud CLI se pueda personalizar por pestaña, pero también la configuración predeterminada, puedes agregar comandos de configuración gcloud (como gcloud config set compute/region us-central1 a fin de establecer una región predeterminada) al final de tu archivo $HOME/.bashrc.

    Esto garantiza que cada pestaña nueva herede tu proyecto de la consola de Google Cloud y la configuración predeterminada personalizada. Además, te permite personalizar aún más 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 y, luego, ejecuta gcloud config configurations create CONFIG_NAME para crear la configuración que deseas 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 en ese momento y respeta 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 que puedes establecer. Para obtener una lista completa y más detalles sobre las propiedades de configuración, consulta 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 específica

El parámetro authuser te permite especificar una cuenta de usuario para usar con Cloud Shell. Debes acceder con la cuenta de usuario especificada. Si no accediste a la cuenta especificada, Cloud Shell se abrirá con la cuenta predeterminada a la que accediste. Por ejemplo, puedes abrir Cloud Shell cuando accediste como client1@example.com con la URL shell.cloud.google.com?authuser=client1@example.com.

Personalización de imágenes de contenedores

La personalización de la imagen de contenedor te permite crear una imagen de Docker que funcione como un entorno personalizado de Cloud Shell con los paquetes adicionales especificados y las configuraciones personalizadas. Tu imagen de Docker debe estar basada en la imagen de Cloud Shell base y alojarse en Container Registry.

Para obtener detalles sobre cómo crear una imagen de contenedor personalizada, consulta la Guía de personalización de imágenes de contenedor.

A diferencia de la personalización del entorno, la personalización de la imagen de contenedor no afecta tu experiencia predeterminada de Cloud Shell. Puedes utilizar y compartir tu imagen personalizada mediante los 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 te conectas a 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 dentro de la terminal de Cloud Shell. Las estadísticas se recopilan solo sobre 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. Para habilitar o inhabilitar la recopilación de métricas, cierra la pestaña y abre otra 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 en tu sesión de Cloud Shell:

gcloud config set disable_usage_reporting true