Cloud Build usa activadores de compilación para habilitar la automatización de CI/CD. Puedes y configurar activadores para detectar eventos entrantes, como cuando se inicia 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 para compilar código a partir de cualquier cambio en tu repositorio de código fuente o solo en cambios que coinciden con ciertos criterios.
En esta página, se proporciona una descripción general de cada tipo de activador y las capacidades asociadas. con activadores.
Activadores de eventos del repositorio
Cloud Build te permite ejecutar compilaciones automáticamente en el repositorio como envíos o solicitudes de extracción. Puedes conectar repositorios externos, como los repositorios de GitHub o Bitbucket, a Cloud Build el código en Cloud Source Repositories para tus compilaciones. Si bien puedes conectar cualquier repositorio de código fuente Cloud Build, que proporciona un repositorio específico activadores de eventos que puedes usar para integrar la administración de código fuente específico de la seguridad en la nube (SCM). En esta sección, se analizan los activadores de eventos de repositorio disponibles.
Activadores de GitHub
Puedes crear activadores de GitHub para ejecutar compilaciones automáticamente en respuesta a del repositorio, como envíos o solicitudes de extracción. Puedes consultar el estado del activador y el estado de compilación en GitHub y la consola de Google Cloud. 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 Compila 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 que no se pueden alcanzar 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 Cómo compilar repositorios desde GitHub Enterprise.
Activadores de GitLab Enterprise Edition
Puedes crear activadores para repositorios alojados en GitLab Enterprise Edition. de Compute Engine, incluidas las alojadas en una red privada. GitLab Enterprise Los activadores de edición pueden usarse para ejecutar compilaciones en respuesta a envíos de confirmación o solicitudes de extracción asociadas a tu repositorio de GitLab Enterprise Edition. Para para obtener más información, consulta Compila repositorios de GitLab Enterprise Edition.
Activadores de Bitbucket Server
Puedes crear activadores para los repositorios alojados en una instancia de Bitbucket Server. incluidas las instancias alojadas en un entorno local. Puedes conectar tu Repositorio de Bitbucket Server en Cloud Build varias veces con varias conexiones de host. Para obtener más información sobre cómo crear para ejecutar compilaciones en respuesta a eventos, consulta Compila repositorios de Bitbucket Server.
Activadores de Bitbucket Data Center
Puedes crear activadores para repositorios alojados en un centro de datos de Bitbucket. de Compute Engine, 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 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 de Bitbucket Cloud
Puedes crear activadores para repositorios alojados en Bitbucket Cloud. Bitbucket Los activadores de Cloud pueden usarse para ejecutar compilaciones en respuesta a eventos como confirmar envíos o solicitudes de extracción. Para obtener más información, consulta Compila repositorios de Bitbucket Cloud.
Activadores manuales
Puedes crear activadores manuales para ejecutar compilaciones de forma manual y anular las definiciones definidas. los valores de las variables de sustitución en el momento de la invocación antes de ejecutar una compilación. Tú también puedes configurar activadores manuales para ejecutar según un programa. Para obtener más información, consulta Compila código de forma manual en los 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
ejecutar una compilación solo si la imagen enviada coincide con una etiqueta específica, como prod
Además, los activadores de Pub/Sub pueden configurarse para suscribirse a
cualquier tema de Pub/Sub. Para obtener más información, consulta Cómo automatizar compilaciones en respuesta a eventos de Pub/Sub.
Activadores de webhooks
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 conectarte de forma directa y sistemas de administración de código fuente externo (SCM), como De Bitbucket.com, Bitbucket Server o GitLab, a Cloud Build. Cuándo con la creación de activadores de webhook, también puedes definir la configuración de compilación de forma intercalada en tu activador para controlar qué repositorios clona el activador durante la compilación tiempo en lugar de especificar explícitamente una fuente. Para obtener más información, consulta Automatiza las compilaciones en respuesta a eventos de webhook. Además, aprenderás a usar activadores de webhook para compilar repositorios SCM específicas, consulta Cómo compilar repositorios de Bitbucket Server. Compilar repositorios desde Bitbucket Cloud y Compila repositorios de GitLab.
Capacidades de los activadores
Los activadores de Cloud Build proporcionan capacidades que te entregan control sobre cómo se ejecuta una compilación. En esta sección, se analizan varios y capacidades asociadas a los activadores.
Activadores manuales programados
Puedes programar activadores manuales para ejecutar automáticamente compilaciones en un con un cronograma predefinido. Por ejemplo, puedes configurar un activador programado de ejecutar una compilación todos los sábados a las 6:00 a.m. Para programar compilaciones, puedes hacer lo siguiente: crear un activador manual y, luego, invocar el activador con Cloud Scheduler. Para obtener más información, consulta Programa compilaciones.
Filtra eventos
Cloud Build usa
Common Expression Language (CEL) con el
variable, build, en los campos enumerados en el
Compilar recurso para acceder
campos asociados con tu evento de compilación, como el ID del activador, la lista de imágenes
de sustitución de datos. Puedes usar la cadena filter para filtrar eventos de compilación en
tu archivo de configuración de compilación mediante cualquier campo enumerado en
Build. Para aprender
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 para sustituir valores específicos en el tiempo de compilación. Por ejemplo, es posible que quieras usa variables de sustitución si no se conoce un valor hasta el momento de la compilación o si debes reutilizar una solicitud de compilación existente con diferentes variables. Cloud Build proporciona sustituciones predeterminadas que puedes usar para compilaciones que invocan los activadores, como las variables que se asignan a tu activador o el nombre 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 cadenas asociadas con variables existentes. Por ejemplo, puedes usar expansiones de parámetros de Bash para escribir en mayúscula o reemplazar una subcadena. Para obtener más información, consulta Expansiones de parámetros de Bash.
Vinculaciones de carga útil
Puedes almacenar parte de la carga útil de eventos del 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 a través de 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.
Aprobaciones
Puedes configurar activadores para que no ejecuten una compilación de inmediato, sino que los marquen una compilación como pendiente hasta que se apruebe. Si un usuario con permisos aprueba un acceso compilar, la compilación comienza. Si se rechaza la aprobación, no se iniciará la compilación. Para aprender a configurar activadores que requieran aprobación, consulta Cómo restringir compilaciones a la espera de aprobación.
Notificaciones sobre el estado de la compilación
Puedes configurar los notificadores de Cloud Build para escuchar las actualizaciones de eventos de compilación desde el tema cloud-builds de Pub/Sub. Los notificadores también pueden filtrar los mensajes que recibe el tema y enviar mensajes a tus servicios conectados. Cloud Build proporciona y mantiene un notificador implementable
imágenes en la
Repositorio cloud-build-notifiers.
Puedes configurar notificaciones con un notificador de Cloud Build
como BigQuery,
HTTP:
Slack o
SMTP o
Crea tu propio notificador.