Imágenes base preconfiguradas

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

Lista de imágenes base preconfiguradas

Estas imágenes se pueden usar directamente en la configuración de las 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 través de JetBrains Gateway.
Para obtener información sobre la instalación y el comienzo, 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 través de JetBrains Gateway.
Para obtener información sobre la instalación y el comienzo, consulta Desarrolla código con los IDE de JetBrains locales.
us-central1-docker.pkg.dev/cloud-workstations-images/predefined/intellij-ultimate:latest IDE IntelliJ IDEA Ultimate Solo se puede acceder a través de JetBrains Gateway.
Para obtener información sobre la instalación y el comienzo, 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 través de JetBrains Gateway.
Para obtener información sobre la instalación y el comienzo, 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 través de JetBrains Gateway.
Para obtener información sobre la instalación y el comienzo, 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 través de JetBrains Gateway.
Para obtener información sobre la instalación y el comienzo, 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 través de JetBrains Gateway.
Para obtener información sobre la instalación y el comienzo, 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 través de JetBrains Gateway.
Para obtener información sobre la instalación y el comienzo, consulta Desarrolla código con los IDE de JetBrains locales.

Lista de imágenes base de terceros

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 alfabético 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.

      Debido a 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.

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

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

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

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

  • Debido a que las secuencias de comandos se ejecutan en orden alfabético, te recomendamos que las antecedas con un número de tres dígitos superior a 200.

Modificaciones del directorio principal

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

Para conservar las actualizaciones, modifica el directorio /home en el entorno de ejecución del contenedor. Para ello, agrega una secuencia de comandos en el directorio /etc/workstation-startup.d o agrega la 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 &, &, al final del comando) para evitar bloquear el inicio del contenedor.

Estos son algunos ejemplos de configuración del tiempo de compilación que se deben mover 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

Debido a que el disco persistente se conecta de forma dinámica al contenedor durante 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 crees tu propia secuencia de comandos que se ejecute al inicio.

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

Actualiza las claves de APT seguras preconfiguradas

Las imágenes base de Cloud Workstations vienen preinstaladas con varias herramientas que se obtienen de varios repositorios de terceros mediante APT seguro. Como parte del proceso de instalación, las claves públicas que proporcionan 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 externos 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.

Muestra una lista de las versiones de IDE instaladas

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

Cómo desactivar 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 de 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 establecer 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 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.

¿Qué sigue?