Configurar Cloud Shell

En esta página se describen las formas en las que puedes configurar Cloud Shell para personalizar tu experiencia.

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

Cloud Shell aprovisiona 5 GB de almacenamiento de disco persistente gratuito activado como directorio $HOME. Todos los archivos almacenados en el directorio principal, incluido el software instalado, las secuencias de comandos y los archivos de configuración del usuario (como .bashrc y .vimrc), se conservan de una sesión a otra. Como tu .bashrc se mantiene entre sesiones, es una forma estupenda de personalizar el comportamiento de Cloud Shell. Del mismo modo, para que tus instalaciones persistan, puedes instalar paquetes en tu directorio principal.

Variables de entorno preconfiguradas

Cuando se inicia Cloud Shell, el proyecto activo en Cloud Shell se propaga a tu configuración de gcloud en Cloud Shell para que puedas usarlo inmediatamente. GOOGLE_CLOUD_PROJECT, la variable de entorno que usa la biblioteca de compatibilidad con las credenciales de aplicación predeterminadas para definir el ID del proyecto, también se define para que apunte al proyecto activo en Cloud Shell.

La variable de entorno CLOUD_SHELL se define como true. Las aplicaciones pueden comprobar esta variable para determinar si se están ejecutando en Cloud Shell.

Preferencias de la CLI de gcloud

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

Para que tus configuraciones de gcloud CLI se conserven, puedes definirlas con uno de los siguientes métodos:

• Para que la configuración de la CLI de gcloud se pueda personalizar en cada pestaña, pero también se pueda personalizar la configuración predeterminada, puedes añadir gcloudcomandos de configuración (como gcloud config set compute/region us-central1 para definir una región predeterminada) al final del archivo $HOME/.bashrc.

  De esta forma, cada nueva pestaña hereda tu Google Cloud proyecto de consola 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 la CLI de gcloud, añade export CLOUDSDK_CONFIG=$HOME/.config/gcloud al final del archivo .bashrc y, a continuación, ejecuta gcloud config configurations create CONFIG_NAME para crear la configuración que quieras usar.

Propiedades comunes

Para definir el proyecto en el que quieres trabajar, ejecuta el siguiente comando:

gcloud config set project [PROJECT_NAME]

El símbolo del sistema se actualiza para reflejar el proyecto activo, con este formato: [USERNAME]@cloudshell:~ ([PROJECT_NAME])$

Para seleccionar la región que prefieras, ejecuta lo siguiente:

gcloud config set compute/region us-east1

Los comandos anteriores son ejemplos de configuraciones de la CLI de gcloud que puedes definir. Para ver una lista completa y más detalles sobre cómo definir 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 la 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 por cada inicio de sesión de shell).

Esta secuencia de comandos se ejecuta como raíz y puedes instalar los paquetes que quieras en cada sesión de Cloud Shell mediante comandos de gestión de paquetes de Debian.

Por ejemplo, si quieres instalar erlang en Cloud Shell, tu archivo .customize_environment tendrá este aspecto:

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

Los registros de ejecución de tu secuencia de comandos .customize_environment se encuentran en /var/log/customize_environment. La secuencia de comandos .customize_environment se ejecuta como un proceso en segundo plano y, si se ejecuta correctamente, tocará /google/devshell/customize_environment_done. Como la instalación de paquetes se ejecuta en paralelo al inicio de sesión, los paquetes instalados pueden estar disponibles unos instantes después de que aparezca la petición de inicio de sesión.

Abrir Cloud Shell con una cuenta de usuario específica

El parámetro authuser te permite especificar una cuenta de usuario para usarla con Cloud Shell. Debes iniciar sesión con la cuenta de usuario especificada. Si no has iniciado sesión en la cuenta especificada, Cloud Shell se abrirá con la cuenta predeterminada con la que hayas iniciado sesión. Por ejemplo, puedes abrir Cloud Shell con la sesión iniciada como client1@example.com mediante la URL shell.cloud.google.com?authuser=client1@example.com.

Personalización de imágenes de contenedor

La personalización de imágenes de contenedor te permite crear una imagen Docker que funcione como un entorno 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 Artifact Registry.

A diferencia de la personalización del entorno, la personalización de la imagen del contenedor no afecta a tu experiencia predeterminada de Cloud Shell. Puedes usar y compartir tu imagen personalizada con enlaces Abrir en Cloud Shell.

Compatibilidad con tmux

Cloud Shell usa tmux, lo que le permite mejorar la persistencia en las sesiones de pestañas del navegador. Por ejemplo, si actualizas la consola en una pestaña o te conectas a Cloud Shell desde otro ordenador, no se perderá el estado de la sesión.Google Cloud

Cloud Shell admite las tmuxcombinaciones de teclas predeterminadas. Por ejemplo, si pulsas Ctrl+b y, a continuación, %, tmux divide la ventana de la sesión actual en dos paneles, uno a la izquierda y otro a la derecha, lo que puede ser útil para depurar.

Estadísticas de uso

Cloud Shell recoge estadísticas de uso anonimizadas sobre los comandos que se ejecutan en el terminal de Cloud Shell. Las estadísticas solo se recogen sobre los comandos que vienen preinstalados en Cloud Shell. Estas métricas no se pueden vincular a tu cuenta.

No se recogen métricas sobre información personal identificable, como los argumentos transferidos a estos comandos.

Para cambiar las preferencias de recogida de métricas en cualquier momento, selecciona Estadísticas de uso de terminal en el menú Configuración . Los cambios que hagas en tus preferencias en el menú Configuración se aplicarán en la sesión siguiente. Para habilitar o inhabilitar la recogida de métricas, cierre la pestaña y abra otra después de hacer 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 recogida de métricas de la CLI de gcloud, ejecuta el siguiente comando en tu sesión de Cloud Shell:

gcloud config set disable_usage_reporting true