Un paquete de integración continua (CI) es un conjunto de instrucciones de validación asociadas 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.
- 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 información:
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 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 Suites para abrir la página Suites.
- 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 de la suite. Si estás editando 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 Trigger on pull requests from Looker si deseas configurar pruebas de validación automática 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 el activación de solicitud de extracción para un paquete de CI, puedes usar de forma opcional 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 activarlo y configurar sus opciones. Consulta las páginas de documentación de cada uno de los validadores para obtener más información:
Guarda los cambios:
- Si estás creando un paquete nuevo, haz clic en el botón Crear paquete.
- Si estás editando 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, cuando un desarrollador de Looker envía una solicitud de extracción al repositorio de tu proyecto de LookML.
- De forma manual, con el botón Run suite en la página Suites del IDE de Looker
- De forma manual, vuelve a ejecutar una ejecución de CI anterior desde la página Runs del IDE de Looker.
Para configurar un paquete de CI para el activación automática en solicitud de extracción, habilita el botón de activación Trigger on pull requests from Looker. Para usar el activador de solicitud de extracción, el administrador de Looker debe configurar tu repositorio de Git en la página Administrador de integración continua de Looker.
Si habilitas activadores de solicitud de extracción para un paquete de CI, de forma opcional, 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 de solicitud de extracción automáticas de las ejecuciones 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 con los nombres 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.
Cómo borrar 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 Suites para abrir la página Suites.
- En la página Suites, haz clic en el botón Editar 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.