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 Cómo ver los resultados de la ejecución de integración continua.

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

Si habilitaste tu suite de CI con Trigger on pull requests from Looker, 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 las solicitudes de extracción solo a ciertas ramas de tu repositorio deben activar ejecuciones de CI automáticas).

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

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

Cómo 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 Run suite del paquete de CI que deseas ejecutar (si no tienes ningún paquete de CI para tu proyecto, puedes crear uno).

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

    • 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 dev. 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 completar la ejecución, 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 Run para el paquete que activaste. Una vez que se completen las pruebas de validación, la página Run mostrará los resultados de cada uno de los validadores. Puedes salir de la página Run mientras se ejecutan las pruebas de validación y, luego, volver a la página Run para ver los resultados.

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

Workspace

Cuando activarás una ejecución de CI de forma manual, puedes usar las opciones de Workspace para validar la versión de producción de tu repositorio o una rama de desarrollo de tu repositorio.

En la opción Production, si deseas 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 Default Production Branch de la sección Git Summary de la página Branch Management de la Project Settings:

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

  • Para ver las ramas de tu proyecto de LookML y para 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 Commit Changes & Push o seleccionar la opción Commit en el panel de acciones de Git del IDE.

Cómo volver 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 errores o se canceló), un usuario de Looker con el permiso see_ci puede activar manualmente una nueva ejecución de la CI desde el IDE de Looker:

  • Si vuelves a ejecutar una ejecución activada por una PR, la integración continua se ejecutará en 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 ejecutará en el estado de producción o en la rama HEAD en el momento de la nueva ejecución, lo que incluirá los commits posteriores que se hayan realizado desde la ejecución inicial de CI.

Además, si editaste el paquete de CI desde la ejecución inicial, una nueva ejecución incluirá los cambios que hayas realizado en él 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 Runs, haz clic en el botón View Run 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 redireccionará a la página Ejecutar para la nueva ejecución.

Consulta la página de documentación Cómo ver los resultados de la ejecución de 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 se está ejecutando, puedes hacerlo desde la página Run. Para ello, 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 Runs, haz clic en el botón View Run de la ejecución de CI que deseas cancelar.
  4. En la página Run de la ejecución seleccionada, haz clic en el botón Cancelar 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 Ejecutar.