Solucionar problemas de Cloud Workstations

Esta página contiene información para solucionar problemas de Cloud Workstations.

Extraer imágenes del sistema en máquinas virtuales

Cuando creas estaciones de trabajo con tu configuración, Cloud Workstations extrae imágenes del sistema a tu instancia de máquina virtual desde Artifact Registry (o Container Registry). El mensaje de error que aparece es similar al siguiente:

System images cannot be pulled onto workstation VMs using this configuration.
Ensure that you have set up Cloud NAT or enabled Private Google Access for
Artifact Registry (and Container Registry).

Si no extraes estas imágenes, es posible que no puedas iniciar tus estaciones de trabajo. Aquí tienes algunas recomendaciones:

Se agota el tiempo de aprovisionamiento de la VM

Cuando creas estaciones de trabajo con tu configuración, Cloud Workstations crea una instancia de Compute Engine para respaldar tu estación de trabajo. Si se produce un error al aprovisionar tus máquinas virtuales, el mensaje de error que aparece es similar al siguiente:

Workstations using this configuration cannot be provisioned due to an unknown error.

Aquí tienes algunas recomendaciones:

Configurar Cloud NAT o habilitar el acceso privado de Google

Si has inhabilitado las direcciones IP públicas en tu configuración, usa una de las siguientes opciones:

  • Configura Cloud NAT para permitir que Cloud Workstations extraiga imágenes en tus VMs de estación de trabajo.

  • Habilita Acceso privado de Google en tu subred. Si usas los nombres de dominio private.googleapis.com o restricted.googleapis.com, crea registros DNS para dirigir el tráfico a las direcciones IP asociadas a esos dominios. En concreto, debes habilitar el acceso a los dominios de Artifact Registry y Container Registry, que corresponden respectivamente a *.pkg.dev y *.gcr.io.

Para obtener más información, consulta Configurar Acceso privado de Google > Configuración de red avanzada.

Comprueba que las APIs estén habilitadas y que se pueda acceder a ellas desde la VPC

Si tu proyecto está dentro de un perímetro de Controles de Servicio de VPC, asegúrate de que las APIs Cloud Storage, Container Registry y Artifact Registry sean accesibles a la nube privada virtual (VPC) dentro de tu perímetro de servicio.

Actualizar las reglas de cortafuegos para permitir la salida TCP

Asegúrate de permitir el tráfico de salida TCP en tu red a través de los puertos 80 y 443 para que Cloud Workstations pueda extraer imágenes a tu estación de trabajo.

Examina los registros de inicio de tu máquina virtual de Compute Engine para detectar posibles errores

Las VMs creadas por Cloud Workstations envían registros de depuración a la consola serie al iniciarse. Estos registros pueden ser útiles cuando el servicio agota el tiempo de espera al crear una VM. Los nombres de las VMs creadas para las estaciones de trabajo empiezan por workstations- seguido de un identificador único. Utiliza el siguiente filtro para filtrar los registros en el Explorador de registros:

SEARCH("workstations-")
sourceLocation.function="main.setupAndRunScript"

Si no ves ningún registro con este filtro, comprueba que hayas habilitado el registro del puerto serie en tu proyecto. Si has especificado una cuenta de servicio en la configuración de tu estación de trabajo, asegúrate de que tenga permiso logging.logEntries.create en el proyecto para que pueda escribir registros en Cloud Logging. Prueba a iniciar de nuevo tu estación de trabajo después de habilitar el registro del puerto serie y añadir los permisos necesarios para asegurarte de que la secuencia de comandos de inicio de la VM de Compute Engine se vuelve a ejecutar para generar los registros.

Revisa los registros de la API de Compute Engine para detectar posibles errores

Usa el siguiente filtro en tus registros de Stackdriver:

protoPayload.serviceName="compute.googleapis.com"
severity>=ERROR

Puede que los errores de la API de Compute Engine estén impidiendo la creación de tus máquinas virtuales de estación de trabajo.

Habilitar los atributos de invitado en un proyecto

Para facilitar el proceso de solución de problemas, asegúrate de que no hayas inhabilitado los atributos de invitado en tu proyecto. Cloud Workstations usa estos atributos para detectar determinados problemas al iniciar una estación de trabajo y los comunica como mensajes de depuración específicos en la configuración de la estación de trabajo.