Automatiza las compilaciones con Cloud Build

En este tema, se describe cómo automatizar las compilaciones con Cloud Build y Cloud Source Repositories.

Puedes configurar Cloud Build para generar automáticamente una imagen nueva cada vez que un usuario envíe un cambio a los archivos almacenados en Cloud Source Repositories. Los eventos que inician compilaciones automáticas se denominan activadores de compilación. Estos activadores pueden ayudar a garantizar que las imágenes de tus contenedores se mantengan actualizadas. También puedes usarlos para compilar y probar ramas de características.

Antes de comenzar

Además de estos requisitos previos, puedes encontrar útil la siguiente información:

  • Los activadores de compilación usan clonaciones superficiales de un repositorio. Con las clonaciones superficiales, solo la confirmación única que activó la compilación se verifica en el área de trabajo para compilar. Para obtener más información sobre cómo incluir más de tu historial de repositorios, consulta Crea clonaciones no superficiales.

  • Si usas otro proveedor de Git alojado, como GitHub o Bitbucket, y aún no has duplicado el repositorio en Cloud Source Repositories, debes tener el permiso cloudbuilds.builds.create para el proyecto de Google Cloud Platform con el que trabajas. Este permiso se suele otorgar a través de la función cloudbuild.builds.editor.

    Cuando configuras un activador de compilación con un repositorio externo por primera vez, deberás configurar la autorización con ese repositorio. Para obtener más información, consulta Agrega un repositorio como remoto.

    Una vez que hayas configurado tu repositorio externo, se crea un duplicado de tu repositorio en Cloud Source Repositories.

  • Para obtener información sobre las cuotas y los límites de Cloud Build, consulta Cuotas y límites en la documentación de Cloud Build.

Crea un activador de compilación

Para crear un activador de compilación nuevo, realiza los siguientes 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 Crear activador.

  4. Selecciona Cloud Source Repository.

  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 siguientes opciones de configuración del activador:

    • Nombre del activador: Un nombre opcional para tu activador.
    • Tipo de activador: Puedes establecer un activador para que comience una compilación con las confirmaciones a una rama en particular o con las confirmaciones que contienen una etiqueta en particular. Cualquiera sea el caso, puedes especificar una expresión regular con el valor de la rama o de la etiqueta para que coincidan.
    • Configuración de compilación: El Dockerfile o el archivo de configuración de compilación (ubicado en el repositorio remoto) para usar en cada compilación con la que se inicie el activador.

Usa un Dockerfile

Si quieres usar un Dockerfile para la configuración de tu compilación, deberás especificar el directorio de Dockerfile y proporcionar 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.

Usa un archivo de configuración 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.

Por ejemplo:

Author: A User <auser@example.com>
Date:   Tue Apr 3 12:03:35 2018 -0700

    Fixed customer affecting issue. [skip ci]

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

Crea clones no superficiales

Para compilar tu fuente en un repositorio Git, Cloud Source Repositories 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 Source Repositories no revisa ninguna otra rama o historial. Esto se hace a fin de aumentar la eficiencia, así las compilaciones no tienen que esperar a que se recuperen el repositorio y la historia completos 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. Para obtener instrucciones sobre cómo escribir un archivo de configuración de compilación, consulta la Descripción general de la configuración de compilación.

¿Qué sigue?

¿Te sirvió esta página? Envíanos tu opinión:

Enviar comentarios sobre…

Cloud Source Repositories