Activadores de Cloud Build

Cloud Build usa activadores de compilación para habilitar la automatización de CI/CD. Puedes configurar activadores para que detecten 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, ejecutar automáticamente una compilación cuando lleguen eventos nuevos. También puedes configurar activadores para compilar código en cualquier cambio que se realice en tu repositorio de código fuente o solo en los cambios que coincidan con ciertos criterios.

En esta página, se proporciona una descripción general de cada tipo de activador y las capacidades asociadas con los activadores.

Activadores de eventos de repositorio

Cloud Build te permite ejecutar compilaciones automáticamente en eventos de repositorio, como envíos o solicitudes 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, Cloud Build proporciona activadores de eventos de repositorio específicos que puedes usar para integrar sistemas de administración de código fuente (SCM) específicos. En esta sección, se analizan los activadores de eventos de repositorio disponibles.

Activadores de GitHub

Puedes crear activadores de GitHub para ejecutar compilaciones de forma automática en respuesta a eventos del repositorio, como envíos o solicitudes de extracción. Puedes ver el estado de la compilación del activador en GitHub y en la consola de Google Cloud . También puedes usar la app de GitHub de Cloud Build para conectarte 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 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 de una instancia de GitHub Enterprise. Para obtener más información, consulta Compila repositorios desde GitHub Enterprise.

Activadores de GitLab Enterprise Edition

Puedes crear activadores para repositorios alojados en una instancia de GitLab Enterprise Edition, incluidas las instancias alojadas en una red privada. Los activadores de GitLab Enterprise Edition se pueden usar para ejecutar compilaciones en respuesta a confirmaciones de envío o solicitudes de extracción asociadas con tu repositorio de GitLab Enterprise Edition. Para obtener más información, consulta Compila repositorios desde GitLab Enterprise Edition.

Activadores de Bitbucket Server

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

Activadores de Bitbucket Data Center

Puedes crear activadores para repositorios alojados en una instancia de Bitbucket Data Center, incluidas las instancias alojadas en un entorno local. Los activadores de Bitbucket Data Center se pueden usar para ejecutar compilaciones en respuesta a eventos, como envíos de confirmaciones o solicitudes de extracción. Para obtener más información, consulta Compila repositorios desde Bitbucket Data Center.

Activadores de Bitbucket Cloud

Puedes crear activadores para repositorios alojados en Bitbucket Cloud. Los activadores de Bitbucket Cloud se pueden usar para ejecutar compilaciones en respuesta a eventos, como envíos de confirmaciones o solicitudes de extracción. Para obtener más información, consulta Compila repositorios desde Bitbucket Cloud.

Activadores de Secure Source Manager

Puedes crear activadores para los repositorios alojados en Secure Source Manager. Los activadores de Secure Source Manager se pueden usar para ejecutar compilaciones en respuesta a eventos como envíos de confirmaciones o solicitudes de extracción. Para obtener más información, consulta Crea un archivo de activadores en Secure Source Manager.

Activadores manuales

Puedes crear activadores manuales para ejecutar compilaciones de forma manual y anular los valores de las 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 ejecutarlos según un programa. Para obtener más información, consulta Cómo compilar código de forma manual en repositorios de código fuente.

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 activadores de Pub/Sub para compilar en respuesta a envíos de imágenes a Artifact Registry. En este caso, puedes configurar el activador para que use filtros que ejecuten una compilación solo si la imagen enviada coincide con una etiqueta específica, como prod. Además, los activadores de Pub/Sub se pueden configurar para suscribirse a cualquier tema de Pub/Sub. Para obtener más información, consulta Automatiza compilaciones en respuesta a eventos de Pub/Sub.

Activadores de webhook

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

Activadores para repositorios vinculados a Developer Connect

Developer Connect te permite conectar productos externos o herramientas para desarrolladores que no son de Google a Google Cloud con pasos y apps estandarizados. Puedes configurar activadores que compilen desde repositorios conectados a través de Developer Connect para los siguientes SCM:

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 capacidades asociadas con los activadores.

Activadores manuales programados

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

