Cómo ejecutar paquetes de integración continua

Las ejecuciones de integración continua (CI) se pueden activar de varias maneras:

Una vez que se completen las pruebas de validación, podrás revisar los resultados, como se describe en la página de documentación Visualiza los resultados de la ejecución de la integración continua.

Activación automática desde solicitudes de extracción

Si habilitaste tu paquete de CI con Activar en solicitudes de extracción de Looker, la CI activará una ejecución de validación automáticamente cuando un desarrollador de Looker envíe una solicitud de extracción a tu repositorio de LookML. (De manera opcional, puedes especificar que solo las solicitudes de extracción a ciertas ramas de tu repositorio activen ejecuciones automáticas de CI).

En el caso de las ejecuciones de validación automática de solicitudes de extracción, la CI valida la confirmación de la solicitud de extracción más reciente y devuelve todos los errores de esa versión del repositorio.

Consulta la página de documentación Visualiza los resultados de la ejecución de la integración continua para obtener información sobre cómo ver los resultados.

Activación automática desde solicitudes de extracción de proyectos importados

Si habilitaste tu paquete de CI en un proyecto downstream (radio) con Activar en solicitudes de extracción de proyectos importados, la CI activa una ejecución de validación automáticamente en el proyecto de radio cuando un desarrollador abre o actualiza una solicitud de extracción en el repositorio de un proyecto upstream (concentrador) suscrito.

Durante una ejecución de CI activada por una solicitud de extracción de un proyecto importado, Looker realiza las siguientes acciones:

  1. Valida la versión de producción del proyecto de radio mientras fija de forma temporal el proyecto de concentrador importado en la confirmación de la solicitud de extracción.
  2. Escribe el resultado de la ejecución de CI del proyecto de radio en la solicitud de extracción del repositorio del proyecto de concentrador.

Consulta la página de documentación Visualiza los resultados de la ejecución de la integración continua para obtener información sobre cómo ver los resultados.

Activación automática desde dbt Cloud

Si habilitaste tu paquete de CI con Activar en solicitudes de extracción de dbt Cloud, la CI activará una ejecución de validación automáticamente cuando finalice el trabajo de CI de dbt Cloud especificado.

Una ejecución de CI activada por un trabajo de CI de dbt Cloud está diseñada para verificar si los cambios de esquema realizados en dbt interrumpirán el contenido de LookML. Durante la ejecución, Looker realiza las siguientes acciones:

  1. Recibe la notificación de dbt Cloud cuando se completa el trabajo.
  2. Extrae los detalles del esquema temporal que creó dbt Cloud para esa ejecución específica.
  3. Anula el atributo de usuario configurado (por ejemplo, el atributo de esquema de tu conexión) con el nombre de este esquema temporal.
  4. Ejecuta los validadores de CI en este esquema temporal.

Esto te permite detectar cambios rotundos (como columnas descartadas o tablas con nombres cambiados) antes de que los cambios de dbt se combinen en producción. Una vez que finaliza la ejecución, el valor del atributo de usuario vuelve a su valor estándar para los usuarios de CI.

Activación automática según un programa

Si habilitaste tu paquete de CI con Activar según un programa, la CI activará una ejecución de validación automáticamente según el programa que especifiques.

En el caso de las ejecuciones de validación programadas automáticas, la CI valida la versión de producción del repositorio y devuelve todos los errores de esa versión.

Consulta la página de documentación Visualiza los resultados de la ejecución de la integración continua para obtener información sobre cómo ver los resultados.

Activar manualmente una nueva ejecución de un paquete de CI

Un usuario de Looker con el permiso see_ci puede activar manualmente una ejecución de CI desde el IDE de Looker.

Para activar manualmente una nueva ejecución de un paquete de CI, sigue estos pasos:

  1. En el IDE de Looker, haz clic en el ícono de Integración continua en la barra de navegación del IDE.
  2. Haz clic en Suites para abrir la página Suites.
  3. Haz clic en el botón Ejecutar paquete del paquete de CI que quieras ejecutar (si no tienes ningún paquete de CI para tu proyecto, puedes crear uno).

  4. En el cuadro de diálogo Activar una ejecución de forma manual, usa las opciones de Espacio de trabajo para seleccionar la rama que deseas validar (consulta la sección Espacio de trabajo para obtener más detalles):

    • Para validar la versión de producción de tu proyecto de LookML, haz clic en Producción.
    • Si quieres validar una rama de desarrollo de tu proyecto de LookML, haz clic en Modo de desarrollo. Usa el menú desplegable Rama para seleccionar la rama de desarrollo que deseas validar.

  5. Para activar la ejecución del paquete de CI, haz clic en Iniciar ejecución.

