Un conjunto de integración continua (CI) es un conjunto de instrucciones de validación asociadas a tu proyecto de LookML. Un usuario de Looker con el permiso manage_ci puede configurar lo siguiente en un conjunto de pruebas de CI:
- Cómo se activa una ejecución de validación de CI (manualmente desde el IDE de Looker o automáticamente cuando se envía una solicitud de extracción a tu repositorio)
- Validadores de CI que se ejecutarán.
- Son opciones adicionales para cada prueba de validación. Consulta las páginas de documentación de cada uno de los validadores para obtener más detalles:
Antes de comenzar
Antes de crear un paquete de CI, necesitas lo siguiente:
- Una instancia de Looker que cumpla con los requisitos de CI y que esté habilitada para CI.
- Una cuenta de usuario de Looker con el permiso
manage_ci(este permiso se incluye en el conjunto de permisos de administrador)
Cómo crear un paquete de CI
Puedes configurar y ejecutar los validadores en la página Suites del IDE de Looker:
Para crear un conjunto de pruebas de CI, sigue estos pasos:
- En el IDE de Looker, haz clic en el ícono de Integración continua en la barra de navegación del IDE.
- Haz clic en la pestaña Suites para abrir la página Suites.
- En la página Suites, puedes crear una suite nueva o editar una existente:
- Para crear un nuevo conjunto, haz clic en el botón Crear conjunto.
- Para editar un paquete existente, haz clic en el botón Editar paquete del paquete.
- Ingresa un nombre para el Nombre del conjunto. Si editas un paquete existente, puedes hacer clic en el ícono de lápiz para editar el nombre del paquete.
- (Opcional) Habilita el botón de activación Activar según una programación si deseas configurar pruebas de validación automáticas en un programa recurrente. Consulta la sección Activación según una programación de esta página para obtener más información.
(Opcional) Habilita el botón de activación Activar en solicitudes de extracción de Looker si deseas configurar pruebas de validación automáticas cada vez que un desarrollador de Looker envíe una solicitud de extracción a tu repositorio. Consulta la sección Cómo activar el paquete en solicitudes de extracción de Looker de esta página para obtener más información.
Si habilitas el activador de solicitud de extracción para un conjunto de pruebas de CI, puedes usar de forma opcional el campo Only for target branch para especificar que las solicitudes de extracción solo para ramas específicas del repositorio deben activar una ejecución del conjunto de pruebas de CI. Consulta la sección Cómo activar el paquete en solicitudes de extracción de Looker de esta página para obtener más información.
(Opcional) Activa el botón de activación Trigger on pull requests from dbt Cloud si deseas configurar pruebas de validación automáticas cada vez que se ejecute un trabajo de CI de dbt Cloud. Consulta la sección Activar en solicitudes de extracción de dbt Cloud de esta página para obtener más información.
(Opcional) Activa el botón de activación Habilitar alertas por correo electrónico si deseas recibir alertas por correo electrónico según el estado de una ejecución de CI. Consulta la sección Configura alertas de esta página para obtener más información.
De manera opcional, habilita los botones de activación del validador para activar un validador y configurar sus opciones. Consulta las páginas de documentación de cada uno de los validadores para obtener más detalles:
Sigue estos pasos para guardar los cambios:
- Si vas a crear un paquete nuevo, haz clic en el botón Crear paquete.
- Si editas un paquete existente, haz clic en el botón Actualizar paquete.
Activadores
Las ejecuciones de CI se pueden activar de varias maneras:
- De forma automática, según un programa recurrente
- Automáticamente, cuando un desarrollador de Looker envía una solicitud de extracción al repositorio de tu proyecto de LookML
- Automáticamente, cuando un trabajo de CI de dbt Cloud crea una solicitud de extracción.
- De forma manual, con el botón Ejecutar conjunto en la página Conjuntos del IDE de Looker
- De forma manual, volviendo a ejecutar una ejecución de CI anterior desde la página Ejecuciones del IDE de Looker
Activar en función de un programa
Puedes configurar un conjunto de pruebas de CI para que se active automáticamente según una programación habilitando el botón de activación Activar según una programación.
Cuando este botón de activación está habilitado, puedes seleccionar la frecuencia y los detalles para ejecutar automáticamente tu paquete de CI:
- Mensualmente, en una fecha y hora específicas
- Semanal, en un día y hora específicos
- Diariamente, a una hora específica
- Por hora o cada 2, 3, 4, 6, 8 o 12 horas, con inicio y finalización en horarios específicos del día
- Minutos cada 5, 10, 15, 20 o 30 minutos, con inicio y finalización en horarios específicos del día
- Meses específicos del año, en un día y horario específicos
- Días específicos de la semana a una hora específica
Activar en solicitudes de extracción de Looker
Para configurar un paquete de CI para que se active automáticamente en las solicitud de extracción, habilita el botón de activación Activar en solicitudes de extracción de Looker. Para usar la activación de solicitud de extracción, tu administrador de Looker debe configurar tu repositorio de Git en la página Integración continua de administrador de Looker.
Si habilitas los activadores de solicitud de extracción para un paquete de CI, puedes especificar de forma opcional que las solicitudes de extracción solo para ramas específicas del repositorio activen una ejecución del paquete de CI. Para limitar los activadores automáticos de solicitud de extracción de CI a ramas específicas de tu repositorio, ingresa una lista separada por comas de las ramas en el campo Solo para la rama de destino.
Por ejemplo, si un repositorio tiene tres ramas llamadas main, release_1 y dev, puedes ingresar main, release_1 en el campo Solo para la rama de destino. Esto significa que las ejecuciones de CI se activarán cuando un desarrollador de Looker envíe una solicitud de extracción a la rama main o release_1. Si un desarrollador de Looker envía una solicitud de extracción a la rama dev, no se activará una ejecución automática del conjunto de CI.
Activar en solicitudes de extracción de DBT en Cloud
Si configuraste la integración de dbt Cloud en tu instancia, puedes configurar un conjunto de CI para que se active automáticamente cuando finalice un trabajo de CI de dbt Cloud. El conjunto de pruebas de CI verifica si los cambios en tus modelos de dbt causarán errores de SQL en tus Exploraciones de Looker antes de que se implementen los cambios de dbt.
Para configurar este activador, habilita el botón de activación Activar en solicitudes de extracción de dbt Cloud cuando crees o edites un paquete de CI.
Cuando habilites este activador, configura las siguientes opciones:
Trabajo de dbt Cloud: Selecciona el trabajo de CI de dbt Cloud en el campo desplegable que debería activar este paquete.
Atributo de usuario del esquema: Selecciona el atributo de usuario de Looker que contiene el nombre del esquema para la conexión de tu base de datos. En esta lista, solo aparecerán los atributos del usuario que se hayan habilitado para la CI en el panel Administrador.
Cuando guardas el conjunto de pruebas con este activador habilitado, Looker registra automáticamente un webhook en tu cuenta de dbt Cloud para detectar las finalizaciones de trabajos.
En el caso de las ejecuciones activadas por dbt Cloud, Looker identifica de forma dinámica el esquema temporal creado por la ejecución de dbt Cloud y anula el atributo de usuario seleccionado con este nombre de esquema temporal durante la ejecución de CI.
Configurar las alertas
Para recibir alertas por correo electrónico según el estado de tus ejecuciones de CI, puedes configurar alertas para un conjunto de pruebas de CI. Esto te permite supervisar las ejecuciones de integración continua sin tener que consultar la página Ejecuciones en el IDE de Looker.
Para configurar alertas por correo electrónico para un conjunto de CI, sigue estos pasos cuando crees o edites un conjunto de CI:
- Habilita el botón de activación Habilitar las alertas de correo electrónico.
- En el campo Direcciones de correo electrónico, ingresa una lista separada por comas de las direcciones de correo electrónico que deben recibir las alertas.
- Usa las casillas de verificación para seleccionar los estados del trabajo que deberían activar una alerta:
- Failed: Se activa un correo electrónico cuando una ejecución de CI no pasa las pruebas de validación.
- Error: Activa un correo electrónico cuando una ejecución de CI encuentra un error del sistema o de configuración.
- Passed: Activa un correo electrónico cuando se completa correctamente una ejecución de CI.
- Cancelled: Se activa un correo electrónico cuando se cancela una ejecución de CI.
Cómo borrar un paquete
Para borrar un conjunto de pruebas de CI, sigue estos pasos:
- En el IDE de Looker, haz clic en el ícono de Integración continua en la barra de navegación del IDE.
- Haz clic en la pestaña Suites para abrir la página Suites.
- En la página Suites, haz clic en el botón Edit suite de la suite.
- En la página del paquete, haz clic en el botón Borrar paquete.
- En el diálogo de confirmación, haz clic en el botón Borrar suite.