Imágenes base preconfiguradas

Google Cloud mantiene las siguientes imágenes base diseñadas para usarse con Cloud Workstations.

Lista de imágenes base preconfiguradas

Estas imágenes se pueden usar directamente en las configuraciones de estaciones de trabajo o como imágenes base cuando se crean imágenes de contenedores personalizadas con el comando FROM de Docker.

Imagen	Descripción
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/code-oss:latest	Editor base de Cloud Workstations, Code OSS para Cloud Workstations, basado en Code-OSS. (Predeterminado)
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/base:latest	Imagen base sin IDE instalado.
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/clion:latest	IDE de CLion Solo se puede acceder a él a través de JetBrains Gateway. Para obtener información sobre la instalación y los primeros pasos, consulta Desarrolla código con los IDE de JetBrains locales.
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/goland:latest	IDE de GoLand Solo se puede acceder a él a través de JetBrains Gateway. Para obtener información sobre la instalación y los primeros pasos, consulta Desarrolla código con los IDE de JetBrains locales.
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/intellij-ultimate:latest	IDE de IntelliJ IDEA Ultimate. Solo se puede acceder a él a través de JetBrains Gateway. Para obtener información sobre la instalación y los primeros pasos, consulta Desarrolla código con los IDE de JetBrains locales.
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/phpstorm:latest	IDE de PhpStorm Solo se puede acceder a él a través de JetBrains Gateway. Para obtener información sobre la instalación y los primeros pasos, consulta Desarrolla código con los IDE de JetBrains locales.
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/pycharm:latest	IDE de PyCharm Professional Solo se puede acceder a él a través de JetBrains Gateway. Para obtener información sobre la instalación y los primeros pasos, consulta Desarrolla código con los IDE de JetBrains locales.
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/rider:latest	IDE de Rider Solo se puede acceder a él a través de JetBrains Gateway. Para obtener información sobre la instalación y los primeros pasos, consulta Desarrolla código con los IDE de JetBrains locales.
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/rubymine:latest	IDE de RubyMine. Solo se puede acceder a él a través de JetBrains Gateway. Para obtener información sobre la instalación y los primeros pasos, consulta Desarrolla código con los IDE de JetBrains locales.
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/webstorm:latest	IDE de WebStorm Solo se puede acceder a él a través de JetBrains Gateway. Para obtener información sobre la instalación y los primeros pasos, consulta Desarrolla código con los IDE de JetBrains locales.

Lista de imágenes base de terceros

Precaución: Un proveedor externo mantiene la imagen de contenedor que se indica en esta sección. Google Cloud no compila, mantiene ni admite oficialmente esta imagen. Evalúa con cuidado cualquier solución antes de implementarla en tu entorno de producción.

Imagen de terceros	Proveedor externo
us-central1-docker.pkg.dev/posit-images/cloud-workstations/workbench:latest	Posit Workbench (incluido RStudio Pro)

Si tienes problemas con el IDE de Posit Workbench o con la imagen del contenedor de Posit Workbench, infórmalos a Posit en GitHub.

Estructura de la imagen base de Cloud Workstations

Las imágenes base de Cloud Workstations comparten la siguiente estructura definida:

• El archivo de punto de entrada de la imagen base se establece en /google/scripts/entrypoint.sh.

