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, puedes instalar paquetes en el directorio principal para que se mantengan las instalaciones.

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 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, establecida solo en tu pestaña actual, y no se conservan entre sesiones.

Para que se mantengan tus configuraciones de gcloud CLI, puedes establecerlas mediante uno de los siguientes métodos:

  • Para mantener la configuración de gcloud CLI personalizable por pestaña, pero personalizar la configuración predeterminada, puedes agregar comandos de configuración gcloud (como gcloud 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 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 de tu archivo .bashrc y, luego, ejecuta gcloud config configurations create CONFIG_NAME para crear la configuración que deseas.

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 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 gcloud CLI que puedes establecer. Para obtener una lista completa y obtener más detalles sobre la configuración de propiedades, 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 especificada

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 con el acceso de 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 imágenes de contenedores te permite crear una imagen de Docker que funcione como un entorno de Cloud Shell personalizado con los paquetes adicionales y las configuraciones personalizadas que especifiques. Tu imagen de Docker debe basarse en la imagen base de Cloud Shell 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 contenedores.

A diferencia de la personalización del entorno, la personalización de imágenes de contenedores no afecta tu experiencia predeterminada de Cloud Shell. Puedes usar y compartir tu imagen personalizada con los vínculos Abrir en Cloud Shell.

Compatibilidad con tmux

Cloud Shell usa tmux, 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 si 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.

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 solo se recopilan 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. 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