Automatiza compilaciones con activadores de compilación

Los activadores de compilación indican a Cloud Build que compile tu imagen de manera automática cada vez que se envíen cambios a la fuente de compilación. Puedes configurar un activador de compilación para volver a compilar tus imágenes por cualquier cambio en el repositorio fuente o solo cambios coincidentes con ciertos criterios.

Los activadores de compilación ayudan a garantizar que las imágenes de tu contenedor se basen siempre en la versión más reciente del código fuente. También son útiles para compilar y probar ramas de características antes del lanzamiento o con el fin de automatizar los flujos de trabajo que producen las imágenes de tu contenedor.

En esta página, se explica cómo crear activadores de compilación.

Antes de comenzar

Crea un activador de compilación

Para crear un activador de compilación nuevo, sigue estos pasos:

  1. Abre la página de activadores de compilación en Google Cloud Platform Console.

    Abrir la página de activadores de compilación

  2. Selecciona tu proyecto y haz clic en Abrir.

  3. Haz clic en Agregar activador.

  4. Selecciona uno de los repositorios siguientes de host para tu fuente de compilación:

    • Cloud Source Repositories
    • Bitbucket
    • GitHub

    A fin de compilar tu fuente en un repositorio de Git, Cloud Build realiza una clonación superficial del repositorio. Esto significa que solo la confirmación única que activó la compilación se verifica en el lugar de trabajo para compilar. Cloud Build no verifica ninguna otra rama o historia. Esto se hace a fin de aumentar la eficiencia, así las compilaciones no tienen que esperar a que se recupere el repositorio y la historia completa solo para compilar una confirmación única.

    Si deseas incluir más de la historia de tu repositorio en la compilación, agrega un paso de compilación a tu archivo de configuración de compilación de modo que la clonación deje de ser superficial. Por ejemplo:

        steps:
        - name: gcr.io/cloud-builders/git
          args: ['fetch', '--unshallow']
        ...
    

    Para obtener más información sobre git fetch, consulta la referencia de git. Si quieres obtener instrucciones sobre cómo escribir un archivo de configuración de compilación, consulta Descripción general de la configuración de compilación.

  5. Haz clic en Continuar.

  6. De la lista de repositorios disponibles, selecciona el repositorio deseado y, luego, haz clic en Continuar.

  7. Ingresa las opciones de configuración de activación siguientes:

    • Nombre: un nombre para tu activador.

    • Tipo de activador: Puedes configurar un activador para que inicie una compilación con las confirmaciones de una rama en particular o con las confirmaciones que contienen una etiqueta específica. Cualquiera sea el caso, puedes especificar una expresión regular con el valor de la rama o de la etiqueta para que coincidan. Para obtener información acerca de la sintaxis de expresión regular aceptable, consulta la sección sobre la sintaxis RE2.

    • Archivos incluidos (opcional): Los cambios en estos archivos activarán una compilación. Puedes usar las strings glob para especificar varios archivos con caracteres comodín. Los caracteres comodín aceptables incluyen los caracteres compatibles con Go Match, ** y alternación.

    • Archivos ignorados (opcional): Los cambios en estos archivos no activarán una compilación. Puedes usar las strings glob para especificar varios archivos con caracteres comodín. Los caracteres comodín aceptables incluyen los caracteres compatibles con Go Match, ** y alternación.

      Cada vez que envías un cambio a tu fuente, Cloud Build busca en tus archivos modificados los archivos incluidos y los ignorados para determinar si una compilación se tiene que activar:

      • Si envías un cambio a tu repositorio sobre una rama existente, Cloud Build observa los archivos modificados entre la confirmación recién enviada y la confirmación a la que apuntaba la rama antes.

      • Si envías un cambio a una rama o etiqueta recién creada, Cloud Build trata a todos los archivos en el repositorio como archivos modificados.

      • Si borras una rama o etiqueta, Cloud Build no activa una compilación.

    • Configuración de compilación: El Dockerfile o el archivo de configuración de compilación (ubicado en el repositorio remoto) que se debe usar para cada compilación que inicia el activador.

      Si quieres que usar tu configuración de compilación use un Dockerfile, tendrás que especificar el directorio del Dockerfile y suministrar un nombre para la imagen resultante.

      Cuando hayas proporcionado el Dockerfile y el nombre de la imagen, verás una vista previa del comando docker build que se ejecutará en tu compilación y un resumen de la configuración del activador. Haz clic en Crear activador para guardar el activador de compilación.

      A fin de usar un archivo de configuración de compilación para la configuración de tu compilación, tienes que proporcionar la ubicación de un archivo de configuración de compilación.

      Una vez que hayas establecido la ubicación, verás un resumen del activador. Haz clic en Crear activador para guardar el activador de compilación.

Prueba un activador de compilación

Para probar un activador de compilación de forma manual, haz clic en Ejecutar activador en la entrada de tu activador en la lista de activadores.

Omite un activador de compilación

En algunos casos, es posible que quieras realizar un cambio a tu código fuente, pero que no quieras activar una compilación. Por ejemplo, tal vez no quieras activar una compilación cuando actualizas documentación o archivos de configuración.

En esas situaciones, puedes incluir [skip ci] o [ci skip] en el mensaje de confirmación y, de esta forma, no se activará una compilación.

Si quieres ejecutar una compilación en esa confirmación más tarde, usa el botón Ejecutar activador.

Pasos siguientes

¿Te ha resultado útil esta página? Enviar comentarios:

Enviar comentarios sobre...