Depurar una instancia

Nota: Esta guía se aplica a todos los entornos de ejecución en el entorno flexible, excepto .NET.

Puedes habilitar el modo de depuración para una VM. En el modo de depuración, los principales que tienen las funciones de propietario, editor y administrador de App Engine en el proyecto tienen acceso raíz a la VM. Mientras el modo de depuración está activado, el lanzamiento automático de las actualizaciones del sistema operativo y los parches de seguridad están inhabilitados. Sin embargo, la VM continúa siendo parte del grupo del balanceador de cargas y sigue recibiendo solicitudes externas.

Cada vez que habilites o inhabilites la depuración, aparecerá el evento “VM instance debugging enable/disable” en la consola de Google Cloud, y el evento se registrará en el archivo /var/log/syslog.log de la VM.

Importante: Todos los cambios realizados en la VM mientras está en el modo de depuración son temporales, ya que cuando se inhabilita el modo de depuración, estos se pierden. Las VM que se depuran de forma periódica se reinician, lo que puede dificultar la depuración de tareas prolongadas.

Habilita o inhabilita el modo de depuración

Puedes habilitar o inhabilitar el modo de depuración para una instancia mediante gcloud. Para depurar una instancia, tu rol debe contener el permiso appengine.instances.enableDebug.

Nota: Para habilitar el modo de depuración en la consola de Google Cloud, debes conectarte mediante SSH.

Para inhabilitar y habilitar el modo de depuración en gcloud, haz lo siguiente:

1. Usa el comando gcloud app instances enable-debug para depurar las VM de una instancia y versión en particular de la siguiente manera:

   gcloud app --project PROJECT-ID instances enable-debug

   Reemplaza PROJECT-ID por tu propio ID del proyecto y sigue las indicaciones para especificar la versión de la instancia que deseas depurar.
2. Cuando termine la depuración, inhabilita el modo de depuración de la siguiente manera:

   gcloud app --project PROJECT-ID instances disable-debug

   Sigue las indicaciones para especificar la versión de la instancia

Cuando inhabilitas el modo de depuración, la VM se detiene y se inicia una nueva instancia de tu aplicación, que se ejecuta en una VM nueva y limpia.

Conéctate a la instancia

Console

Nota: Si Acceso al SO está habilitado en los metadatos del proyecto, usa gcloud CLI para conectarte a la instancia.

Para conectarte a una instancia en la consola:

1. Ve a la página Instancias (Instances) de consola de Google Cloud del proyecto:

   Ir a la página de instancias

2. Haz clic en SSH en el extremo derecho de la fila que contiene la instancia a la que deseas acceder:

   

   Esto pone la instancia en modo de depuración y abre una sesión de SSH para la instancia en una ventana de la terminal.

   También puedes seleccionar opciones diferentes para iniciar una sesión SSH desde la lista desplegable.

3. Ahora te encuentras en el host de la instancia, en el que se ejecutan varios contenedores. Consulta Información sobre los contenedores comunes para obtener más información al respecto.

4. En la ventana de la terminal, se muestran los contenedores que se ejecutan en la instancia:

   sudo docker ps

5. Mediante el resultado del comando sudo docker ps, se enumera cada contenedor por fila. Ubica la fila que contiene el ID del proyecto: este es el contenedor que ejecuta tu código. Presta atención al NOMBRE de este contenedor.

6. Si lo deseas, invoca el siguiente comando para mostrar la información de registro de tu aplicación:

   sudo docker logs CONTAINER-NAME

7. Inicia una shell en el contenedor que ejecuta tu código:

   sudo docker exec -it CONTAINER-NAME /bin/bash

8. Cuando termines la depuración, ingresa exit para salir del contenedor y, luego, exit otra vez a fin de salir de la sesión de SSH.

9. Inhabilita la depuración de tu instancia para permitir que se reanude su funcionamiento normal.

gcloud

Para conectarte a una instancia con gcloud, realiza lo siguiente:

1. Con la instancia habilitada para la depuración, invoca el comando:

   gcloud beta app instances --project PROJECT-ID ssh INSTANCE-NAME --service SERVICE --version VERSION

2. Ahora te encuentras en el host de la instancia, que tiene varios contenedores en ejecución. Consulta Información sobre los contenedores comunes para obtener más información al respecto.

3. En la ventana de la terminal, se muestran los contenedores que se ejecutan en la instancia:

   sudo docker ps

4. Mediante el resultado del comando sudo docker ps, se enumera cada contenedor por fila. Ubica la fila que contiene el ID del proyecto: este es el contenedor que ejecuta tu código. Presta atención al NOMBRE de este contenedor.

5. Si lo deseas, invoca el siguiente comando para mostrar la información de registro de tu aplicación:

   sudo docker logs CONTAINER-NAME

6. Inicia una shell en el contenedor que ejecuta tu código:

   docker exec -it CONTAINER-NAME /bin/bash

7. Cuando termines la depuración, ingresa exit para salir del contenedor y, luego, exit otra vez a fin de salir de la sesión de SSH.

8. Inhabilita la depuración de tu instancia para permitir que se reanude su funcionamiento normal.

Información sobre los contenedores comunes

Además del contenedor que ejecuta el código de tu aplicación, tu instancia también puede tener los siguientes contenedores:

Contenedor y código fuente	Descripción
cloud-sql	Asegura las conexiones seguras a tu instancia de Cloud SQL.
fluentd_logger	Agente de Logging.
nginx_proxy	Envía las solicitudes a la aplicación a través de un proxy.
opentelemetry-collector	Recibe, procesa y exporta datos de telemetría.
stackdriver-monitoring-agent	Recopila, almacena y supervisa la información del sistema.

Ten en cuenta que estos contenedores de sidecars están sujetos a cambios sin previo aviso.