En esta página, se brinda información para solucionar problemas con Cloud Workstations.
Extrae imágenes del sistema a las VMs
Cuando creas estaciones de trabajo con tu configuración, Cloud Workstations extraen imágenes del sistema a tu 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 las estaciones de trabajo. Estas son algunas recomendaciones:
- Configura Cloud NAT o habilita el Acceso privado a Google.
- Asegúrate de que las APIs estén habilitadas y que la VPC pueda acceder a ellas.
- Actualiza las reglas de firewall para permitir la salida de TCP.
- Examina los registros de inicio de la VM de Compute Engine para detectar posibles errores.
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
orestricted.googleapis.com
, crea registros DNS para dirigir el tráfico a las direcciones IP asociadas con esos dominios. Específicamente, 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 que la VPC pueda acceder a ellas
Si tu proyecto se encuentra 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 desde 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 extraigan imágenes a tu estación de trabajo.
Examina los registros de inicio de la VM de Compute Engine para detectar posibles errores
Si ninguno de los pasos anteriores resuelve el problema, es posible que puedas encontrar el motivo de la falla en los registros de la secuencia de comandos de inicio de la VM de Compute Engine. Los nombres de VM creados para tu configuración comienzan con CONFIG_NAME-
, seguido de un identificador único.
Usa el siguiente filtro para filtrar tus registros de Stackdriver:
SEARCH("CONFIG_NAME")
sourceLocation.function="main.setupAndRunScript"
Reemplaza lo siguiente:
CONFIG_NAME
: Es el nombre de la configuración de tu estación de trabajo.
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 tenga permiso logginglogEntries.create
en el proyecto para que pueda escribir registros en Cloud Logging. Vuelve a iniciar la estación de trabajo después de habilitar el registro del puerto en serie y agregar los permisos necesarios para asegurarte de que se vuelva a ejecutar la secuencia de comandos de inicio de la VM de Compute Engine para generar los registros.