Descripción general de Cloud Build

Cloud Build es un servicio que ejecuta tus compilaciones en una infraestructura de Google Cloud Platform.

Cloud Build puede importar un código fuente desde varios repositorios o espacios de Cloud Storage, ejecutar una compilación según tus especificaciones y producir artefactos como contenedores de Docker o archivos de Java.

Configuración y pasos de compilación

Puedes escribir una configuración de la compilación para proporcionar instrucciones a Cloud Build sobre qué tareas realizar. Puedes configurar compilaciones para recuperar dependencias, ejecutar pruebas de unidades, realizar análisis de estadísticas y pruebas de integración y crear artefactos con herramientas de compilación como Docker, Gradle, Maven, Bazel y Gulp.

Cloud Build ejecuta tu compilación como una serie de pasos de la compilación, en los que cada paso de la compilación se ejecuta en un contenedor de Docker. La ejecución de pasos de compilación es análoga a la ejecución de comandos en una secuencia de comandos.

Puedes usar los pasos de compilación proporcionados por Cloud Build y la comunidad de Cloud Build o escribir tus propios pasos de compilación personalizados:

Cada paso de compilación se ejecuta con su contenedor conectado a una red de Docker local llamada cloudbuild. Eso permite que los pasos de compilación se comuniquen entre sí y compartan datos.

Puedes usar imágenes estándar de Docker Hub en Cloud Build, como Ubuntu y Gradle.

Inicia compilaciones

Puedes iniciar compilaciones de forma manual en Cloud Build mediante la herramienta de línea de comandos de gcloud o la API de Cloud Build. También puedes usar la función de activadores de compilación de Cloud Build para crear un flujo de trabajo automatizado de integración continua/entrega continua (CI/CD) que comience compilaciones nuevas en respuesta a cambios de código.

Puedes integrar activadores de compilación en varios repositorios de código, incluidos Cloud Source Repositories, GitHub, y Bitbucket.

Ver resultados de compilación

Puedes ver los resultados de compilaciones mediante la herramienta de gcloud, la API de Cloud Build o la página Historial de compilación, en la sección Cloud Build de Cloud Console. Allí se muestran detalles y registros de cada compilación que ejecuta Cloud Build. Para obtener instrucciones, consulta Visualiza resultados de compilaciones.

Cómo funcionan las compilaciones

En los pasos siguientes, se brinda una descripción general del ciclo de vida de una compilación de Cloud Build:

  1. Prepara tu código de aplicación y cualquier elemento necesario.
  2. Crea un archivo de configuración de la compilación en formato YAML o JSON, que incluya instrucciones para Cloud Build.
  3. Envía la compilación a Cloud Build.
  4. Cloud Build ejecuta la compilación según la configuración de la compilación que proporcionaste.
  5. Si corresponde, cualquier imagen de compilación se envía a Container Registry. Container Registry proporciona almacenamiento privado y seguro de imágenes de Docker en Google Cloud.

Docker

Cloud Build usa Docker para ejecutar compilaciones. Para cada paso de compilación, Cloud Build ejecuta un contenedor de Docker como una instancia de docker run. Actualmente, Cloud Build ejecuta la versión 19.03.8 de Docker.

Interfaces de Cloud Build

Puedes usar Cloud Build con Google Cloud Console, la herramienta de línea de comandos de gcloud o la API de REST de Cloud Build.

En Cloud Console, puedes ver los resultados de la compilación de Cloud Build en la página Historial de compilaciones y automatizar las compilaciones en Activadores de compilación.

Puedes usar la herramienta de gcloud para crear y administrar compilaciones. También puedes ejecutar comandos para realizar tareas como enviar una compilación, crear una lista de compilaciones y cancelar una compilación.

Puedes solicitar compilaciones mediante la API de REST de Cloud Build.

De la misma manera que con otras API de Cloud Platform, debes autorizar el acceso con OAuth2. Después de autorizar el acceso, puedes usar la API para iniciar compilaciones nuevas, ver el estado y los detalles de la compilación, hacer una lista de compilaciones por proyecto y cancelar compilaciones que están en proceso en ese momento.

Para obtener más información, consulta la documentación de la API.

Ejecuta compilaciones a nivel local

Si quieres probar tu compilación antes de enviarla a Cloud Build, puedes ejecutar tu compilación de forma local mediante la herramienta de cloud-build-local. A fin de obtener más instrucciones para usar esta herramienta, consulta la página Compila y depura a nivel local.

Qué sigue