Activadores de Cloud Build

Cloud Build usa activadores de compilación para habilitar la automatización de CI/CD. Puedes configurar activadores para escuchar eventos entrantes, como cuando se envía una confirmación nueva a un repositorio o cuando se inicia una solicitud de extracción y, luego, ejecuta automáticamente una compilación cuando llegan eventos nuevos. También puedes configurar activadores para compilar código en cualquier cambio en tu repositorio de código fuente o solo en cambios que coincidan con ciertos criterios.

En esta página, se proporciona una descripción general de cada tipo y sus capacidades asociados.

Activadores de eventos del repositorio

Cloud Build te permite ejecutar automáticamente compilaciones en eventos del repositorio, como solicitudes push o de extracción. Puedes conectar repositorios externos, como repositorios en GitHub o Bitbucket, a Cloud Build o usar código en Cloud Source Repositories para tus compilaciones. Si bien puedes conectar cualquier repositorio de código fuente a Cloud Build, este servicio proporciona activadores específicos de eventos de repositorio que puedes usar para integrar fácilmente sistemas de administración de código fuente (SCM) específicos. En esta sección, se analizan los activadores de eventos del repositorio disponibles.

Activadores de GitHub

Puedes crear activadores de GitHub para ejecutar automáticamente compilaciones en respuesta a eventos de repositorio, como solicitudes push o de extracción. Puedes ver el estado de compilación del activador en GitHub y Cloud Console. También puedes usar la app de GitHub de Cloud Build para conectar y compilar código en GitHub. Para obtener más información, consulta Cómo compilar repositorios desde GitHub.

Activadores de GitHub Enterprise

Puedes crear activadores para los repositorios alojados en una instancia de GitHub Enterprise, incluidas las instancias alojadas en un entorno local y a las que no se puede acceder a través de una conexión a Internet pública. Los activadores de GitHub Enterprise se pueden usar para ejecutar compilaciones en respuesta a envíos o solicitudes de extracción desde una instancia de GitHub Enterprise. Para obtener más información, consulta Compila repositorios desde GitHub Enterprise.

Activadores de Bitbucket Server

Puedes crear activadores para los repositorios alojados en una instancia de servidor de Bitbucket, incluidas las instancias alojadas en un entorno local. Puedes conectar tu repositorio de servidor de Bitbucket a Cloud Build varias veces con varias conexiones de host. Si quieres obtener más información sobre cómo crear activadores para ejecutar compilaciones en respuesta a eventos, consulta Compila repositorios desde Bitbucket Server.

Activadores del centro de datos de Bitbucket

Puedes crear activadores para los repositorios alojados en una instancia de centro de datos de Bitbucket, incluidas las instancias alojadas en un entorno local. Los activadores del centro de datos de Bitbucket se pueden usar para ejecutar compilaciones en respuesta a eventos como envíos de confirmación o solicitudes de extracción. Para obtener más información, consulta Cómo compilar repositorios desde el centro de datos de Bitbucket.

Activadores manuales

Puedes crear activadores manuales para ejecutar compilaciones de forma manual y anular los valores de variables de sustitución definidos en el momento de la invocación antes de ejecutar una compilación. También puedes configurar activadores manuales para que se ejecuten según un programa. Para obtener más información, consulta Crea activadores manuales.

Activadores de Pub/Sub

Puedes crear activadores de Pub/Sub para ejecutar compilaciones en respuesta a cualquier mensaje publicado en Pub/Sub. Por ejemplo, puedes usar los activadores de Pub/Sub para compilar en respuesta a los envíos de imágenes a Artifact Registry. En este caso, puedes configurar el activador para que use filtros a fin de ejecutar una compilación solo si la imagen enviada coincide con una etiqueta específica, como prod. Además, se pueden configurar los activadores de Pub/Sub para suscribirse a cualquier tema de Pub/Sub. Para obtener más información, consulta Crea activadores de Pub/Sub.

Activadores de webhook

