Un paquete de integración continua (CI) es un conjunto de instrucciones de validación que se asocia con tu proyecto de LookML. Un usuario de Looker con el permiso manage_ci puede configurar lo siguiente en un paquete de CI:
- Cómo se activa una ejecución de validación de CI (de forma manual desde el IDE de Looker o automáticamente cuando se envía una solicitud de extracción a tu repositorio).
- Qué validadores de CI ejecutar
- 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 para 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).
Crea un paquete de CI
Puedes configurar y ejecutar los validadores en la página Paquetes del IDE de Looker:
Para crear un paquete 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 Paquetes para abrir la página Paquetes.
- En la página Paquetes, puedes crear un paquete nuevo o editar uno existente:
- Para crear un paquete nuevo, haz clic en el botón Crear paquete.
- Para editar un paquete existente, haz clic en el botón Editar paquete.
- Ingresa un nombre para el Nombre del paquete. 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 en función de un programa si deseas configurar pruebas de validación automáticas según una programación recurrente. Consulta la sección Activar en función de un programa 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 Activar en solicitudes de extracción de Looker de esta página para obtener más información.
Si habilitas la activación de solicitud de extracción para un paquete de CI, puedes usar el campo Solo para la rama de destino para especificar que las solicitudes de extracción solo a ramas específicas del repositorio deben activar una ejecución del paquete de CI. Consulta la sección Activar 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 Habilitar las alertas de 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 Configurar las alertas de esta página para obtener más información.
De forma 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:
Guarda los cambios:
- Si creas 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:
- Automáticamente, según una programación recurrente.
- Automáticamente, cuando se envía una solicitud de extracción al repositorio de tu proyecto de LookML por un desarrollador de Looker.
- Manualmente, con el botón Ejecutar paquete en la página Paquetes del IDE de Looker.
- Manualmente, 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 paquete de CI para que se active automáticamente según una programación habilitando el botón de activación Activar en función de un programa.
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 un día y hora específicos
- Semanalmente, 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, comenzando y terminando en horarios específicos del día
- Minutos cada 5, 10, 15, 20 o 30 minutos, comenzando y terminando en horarios específicos del día
- Meses específicos del año, en un día y hora 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 la activación automática en la 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, el administrador de Looker debe configurar tu repositorio de Git en la página de administración de Integración continua de Looker).
Si habilitas los activadores de solicitud de extracción para un paquete de CI, puedes especificar que las solicitudes de extracción solo a ramas específicas del repositorio deben activar 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 paquete 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 paquete 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 paquete de CI, sigue estos pasos cuando crees o edites un paquete 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 deben activar una alerta:
- Error: 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 de sistema o de configuración.
- Passed: Activa un correo electrónico cuando una ejecución de CI se completa correctamente.
- Cancelado: Activa un correo electrónico cuando se cancela una ejecución de CI.
Borra un paquete
Para borrar un paquete 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 Paquetes para abrir la página Paquetes.
- En la página Paquetes, haz clic en el botón Editar paquete.
- 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 paquete.