El paquete de CI puede tardar varios minutos en completarse, según el tamaño de tu proyecto, los validadores que se incluyen en el paquete de CI y la configuración del paquete de CI.

Después de activar una ejecución, el IDE de Looker mostrará la página Ejecutar del paquete que activaste. Una vez que se completen las pruebas de validación, en la página Run, se mostrarán los resultados de cada uno de los validadores. Puedes salir de la página Ejecutar mientras se ejecutan las pruebas de validación y, luego, volver a la página Ejecutar para ver los resultados.

Consulta la página de documentación Visualiza los resultados de la ejecución de la integración continua para obtener información sobre cómo ver los resultados.

Espacio de trabajo

Cuando activas manualmente una ejecución de CI, puedes usar las opciones de Espacio de trabajo para validar la versión de producción de tu repositorio o una rama de desarrollo de tu repositorio.

En el caso de la opción Producción, si quieres identificar qué rama o confirmación se usa para la versión de producción, puedes buscar en el IDE de Looker en el campo Rama de producción predeterminada de la sección Resumen de Git de la página Administración de ramas de la Configuración del proyecto:

En la opción Modo de desarrollo, ten en cuenta lo siguiente para validar las ramas de desarrollo en tu proyecto:

  • Para ver las ramas de tu proyecto de LookML y, además, identificar la rama de producción y las ramas personales de tus desarrolladores, consulta la página Administración de ramas de la Configuración del proyecto de tu proyecto en el IDE de Looker.
  • Para validar una rama de desarrollo, esta se debe enviar a tu repositorio de LookML. En el IDE de Looker, eso significa que el desarrollador debe hacer clic en el botón Confirmar cambios y enviar o seleccionar la opción Confirmar en el panel Acciones de Git del IDE.

Vuelve a ejecutar manualmente una ejecución de CI anterior

En el caso de las ejecuciones que finalizaron (si la ejecución se aprobó, falló, tuvo un error o se canceló), un usuario de Looker con el permiso see_ci puede activar de forma manual una nueva ejecución de la ejecución de CI desde el IDE de Looker:

  • Si vuelves a ejecutar una ejecución activada por una solicitud de extracción (que se activa por una solicitud de extracción en el repositorio del proyecto o en un proyecto importado), la integración continua se ejecuta con la misma confirmación que la ejecución original.
  • Si vuelves a ejecutar una ejecución activada de forma manual, la integración continua se ejecuta en el estado de producción o en la HEAD de la rama en el momento de la nueva ejecución, lo que incluirá las confirmaciones posteriores que se hayan realizado desde la ejecución inicial de la CI.

Además, si editaste el paquete de CI desde la ejecución inicial, la nueva ejecución incluirá los cambios que hayas realizado en el paquete de CI desde la ejecución inicial.

Para volver a ejecutar una ejecución de CI, sigue estos pasos:

  1. En el IDE de Looker, haz clic en el ícono de integración continua en la barra de navegación del IDE.
  2. Haz clic en Ejecuciones para abrir la página Ejecuciones.
  3. En la página Ejecuciones, haz clic en el botón Ver ejecución de la ejecución de CI que deseas cancelar.
  4. En la página de resultados de la ejecución seleccionada, haz clic en el botón Volver a ejecutar en la parte superior de la página.

Una vez que hagas clic en Volver a ejecutar, el Validador de contenido iniciará la ejecución y te llevará a la página Ejecutar para la nueva ejecución.

Consulta la página de documentación Visualiza los resultados de la ejecución de la integración continua para obtener información sobre cómo ver los resultados.

Cómo cancelar una ejecución de CI

Si quieres cancelar una ejecución de CI que está en curso, puedes hacerlo desde su página Ejecución siguiendo estos pasos:

  1. En el IDE de Looker, haz clic en el ícono de Integración continua en la barra de navegación del IDE.
  2. Haz clic en Ejecuciones para abrir la página Ejecuciones.
  3. En la página Ejecuciones, haz clic en el botón Ver ejecución de la ejecución de CI que deseas cancelar.
  4. En la página Ejecutar de la ejecución seleccionada, haz clic en el botón Cancelar que se encuentra en la parte superior de la página.

Una vez que hagas clic en Cancelar, la integración continua cancelará la ejecución y mostrará el estado Cancelada en la página Ejecución.