• Al inicio, las imágenes base ejecutan archivos en /etc/workstation-startup.d/* en orden lexicográfico para inicializar el entorno de la estación de trabajo.

  Los archivos y su comportamiento son los siguientes:

  • 000_configure-docker.sh: Configura y ejecuta Docker dentro de la estación de trabajo.

  • 010_add-user.sh: Crea el usuario predeterminado en Cloud Workstations.

    Dado que el disco persistente se conecta de forma dinámica al contenedor, los usuarios se deben agregar al inicio de la estación de trabajo, no en el Dockerfile.

  • 020_start-sshd.sh: Inicia el servicio sshd en el contenedor.

  • 030_customize-environment.sh: Ejecuta /home/user/.workstation/customize_environment como user.

  • 110_start-$IDE.sh: Inicia el IDE para la imagen.

• Cloud Workstations almacena imágenes de Docker en el directorio principal en /home/.docker_data para que las imágenes se conserven entre sesiones.

Para agregar funcionalidad adicional durante el inicio de la estación de trabajo, agrega tus secuencias de comandos en el directorio /etc/workstation-startup.d/:

• De forma predeterminada, las secuencias de comandos de este directorio se ejecutan como raíz. Para ejecutar las secuencias de comandos como otro usuario, usa el comando runuser.

• Dado que las secuencias de comandos se ejecutan en orden lexicográfico, te recomendamos que les agregues un prefijo con un número de tres dígitos mayor que 200.

Como alternativa, si no quieres extender la imagen de una estación de trabajo, puedes crear una secuencia de comandos customize_environment en tu directorio principal.

Modificaciones del directorio principal

Cuando la configuración de la estación de trabajo especifica un directorio principal persistente (que es el comportamiento predeterminado), se adjunta de forma dinámica un disco persistente que respalda el directorio principal al contenedor en el tiempo de ejecución. Este proceso sobrescribe las modificaciones realizadas en el directorio /home durante el tiempo de compilación de la imagen del contenedor.

Para conservar las actualizaciones, modifica el directorio /home en el tiempo de ejecución del contenedor agregando una secuencia de comandos en el directorio /etc/workstation-startup.d o agregando una configuración por usuario en el directorio /etc/profile.d. Para acelerar el proceso, considera ejecutar la secuencia de comandos de configuración como un proceso en segundo plano (agrega un signo et, &, al final del comando) para evitar que se bloquee el inicio del contenedor.

Estos son algunos ejemplos de la configuración del tiempo de compilación que se debe trasladar al tiempo de ejecución del contenedor:

• Configuración de git por usuario
• Repositorios git clonados en el directorio principal
• Configuración directa del usuario, como colocar archivos en un directorio $HOME/.config
• Creación de usuarios

Creación y modificación de usuarios

Dado que el disco persistente se conecta de forma dinámica al contenedor en el tiempo de ejecución, los usuarios se deben agregar al inicio de la estación de trabajo, no en el Dockerfile. Para modificar o crear usuarios adicionales, te recomendamos que actualices /etc/workstation-startup.d/010_add-user.sh o que crees tu propia secuencia de comandos que se ejecute durante el inicio.

Además, puedes modificar el perfil de Bash predeterminado para los usuarios actualizando los archivos en /etc/profile.d.

Actualiza las claves de Secure APT preconfiguradas

Las imágenes base de Cloud Workstations vienen preinstaladas con varias herramientas obtenidas de diversos repositorios de terceros a través de Secure APT. Como parte del proceso de instalación, las claves públicas proporcionadas por los propietarios del repositorio se importan con gpg y se colocan en archivos individuales en /usr/share/keyrings/. Se hace referencia a estos archivos desde los archivos list correspondientes en /etc/apt/sources.list.d/. Esto permite que apt verifique la integridad de un repositorio determinado cuando interactúa con él.

En ocasiones, los propietarios de repositorios de terceros pueden decidir cambiar la clave pública que se usa para validar la integridad de su repositorio, lo que hace que apt muestre un error cuando interactúa con él. Para resolver este posible problema, puedes usar /google/scripts/refresh-preinstalled-apt-keys.sh, que obtiene las versiones más recientes de las claves públicas preinstaladas y las vuelve a importar.

Enumera las versiones del IDE instaladas

Varias imágenes base de Cloud Workstations vienen preinstaladas con un IDE. Para mayor comodidad, consulta el script /google/scripts/preinstalled-ide-versions.sh incluido, que enumera el nombre y la información de la versión de los IDE instalados en la imagen.

Desactiva los privilegios de raíz de sudo

El usuario predeterminado de la estación de trabajo tiene privilegios de acceso raíz de sudo en estos contenedores. Para desactivar el acceso raíz al contenedor de Docker, establece la variable de entorno CLOUD_WORKSTATIONS_CONFIG_DISABLE_SUDO en true cuando crees la configuración de la estación de trabajo.

Para configurar esta variable de entorno a través de la consola de Google Cloud cuando crees la configuración de tu estación de trabajo, sigue estos pasos:

1. Cuando crees la configuración de la estación de trabajo, completa la configuración de la información básica y la configuración de la máquina.
2. En el diálogo Personalización del entorno, expande la sección Opciones avanzadas de contenedores y selecciona Variables de entorno.
3. Haz clic en agregarAgregar variable.
4. Ingresa CLOUD_WORKSTATIONS_CONFIG_DISABLE_SUDO y true como el valor.

Nota: Si un usuario puede salir del contenedor de Docker, es posible que pueda obtener privilegios de raíz en la VM subyacente.

Personaliza sin extender una imagen

Para mayor comodidad, todas las imágenes base de Cloud Workstations verifican la presencia de un archivo ejecutable ubicado en /home/user/.workstation/customize_environment y, si existe, lo ejecutan en segundo plano como user. Esto te permite ejecutar cualquier secuencia de comandos o archivo binario durante el inicio. A diferencia de .profile o .bashrc, la secuencia de comandos solo se ejecuta una vez cuando se inicia la estación de trabajo, en lugar de una vez para cada inicio de sesión de shell.

Dado que la secuencia de comandos customize_environment se ejecuta como user, asegúrate de actualizar los permisos según sea necesario cuando escribas tu secuencia de comandos. Por ejemplo, si deseas instalar Emacs cada vez que se inicia tu estación de trabajo, el contenido de customize_environment podría ser similar al siguiente:

#!/bin/bash
sudo apt-get update
sudo apt-get install -y emacs

Los registros de ejecución de customize_environment se pueden encontrar en el contenedor en /var/log/customize_environment y también se escriben en los registros de salida del contenedor. Si customize_environment se ejecuta correctamente, se crea un archivo en /var/run/customize_environment_done. Debido a que customize_environment se ejecuta en paralelo con el inicio de la estación de trabajo, los paquetes instalados por la secuencia de comandos pueden estar disponibles unos momentos después de que se inicie la estación de trabajo.

Cómo evitar los tiempos de espera por inactividad

Para mayor comodidad, todas las imágenes base de Cloud Workstations incluyen una secuencia de comandos preinstalada en /google/scripts/keep_alive.sh. Este script envía mensajes de actividad periódicos, lo que puede evitar que la estación de trabajo se apague debido a los tiempos de espera por inactividad cuando ejecutas procesos en segundo plano sin interacción directa.

¿Qué sigue?

• Personaliza tus imágenes de contenedor.
• Automatiza la recompilación de imágenes de contenedor para sincronizar las actualizaciones de imágenes base con Cloud Build y Cloud Scheduler.
• Configurar las prácticas recomendadas de seguridad