Soluciona problemas de Cloud Workstations

En esta página, se incluye información para solucionar problemas relacionados con Cloud Workstations.

Extrae imágenes del sistema en las VMs

Cuando creas estaciones de trabajo con la configuración de tu estación de trabajo, Cloud Workstations extrae imágenes del sistema en tu instancia de máquina virtual (VM) 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. Estas son algunas recomendaciones:

Se agotó el tiempo de espera para aprovisionar tu VM

Cuando creas estaciones de trabajo con tu configuración de estación de trabajo, Cloud Workstations crea una instancia de Compute Engine para respaldar tu estación de trabajo. Si hay un error en el aprovisionamiento de tus VMs, el mensaje de error que aparece es similar al siguiente:

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

Estas son algunas recomendaciones:

Configura Cloud NAT o habilita el Acceso privado a Google

Si inhabilitaste 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 las VMs de tu estación de trabajo.
  • Habilita el Acceso privado a 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 con esos dominios. En particular, debes asegurarte de 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 Configura el Acceso privado a Google > Configuración de red avanzada.

Asegúrate de que las APIs estén habilitadas y se pueda acceder a ellas desde la VPC

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

Actualiza las reglas de firewall para permitir la salida de TCP

Asegúrate de permitir la salida de TCP en tu red en los puertos 80 y 443 para permitir que Cloud Workstations extraiga imágenes a tu estación de trabajo.

Examina los registros de inicio de tu VM de Compute Engine para detectar posibles errores

Las VMs que crea Cloud Workstations generan registros de depuración en la consola en serie durante el inicio. Estos registros pueden ser útiles cuando se agota el tiempo de espera del servicio para crear una VM. Los nombres de las VM creadas para las estaciones de trabajo comienzan con workstations- seguido de un identificador único. Usa el siguiente filtro para filtrar tus registros en el Explorador de registros:

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

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

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

Usa el siguiente filtro para tus registros de Stackdriver:

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

Es posible que los errores de la API de Compute Engine estén bloqueando la creación de las VMs de tu estación de trabajo.

Habilita los atributos de invitado en tu proyecto

Para facilitar el proceso de solución de problemas, asegúrate de no haber inhabilitado los atributos de invitado en tu proyecto. Cloud Workstations usa estos atributos para detectar ciertos problemas cuando inicias una estación de trabajo y, luego, informa esos problemas como mensajes de depuración específicos en la configuración de la estación de trabajo.

Errores intermitentes de reenvío de backend

Si ves de forma intermitente errores del tipo "No se puede reenviar tu solicitud a un backend" cuando inicias una estación de trabajo, es posible que el servidor web de la estación de trabajo aún no se haya iniciado por completo.

Para resolver este problema, agrega verificaciones de preparación a la configuración de tu estación de trabajo. Una verificación de disponibilidad evita que la estación de trabajo informe que se inició hasta que el servidor en el puerto especificado esté listo para aceptar solicitudes.

Depura las estaciones de trabajo detenidas

Si tus estaciones de trabajo se detienen de forma inesperada, verifica los registros de la plataforma o los registros de salida del contenedor para determinar la causa. Estos registros pueden ayudar a identificar fallas de inicio de la estación de trabajo, apagados abruptos o errores generales.

Apagados simultáneos de estaciones de trabajo cuando se usa CMEK

Si todas tus estaciones de trabajo se cierran a la vez y la configuración de tu estación de trabajo usa claves de encriptación administradas por el cliente (CMEK), verifica que hayas configurado los permisos adecuados en tu CMEK.

En particular, verifica que el agente de servicio de Compute Engine (service-PROJECT_NUMBER@compute-system.) tenga el rol de encriptador/desencriptador de CryptoKey de Cloud Key Management Service (roles/cloudkms.cryptoKeyEncrypterDecrypter) en tu CMEK. Si el agente de servicio de Compute Engine no tiene los permisos necesarios para acceder a las claves, Compute Engine cierra automáticamente las VMs subyacentes. Para obtener más información, consulta Encripta recursos de estaciones de trabajo con CMEK.