Puedes crear activadores de webhook para ejecutar compilaciones en respuesta a webhooks. Los eventos de webhook que se envían a una URL personalizada te permiten conectar directamente sistemas externos y sistemas de administración de código fuente (SCM) externos, como Bitbucket.com, Bitbucket Server o GitLab, a Cloud Build. Cuando creas activadores de webhook, también puedes definir la configuración de tu compilación intercalada en tu activador para controlar qué repositorios clona tu activador durante el tiempo de compilación, en lugar de especificar de forma explícita una fuente. Para obtener más información, consulta Crea activadores de webhook. Además, si quieres aprender a usar activadores de webhook para compilar repositorios de SCM específicos, consulta Compila repositorios desde Bitbucket Server, Compila repositorios desde Bitbucket Cloud y Compila repositorios desde GitLab.

Capacidades de los activadores

Los activadores de Cloud Build proporcionan capacidades que te brindan un control detallado sobre cómo se ejecuta una compilación. En esta sección, se analizan varias funciones asociadas con los activadores.

Programa activadores manuales

Puedes programar activadores manuales para ejecutar automáticamente compilaciones según un programa predefinido. Por ejemplo, te recomendamos configurar un activador programado para ejecutar una compilación todos los sábados a las 6:00 a.m. A fin de programar las compilaciones, puedes crear un activador manual y, luego, invocarlo con Cloud Scheduler. Para obtener más información, consulta Crea activadores programados.

Cómo filtrar eventos

Cloud Build usa Common Expression Language (CEL) con la variable build en los campos enumerados en el recurso Build para acceder a los campos asociados con el evento de compilación, como el ID del activador, la lista de imágenes o los valores de sustitución. Puedes usar la string filter para filtrar eventos de compilación en el archivo de configuración de compilación mediante cualquier campo indicado en el recurso Build. Para obtener más información, consulta Cómo usar CEL para filtrar eventos de compilación.

Variables de sustitución

Puedes especificar variables de sustitución en tu archivo de configuración de compilación para sustituir valores específicos durante la compilación. Por ejemplo, es posible que quieras usar variables de sustitución si no se conoce un valor hasta el tiempo de compilación o si deseas volver a usar una solicitud de compilación existente con diferentes variables. Cloud Build proporciona sustituciones predeterminadas que puedes usar para las compilaciones que invocan los activadores, como las variables que se asignan al nombre del activador o del repositorio. También puedes definir tus propias variables de sustitución. Para obtener más información, consulta Sustituye valores de variables.

Expande los parámetros de Bash

Puedes aplicar expansiones de parámetros de Bash a valores de variables de sustitución. Las expansiones de parámetros de Bash te permiten manipular las strings asociadas con las variables existentes. Por ejemplo, puedes usar la expansión de parámetros de Bash para escribir letras mayúsculas o reemplazar una substring. Para obtener más información, consulta Expansións de parámetros de Bash.

Vinculaciones de carga útil

Puedes almacenar parte de la carga útil del evento del activador como una variable de sustitución mediante vinculaciones de carga útil. Las variables asociadas con una carga útil se denominan vinculaciones y están disponibles para las compilaciones que se invocan mediante eventos de envío y extracción. Puedes usar vinculaciones para acceder a datos adicionales relacionados con tu compilación, como el autor de una solicitud de extracción. Para obtener más información, consulta Vinculaciones de carga útil.

Aprobar compilaciones

Puedes configurar los activadores para que no ejecuten una compilación de inmediato, sino que marquen una compilación como pendiente hasta que se apruebe. Si un usuario con permisos aprueba una compilación pendiente, esta comenzará. Si se rechaza la aprobación, la compilación no se iniciará. Para obtener más información sobre cómo configurar activadores que requieren aprobación, consulta Cómo aprobar compilaciones.

Notificaciones de estado de compilación

Puedes configurar los notificadores de Cloud Build para escuchar las actualizaciones de eventos de compilación en el tema cloud-builds de Pub/Sub. Los notificadores también pueden filtrar los mensajes que recibe el tema y enviarlos al servicio que desees. Cloud Build proporciona y mantiene imágenes del notificador que se pueden implementar en el repositorio cloud-build-notifiers. Puedes configurar notificaciones con un notificador de Cloud Build, como BigQuery, HTTP, Slack o SMTP, o crea tu propio notificador.

¿Qué sigue?