Cómo funciona Cloud Shell

Cloud Shell aprovisiona una máquina virtual de Compute Engine que ejecuta un sistema operativo Linux basado en Debian para tu uso temporal. Google Cloudes el propietario y administrador de esta máquina virtual, por lo que no aparecerá en ninguno de tus proyectos 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 persiste mientras tu sesión de Cloud Shell está activa. Después de una hora de inactividad, tu sesión finaliza y su VM se descarta. 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 asignará una VM efímera y ya configurada y el entorno con el que trabajas es un contenedor de Docker que se ejecuta en esa VM. También puedes personalizar tu entorno de forma automática cuando se inicia la VM a fin de asegurarte de que la instancia de Cloud Shell incluya tus herramientas preferidas.

Almacenamiento en discos persistentes

Cloud Shell proporciona 5 GB de almacenamiento en disco persistente gratuito activado como su directorio $HOME en la instancia de máquina virtual. Este almacenamiento es por usuario y está disponible en todos los proyectos. A diferencia de la instancia en sí, con este almacenamiento no se agota el tiempo de espera en inactividad. Todos los archivos que almacena en su directorio principal, incluidos el software instalado, las secuencias de comandos y los archivos de configuración de usuario como .bashrc y .vimrc, persisten entre sesiones. Tu directorio $HOME es privado, por lo que otros usuarios no pueden acceder a él.

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

Cuando usas Cloud Shell, no puedes expandir el espacio de almacenamiento del disco persistente. Para tener más control sobre la persistencia de tu 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 en disco persistente. Con el modo efímero, tendrás tiempos de inicio más rápidos, pero todos los archivos que crees en la sesión se perderán cuando finalice.

Autorización

Cuando realizas una llamada a la API de Google Cloud o usas una herramienta de línea de comandos que requiere credenciales (como Google Cloud CLI) con Cloud Shell por primera vez, este servicio te solicita que realices la autorización. Haz clic en Autorizar para permitir que la herramienta use tus credenciales para realizar llamadas.

Consulta Cómo autorizar con Cloud Shell para obtener más detalles.

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 su uso inmediato. Google Cloud GOOGLE_CLOUD_PROJECT, la variable de entorno usada por la biblioteca compatible con las credenciales predeterminadas de la aplicación para definir el ID del proyecto, también se configura para apuntar a los proyectos activos en la consola de Google Cloud . La variable de entorno WEB_HOST apunta al nombre de host de tu VM de Cloud Shell, que puedes usar para realizar solicitudes HTTPS al entorno.

Nota: Si bien GOOGLE_CLOUD_PROJECT hereda el proyecto activo de la consola deGoogle Cloud , tu instancia de Cloud Shell no está asociada directamente con este proyecto ni es administrada por él.

Selección de la zona

Cloud Shell se distribuye a nivel global en varias regiones deGoogle Cloud . Cuando te conectas a Cloud Shell por primera vez, se te asigna automáticamente a 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 esta VM no esté en uso.

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 imagen

La imagen del contenedor de Cloud Shell se actualiza semanalmente para mantener las herramientas ya preparadas actualizadas. Esto significa que Cloud Shell siempre viene con las versiones más recientes de gcloud CLI, Docker y otras utilidades.

Usuario raíz

Cuando configuras una sesión de Cloud Shell, obtienes una cuenta de usuario normal de Unix con un nombre de usuario basado en tu dirección de correo electrónico. Con este acceso, tienes privilegios de raíz completos en la VM asignada y puedes ejecutar comandos sudo si es necesario.

Herramientas disponibles

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

Tipo	Herramienta
Intérpretes de shell de Linux	bash sh
Herramientas de Linux	Utilidades estándar del sistema Debian
Gcloud CLI y herramientas	SDK de App Engine Google Cloud CLI, incluida la CLI de gcloud gsutil para Cloud Storage
Editores de texto	Emacs Vim Nano
Herramientas de empaquetado y compilación	Gradle Helm Make Maven Bazel npm nvm pip Composer
Herramientas de control de código fuente	Git Mercurial
Herramientas adicionales	Docker iPython MySQL client gRPC compiler TensorFlow Terraform

Puede instalar paquetes de software adicionales en la instancia de máquina virtual, pero la instalación no continuará después de que la instancia finalice a menos que instale el software en su directorio $HOME o cree un entorno personalizado.

Idiomas admitidos

Nota: Las versiones de los lenguajes pueden cambiar. Sin embargo, puede instalar diferentes versiones si necesita utilizar la secuencia de comandos de personalización de entorno.

La instancia de máquina virtual de Cloud Shell proporciona compatibilidad de idiomas preinstalada para los siguientes lenguajes:

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 de Cloud Shell actual a fin de usar la versión 1.11 de JRE y JDK, ingresa el siguiente comando en el símbolo de 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 la versión 21, ingresa el siguiente comando:

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, ingresa el siguiente comando:

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 cerrará inmediatamente después de la conexión. El modo seguro reinicia tu instancia de Cloud Shell y te permite acceder con permisos de administrador, lo que te permite solucionar cualquier problema en los archivos.

Para abrir Cloud Shell en modo seguro, haz lo siguiente:

• Agrega cloudshellsafemode=true a la URL.
• En Cloud Shell, haz clic en , en Modo seguro y, luego, en Reiniciar.

Si quieres borrar de forma permanente todos los archivos de tu directorio principal y restablecer tu directorio principal de Cloud Shell a un estado inicial, puedes restablecer tu VM de Cloud Shell.