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 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 (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 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, ejecuta gcloud 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