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 correspondiente.
- 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 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 Activadores 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 Activadores 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, cuando un desarrollador de Looker envía una solicitud de extracción al repositorio de tu proyecto de LookML
- 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
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.
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 correspondiente.
- 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.