Funcionamiento de Cloud Shell

Cloud Shell aprovisiona una máquina virtual de Compute Engine que ejecuta un sistema operativo Linux basado en Debian para que la uses temporalmente. Esta máquina virtual es propiedad de Google Cloudy está gestionada por esta empresa, por lo que no aparecerá en ninguno de tus proyectos de Google Cloud .

Nota: Tu organización controla si tienes acceso a Cloud Shell.

Las instancias de Cloud Shell se aprovisionan por usuario y por sesión. La instancia se conserva mientras tu sesión de Cloud Shell esté activa. Después de una hora de inactividad, la sesión finalizará y se descartará su VM. Para obtener más información sobre las cuotas de uso, consulta la guía de limitaciones.

Con la experiencia predeterminada de Cloud Shell, se te asigna una máquina virtual efímera y preconfigurada, y el entorno con el que trabajas es un contenedor Docker que se ejecuta en esa máquina virtual. También puedes personalizar tu entorno automáticamente al iniciar la VM para asegurarte de que tu instancia de Cloud Shell incluya las herramientas que prefieras.

Almacenamiento de discos persistentes

Cloud Shell aprovisiona 5 GB de almacenamiento en discos persistentes gratuito activado como directorio $HOME en la instancia de máquina virtual. Este almacenamiento se basa en cada usuario y está disponible en todos los proyectos. A diferencia de la propia instancia, este almacenamiento no caduca por inactividad. Todos los archivos almacenados en el directorio principal, entre ellos, 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. Tu directorio $HOME es privado y otros usuarios no pueden acceder a él.

Advertencia: Si eliminas tu directorio $HOME o no accedes a Cloud Shell durante 120 días, Cloud Shell eliminará automáticamente tu directorio $HOME y no podrá recuperar tus archivos. Recibirás una notificación por correo antes de que esto ocurra. Al iniciar una sesión de Cloud Shell, se evita que se recicle el almacenamiento persistente del directorio $HOME.

Cuando usas Cloud Shell, no puedes ampliar el espacio de almacenamiento del disco persistente. Si quieres tener más control sobre la persistencia del almacenamiento y más espacio de almacenamiento, puedes usar Cloud Workstations.

Cloud Shell también ofrece el modo efímero, que es la experiencia de Cloud Shell sin almacenamiento de disco persistente. Con el modo efímero, los tiempos de inicio serán más rápidos, pero todos los archivos que crees en tu sesión se perderán al finalizarla.

Autorización

Cuando hagas una llamada a la API de Google Cloud o uses una herramienta de línea de comandos que requiera credenciales (como la CLI de Google Cloud) con Cloud Shell por primera vez, Cloud Shell te pedirá que autorices. Haz clic en Autorizar para permitir que la herramienta use tus credenciales para hacer llamadas.

Consulta más información en el artículo Autorizar con Cloud Shell.

Variables de entorno preconfiguradas

Cuando se inicia Cloud Shell, el proyecto activo en la consola se propaga a tu configuración de gcloud dentro de Cloud Shell para que puedas usarlo de inmediato. Google Cloud GOOGLE_CLOUD_PROJECT, la variable de entorno que usa la biblioteca de compatibilidad con las credenciales predeterminadas de la aplicación para definir el ID del proyecto, también se define para que apunte al proyecto activo en la consola Google Cloud . La variable de entorno WEB_HOST apunta al nombre de host de tu VM de Cloud Shell, que puedes usar para hacer solicitudes HTTPS al entorno.

Nota: Aunque GOOGLE_CLOUD_PROJECT hereda el proyecto activo de la Google Cloud consola, tu instancia de Cloud Shell no está asociada directamente a este proyecto ni se gestiona desde él.

Selección de zonas

Cloud Shell se distribuye a nivel mundial en variasGoogle Cloud regiones. Cuando te conectas por primera vez a Cloud Shell, se te asigna automáticamente la región disponible más cercana. No puedes elegir tu propia región y, si Cloud Shell no elige la región más cercana, intentará migrar tu VM de Cloud Shell a una región más cercana cuando no se esté usando.

Para ver tu región actual, ejecuta el siguiente comando desde una sesión de Cloud Shell:

curl metadata/computeMetadata/v1/instance/zone

Lanzamiento de imágenes

La imagen de contenedor de Cloud Shell se actualiza semanalmente para mantener al día las herramientas preempaquetadas. Esto significa que Cloud Shell siempre incluye las versiones más recientes de la CLI de gcloud, Docker y otras utilidades.

Usuario raíz

Cuando configuras una sesión de Cloud Shell, obtienes una cuenta de usuario de Unix normal con un nombre de usuario basado en tu dirección de correo electrónico. Con este acceso, tienes privilegios de superusuario completos en la máquina virtual asignada e incluso puedes ejecutar comandos sudo si lo necesitas.

Herramientas disponibles

La instancia de máquina virtual de Cloud Shell tiene las siguientes herramientas preinstaladas:

Tipo	Herramienta
Interpretes de shell de Linux	bash sh
Utilidades de Linux	Utilidades estándar del sistema Debian
CLI y herramientas de gcloud	SDK de App Engine CLI de Google Cloud, incluida la CLI de gcloud gsutil para Cloud Storage
Editores de texto	Emacs Vim Nano
Compilar y empaquetar herramientas	Gradle Helm Make Maven Bazel npm nvm pip Composer
Herramientas de control de versiones	Git Mercurial
Herramientas adicionales	Docker iPython Cliente de MySQL Compilador de gRPC TensorFlow Terraform

Puedes instalar paquetes de software adicionales en la instancia de máquina virtual, pero la instalación no se conservará después de que finalice la instancia, a menos que instales el software en tu directorio $HOME o crees un entorno personalizado.

Idiomas disponibles

Nota: Las versiones de idioma pueden cambiar. Sin embargo, puedes instalar diferentes versiones si lo necesitas mediante el script de personalización del entorno.

La instancia de máquina virtual de Cloud Shell proporciona compatibilidad con los siguientes lenguajes preinstalados:

Idioma	Versión
Java	JRE/JDK 17 (OpenJDK)
Go	Más recientes
Python	3.12
Node.js	LTS
Ruby	3.2
PHP	8,3
.NET Core	SDKs 6.0, 7.0 y 8.0

La versión predeterminada del entorno de Java es 17. Para cambiar la sesión actual de Cloud Shell y usar la versión 1.11 de JRE y JDK, introduce lo siguiente en el símbolo del sistema de Cloud Shell:

sudo update-java-alternatives -s java-1.11.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-11-openjdk-amd64

Para cambiar a 21:

sudo update-java-alternatives -s java-1.21.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-21-openjdk-amd64

Para volver a la versión 17, haz lo siguiente:

sudo update-java-alternatives -s java-1.17.0-openjdk-amd64 && export JAVA_HOME=/usr/lib/jvm/java-17-openjdk-amd64/jre

Modo seguro

Si hay un problema en tus archivos .bashrc o .tmux.conf, Cloud Shell se cierra inmediatamente después de la conexión. El modo Seguro reinicia tu instancia de Cloud Shell e inicia sesión como raíz, lo que te permite solucionar cualquier problema en los archivos.

Para abrir Cloud Shell en modo seguro, sigue estos pasos:

• Añade cloudshellsafemode=true a la URL.
• En Cloud Shell, haz clic en , en Modo Seguro y, a continuación, en Reiniciar.

Para eliminar permanentemente todos los archivos de tu directorio principal y restaurar el directorio principal de Cloud Shell a un estado limpio, puedes restablecer tu VM de Cloud Shell.