Ayúdanos a definir el futuro de las operaciones de software y haz oír tu voz con la encuesta del estado de DevOps 2021.

Configura Cloud Debugger para PHP

Descripción general

En esta página se describe cómo configurar el entorno y la aplicación de PHP para usar Cloud Debugger. Para algunos entornos, debes especificar explícitamente el nivel de acceso a fin de permitir que el agente de Cloud Debugger envíe datos. Te recomendamos configurar el nivel de acceso más amplio posible y, luego, usar la Administración de identidades y accesos para restringir el acceso. De acuerdo con esta práctica recomendada, debes configurar el nivel de acceso para que estén todas las API de Cloud con la opción cloud-platform.

Versiones de lenguajes y entornos de procesamiento

El Depurador de Cloud está disponible para las versiones 7.0 y posteriores de PHP en los siguientes entornos de procesamiento:

Entorno de App Engine Standard Entorno flexible de App Engine Compute Engine Google Kubernetes Engine Cloud Run Cloud Run para Anthos en Google Cloud VM y contenedores que se ejecutan en otros lugares Cloud Functions

Configura Cloud Debugger

Para configurar Cloud Debugger, completa las siguientes tareas:

  1. Verifica que la API del Depurador de Cloud esté habilitada para tu proyecto.

  2. Instala y configura Debugger en el entorno de procesamiento que usas.

  3. Selecciona tu código fuente.

Verifica que la API de Cloud Debugger esté habilitada

Para comenzar a usar Cloud Debugger, asegúrate de que esté habilitada la API de Cloud Debugger. Cloud Debugger está habilitado de forma predeterminada para la mayoría de los proyectos.
Habilita la API de Cloud Debugger

Entorno flexible de App Engine

  1. Instala la extensión stackdriver_debugger desde PECL:

    pecl install stackdriver_debugger-alpha
    

    Si luego de ejecutar este paso el archivo php.ini no incluye extension=stackdriver_debugger.so, agrégala de forma manual.

  2. Agrega el paquete de Debugger para PHP de Google Cloud a tu archivo composer.json:

    composer require google/cloud-debugger
    
  3. Agrega la extensión de Cloud Debugger para PHP a través del archivo composer.json:

    composer require ext-stackdriver_debugger:*
    
  4. Configura enable_stackdriver_integrations en tu archivo app.yaml:

    runtime_config:
      enable_stackdriver_integration: true
    
  5. Habilita el agente.

    Agrega el siguiente código a la aplicación lo antes posible en la solicitud:

    use Google\Cloud\Debugger\Agent;
    
    $agent = new Agent(['sourceRoot' => realpath('/app')]);
    

Ahora puedes usar Debugger con tu app.

Google Kubernetes Engine

GCLOUD

Para habilitar Debugger con gcloud, completa los siguientes pasos:

  1. Crea tu clúster con uno de los niveles de acceso siguientes:

    • https://www.googleapis.com/auth/cloud-platform otorga a tu clúster acceso a todas las API de Google Cloud.

    • https://www.googleapis.com/auth/cloud_debugger otorga a tu clúster acceso solo a la API de Debugger. Usa este nivel de acceso para fortalecer la seguridad de tu clúster.

    gcloud container clusters create example-cluster-name \
           --scopes=https://www.googleapis.com/auth/cloud_debugger
    
  2. Instala la extensión de Cloud Debugger para PHP en tu contenedor. Si tiene instalado PECL, esto se puede hacer si agregas la línea siguiente a tu Dockerfile:

    RUN pecl install stackdriver_debugger_alpha
    
  3. Agrega el paquete de Debugger a tu aplicación mediante la ejecución del comando siguiente en tu aplicación:

    composer require google/cloud-debugger
    
  4. Agrega la línea siguiente a tu Dockerfile a fin de configurar un daemon para ejecutar el proceso de daemon de Debugger:

    RUN php /[YOUR-APP-PATH]/vendor/bin/google-cloud-debugger -s /[YOUR-APP-PATH]
    
  5. Agrega las líneas siguientes del código a tu app lo antes posible en la solicitud para habilitar el agente de Debugger:

    use Google\Cloud\Debugger\Agent;
    
    $agent = new Agent(['sourceRoot' => realpath('/[YOUR-APP-PATH]')]);
    

Ahora puedes usar el depurador cuando implementes tu app en contenedores.

CONSOLE

Para habilitar Debugger con Google Cloud Console, sigue estos pasos:

  1. En la sección Grupos de nodos, selecciona Seguridad y, luego, Configurar el acceso para cada API.

  2. Habilita Debugger.

    La API de Debugger está habilitada para el clúster.

  3. Opcional: Seleccione Permitir el acceso completo a todas las API de Cloud.

Compute Engine

  1. Asegúrate de que tus instancias de Compute Engine se creen con la opción de nivel de acceso Permitir el acceso total a todas las API de Cloud, o que tengan uno de los siguientes niveles de acceso:

    • https://www.googleapis.com/auth/cloud-platform
    • https://www.googleapis.com/auth/cloud_debugger
  2. Instala la extensión stackdriver_debugger desde PECL (si usas contenedores, instálala en la imagen):

    pecl install stackdriver_debugger-alpha
    
  3. Agrega el paquete de Debugger para PHP de Google Cloud a tu archivo composer.json:

    composer require google/cloud-debugger
    
  4. Configura un daemon para que ejecute el proceso de daemon de Debugger:

    php /[YOUR-APP-PATH]/vendor/bin/google-cloud-debugger -s /[YOUR-APP-PATH]
    
  5. Habilita el agente.

    Agrega el siguiente código a la aplicación lo antes posible en la solicitud:

    use Google\Cloud\Debugger\Agent;
    
    $agent = new Agent(['sourceRoot' => realpath('/[YOUR-APP-PATH]')]);
    

Ahora puedes usar Debugger con tu app.

En el entorno local y en otros lugares

  1. Instala la extensión stackdriver_debugger desde PECL:

    pecl install stackdriver_debugger-alpha
    
  2. Agrega el paquete de Debugger para PHP de Google Cloud a tu archivo composer.json:

    composer require google/cloud-debugger
    
  3. Ejecuta el proceso de daemon del Depurador de Cloud:

    php /[YOUR-APP-PATH]/vendor/bin/google-cloud-debugger -s /[YOUR-APP-PATH]
    
  4. Habilita el agente.

    Agrega el siguiente código a la aplicación lo antes posible en la solicitud:

    use Google\Cloud\Debugger\Agent;
    
    $agent = new Agent(['sourceRoot' => realpath('/[YOUR-APP-PATH]')]);
    

Ahora puedes usar Debugger con tu app.

En la página de Depuración en Cloud Console, se pueden mostrar los archivos de origen local, sin subir, para el desarrollo local. Consulta Selecciona el código fuente de forma manual.