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 la integración continua.

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

Si habilitaste tu paquete de CI con la opción Activar en solicitudes de extracción de Looker, la 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 automáticas de CI).

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

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

Activación automática según una programación

Si habilitaste tu paquete de CI con la opción Activar según una programación, la CI activará una ejecución de validación automáticamente según la programación que especifiques.

Para las ejecuciones de validación automática programada, la CI valida la versión de producción del repositorio y muestra todos los errores en esa versión.

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

Activación manual de 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 Paquetes para abrir la página Paquetes.
  3. Haz clic en el botón Ejecutar paquete para el 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 Activar una ejecución de forma manual, usa las opciones de Workspace para seleccionar la rama que deseas validar (consulta la sección Workspace para obtener más detalles):

    • Para validar la versión de producción de tu proyecto de LookML, haz clic en Producción.
    • Si deseas validar una rama de desarrollo de tu proyecto de LookML, haz clic en Modo de desarrollo. Usa el menú desplegable Rama para seleccionar qué rama de desarrollo 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 completarse, 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 Ejecutar para el paquete que activaste. Una vez que se completen las pruebas de validación, la página Ejecutar mostrará los resultados de cada uno de los validadores. Puedes salir de la página Ejecutar mientras se ejecutan las pruebas de validación y, luego, volver a la página Ejecutar para ver los resultados.

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

Workspace

Cuando activas manualmente una ejecución de CI, 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.

Para la opción Producción, 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 Rama de producción predeterminada de la sección Resumen de Git de la página Administración de ramas de la Configuración del proyecto:

Para la opción Modo de desarrollo, 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 debe enviarse a tu repositorio de LookML. En el IDE de Looker, eso significa que el desarrollador debe hacer clic en el botón Confirmar cambios y enviar o seleccionar la opción Confirmar en el panel Acciones de Git del IDE.

Volver a ejecutar manualmente una ejecución de CI anterior

Para 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 ejecución de CI desde el IDE de Looker:

  • Si vuelves a ejecutar una ejecución activada por una solicitud de extracción, la integración continua se ejecutará en la misma confirmación que la ejecución original.
  • Si vuelves a ejecutar una ejecución activada manualmente, la integración continua se ejecutará en el estado de producción o en el HEAD de la rama en el momento de la nueva ejecución, lo que incluirá cualquier confirmación posterior que se haya 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 realizaste en el paquete de CI 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 Ejecuciones, haz clic en el botón Ver ejecución para 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 devolverá 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 la integración continua para obtener información sobre cómo ver los resultados.

Cómo cancelar una ejecución de CI

Si deseas cancelar una ejecución de CI en curso, puedes hacerlo desde su página Ejecutar siguiendo 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 Ejecuciones, haz clic en el botón Ver ejecución para la ejecución de CI que deseas cancelar.
  4. En la página Ejecutar para 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 Cancelado en la página Ejecutar.