Depura un servicio de Cloud Run en Cloud Code para VS Code

Cloud Code para VS Code te permite depurar fácilmente una aplicación implementada en Cloud Run aprovechando skaffold debug Para obtener información detallada sobre la depuración de Skaffold, consulta Cómo depurar con Skaffold.

No es necesario completar la configuración manual, como la redirección de puertos Insertar argumentos de depuración específicos del lenguaje. La depuración requiere un Aplicación de Cloud Run lista para Cloud Code que incluye un archivo de configuración skaffold.yaml y un archivo launch.json de escribe cloudcode.cloudrun.

Depura tu servicio de Cloud Run

Para depurar tu servicio, sigue estos pasos:

  1. Para ejecutar el servicio y adjuntar una sesión del depurador, abre la paleta de comandos (presiona Ctrl/Cmd+Shift+P o haz clic en Ver > Paleta de comandos) y, luego, ejecuta el comando Depurar en un emulador de Cloud Run.

  2. En el cuadro de diálogo Ejecutar/Depurar en un emulador de Cloud Run, establece las especificaciones para tu configuración:

    • Elige Docker o Buildpacks como compilador y, luego, especifica Dockerfile o Buildpack.
    • (Opcional) Para especificar un destino de Dockerfile o argumentos de compilación, haz clic en Show Advanced Build Settings y especifica el destino o argumentos.
    • Opcional: Para especificar un nombre de servicio personalizado, la URL de la imagen del contenedor, el puerto del contenedor, la identidad que usará el servicio, la cantidad de CPUs dedicadas o la cantidad de memoria que se asignará a cada instancia de contenedor, haz clic en Mostrar configuración avanzada del servicio y, luego, especifica los valores.
    • (Opcional) Especificar cualquier variables de entorno Haz clic en Show Advanced Service Settings, en Environment Variables y y especifica los valores.
    • (Opcional) Para especificar conexiones de Cloud SQL, haz clic en Conexiones. y especifica una conexión por línea.
    • (Opcional) Para que VS Code restablezca una sesión de depuración después de guardar una en el código, revisa el Casilla de verificación Volver a compilar y ejecutar de manera automática los cambios.

    Si quieres personalizar aún más la ejecución de tu servicio, puedes editar tu archivo launch.json directamente.

  3. Para comenzar a depurar tu servicio, haz clic en Debug.

  4. Si se te solicita, autentica tus credenciales para ejecutar y depurar una aplicación de forma local.

  5. Para cada contenedor depurable en tu servicio, confirma o ingresa el directorio en el contenedor remoto donde se encuentra el programa que deseas depurar.

    También puedes presionar ESC para omitir la depuración de un contenedor.

    Solicitud raíz remoto

    Cloud Code adjunta una sesión de depuración para cada depuración contenedor en el servicio.

    De forma predeterminada, cuando guardas un cambio en tu aplicación, Cloud Code vuelve a implementarla y configura una nueva sesión de debugging. Puedes activar o desactivar esta función con la marca watch en el bucket iniciar la configuración.

  6. Para agregar un punto de interrupción, haz clic en el margen del editor del archivo que estás depurando.

    Los círculos rellenos de color rojo indican las interrupciones activas y los círculos vacíos de color gris indican los puntos de interrupción inhabilitados.

    Para un control de interrupciones más preciso, puedes usar la sección de interrupciones en la vista de depuración de VS Code.

    Sección de interrupciones en el panel izquierdo de la vista de depuración que permite agregar, quitar y, también, inhabilitar interrupciones

    Cada vez que envíes una solicitud nueva a tu servicio, se detendrá en la línea que especificaste.

  7. Cuando se complete la sesión, haz clic con el botón derecho para usar los siguientes comandos:

    • Ver registros: Abre los registros de la aplicación de un con el Explorador de registros de Cloud Code
    • Open URL: Abre la URL de servicio de la aplicación de un servicio en un navegador web
  8. Si desactivaste el modo de observación en la configuración de lanzamiento y deseas realizar cambios en la aplicación y volver a compilar y a implementar la aplicación, haz clic en la barra de estado de Cloud Code y, luego, en Activar el modo de observación.

  9. Si quieres inspeccionar variables y la información de la pila, usa el Barra lateral de depuración. Usa la consola de depuración ubicada en el depurador del panel inferior si deseas interactuar con la sesión de depuración.

  10. Para detener la implementación, haz clic en el botón Detener en la barra de acciones de la implementación actual.

    Barra de acciones para la implementación de Cloud Run

Soluciona problemas de compilación de contenedores

Si recibes el código de error BUILD_DOCKER_UNKNOWN, significa que hay un problema con Docker. Para resolver este problema, realiza una o más de las siguientes tareas:

  • Reinicia Docker y vuelve a intentar compilar el contenedor.

  • Si sigues recibiendo el mismo error después del reinicio, es posible que Docker se esté quedando sin espacio en el disco. Para obtener más información sobre cómo limpiar objetos que no se usan en Docker, consulta Cómo eliminar objetos de Docker que no se usan.

  • Prueba la extensión Disk Usage de Docker para recuperar espacio.

Detalles de configuración

Cloud Code controla la siguiente configuración específica de lenguaje detalles:

Node.js

Reescribe el punto de entrada que se invocará:

node --inspect=localhost:9229

Python

Instala el módulo ptvsd mediante un contenedor de inicialización y reescribe el punto de entrada que se invocará:

python -m ptvsd --host localhost --port 5678

Go

Instala el depurador dlv mediante un contenedor Init y reescribe el punto de entrada de modo que la sesión de depuración iniciada se ejecute solo con un servidor de depuración (en modo sin interfaz gráfica) continúa el proceso de depuración en el inicio, acepta varias conexiones de clientes y escucha en localhost:56268:

dlv exec --headless --continue --accept-multiclient --listen=localhost:56268 --api-version=2, <app> --

Java

Agrega un entorno JAVA_TOOLS_OPTIONS con la depuración de Java adecuada configuración del protocolo Wire (JDWP), de modo que el agente de depuración de JDWP escuche para una conexión de socket en el puerto 5005 y permite que la VM comience a ejecutarse antes de adjuntar el depurador:

jdwp=transport=dt_socket,server=y,suspend=n,address=5005,quiet=y

.NET

Las aplicaciones de .NET Core se configuran para implementarse junto con vsdbg para VS Code.

Si tienes problemas con la configuración automática, consulta Configuración detallada del depurador para obtener ayuda con la solución de problemas.

Obtener asistencia

Para enviar comentarios, informa problemas en GitHub o haz preguntas en Stack Overflow.