Cómo filtrar eventos

Cloud Build usa Common Expression Language (CEL) con la variable build en los campos que se indican en el recurso Build para acceder a los campos asociados con tu evento de compilación, como el ID del activador, la lista de imágenes o los valores de sustitución. Puedes usar la cadena filter para filtrar eventos de compilación en tu archivo de configuración de compilación con cualquier campo que aparezca en el recurso Build. Para obtener más información, consulta Usa 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 reemplazar valores específicos en el momento de la compilación. Por ejemplo, es posible que desees usar variables de sustitución si no se conoce un valor hasta el momento de la compilación o si deseas volver a usar una solicitud de compilación existente con variables diferentes. 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 los valores de las variables de sustitución. Las expansiones de parámetros de Bash te permiten manipular cadenas asociadas con variables existentes. Por ejemplo, puedes usar expansiones de parámetros de Bash para poner letras en mayúscula o reemplazar una substring. Para obtener más información, consulta Expansiones de parámetros de Bash.

Vinculaciones de carga útil

Puedes almacenar parte de la carga útil del evento de tu activador como una variable de sustitución con vinculaciones de carga útil. Las variables asociadas con una carga útil se denominan vinculaciones y están disponibles para las compilaciones invocadas por 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 cargas útiles.

Aprobaciones

Puedes configurar activadores para que no ejecuten una compilación de inmediato, sino que la marquen como pendiente hasta que se apruebe. Si un usuario con permisos aprueba una compilación pendiente, esta se inicia. Si se rechaza la aprobación, la compilación no se inicia. Para aprender a configurar activadores que requieran aprobación, consulta Controla las compilaciones con aprobación.

Notificaciones de estado de la compilación

Puedes configurar los notificadores de Cloud Build para que escuchen las actualizaciones de eventos de compilación desde Pub/Sub en el tema predeterminado cloud-builds o en un tema definido por el usuario. Los notificadores también pueden filtrar los mensajes que recibe el tema y enviar mensajes a tus servicios conectados. Cloud Build proporciona y mantiene imágenes de notificador implementables en el repositorio cloud-build-notifiers. Puedes configurar notificaciones con un notificador de Cloud Build, como BigQuery, HTTP, Slack o SMTP, o crear tu propio notificador.

Cuentas de servicio para activadores de compilación

Cuando un activador invoca una compilación, Cloud Build ejecuta los pasos de compilación con una cuenta de servicio. Según la configuración del activador y la configuración de la política de la organización de tu proyecto, las compilaciones invocadas por activadores pueden usar una de las siguientes cuentas de servicio:

  • Cuenta de servicio especificada por el usuario (ACCOUNT_NAME@PROJECT_ID.): Recomendada. Tú creas y administras esta cuenta de servicio, y otorgas solo los permisos de Identity and Access Management (IAM) necesarios para la compilación del activador.
  • Cuenta de servicio predeterminada de Compute Engine (PROJECT_NUMBER-compute@): Es la cuenta de servicio de compilación predeterminada para los proyectos que ejecutaron su primera compilación después del cambio de la cuenta de servicio predeterminada, a menos que esté restringida por las políticas de la organización. En estos proyectos, debes seleccionar de forma explícita una cuenta de servicio (ya sea una cuenta de servicio especificada por el usuario o la cuenta de servicio predeterminada de Compute Engine) cuando crees o actualices un activador.
  • Cuenta de servicio heredada de Cloud Build (PROJECT_NUMBER@cloudbuild.): Se usa como la cuenta de servicio de compilación predeterminada en los proyectos que ejecutaron compilaciones antes del cambio de la cuenta de servicio predeterminada o en las organizaciones que inhabilitaron el cambio. En estos proyectos, si el campo serviceAccount de un activador se deja sin especificar, el activador usa de forma predeterminada la cuenta de servicio heredada de Cloud Build.

Antes de otorgar roles de IAM para los pasos de compilación de un activador, verifica qué cuenta de servicio está configurada en el activador. Para obtener instrucciones, consulta Identifica qué cuenta de servicio configurar.

¿Qué sigue?