Présentation de Cloud Build

Cloud Build est un service qui exécute vos compilations sur Google Cloud.

Cloud Build peut importer un code source depuis plusieurs dépôts ou espaces de stockage dans le cloud, exécuter une compilation selon vos spécifications et produire des artefacts, tels que des conteneurs Docker ou des archives Java.

Configuration de la compilation et étapes de compilation

Vous pouvez créer une configuration de compilation pour fournir des instructions à Cloud Build sur les tâches à effectuer. Vous pouvez configurer des compilations pour récupérer des dépendances, exécuter des tests unitaires, des analyses statiques et des tests d'intégration, et créer des artefacts à l'aide d'outils de compilation tels que docker, gradle, maven, bazel et gulp.

Cloud Build exécute votre compilation sous la forme d'étapes de compilation, où chaque étape est exécutée dans un conteneur Docker. L'exécution des étapes de compilation est analogue à l'exécution de commandes dans un script.

Vous pouvez utiliser les étapes de compilation fournies par Cloud Build et la communauté Cloud Build ou créer des étapes de compilation personnalisées :

Chaque étape de compilation est exécutée avec son conteneur associé à un réseau de conteneurs Docker local nommé cloudbuild. Cela permet aux étapes de compilation de communiquer entre elles et de partager des données.

Vous pouvez utiliser des images standards Docker Hub dans Cloud Build, par exemple Ubuntu et Gradle.

Démarrer des compilations

Vous pouvez créer manuellement des compilations dans Cloud Build à l'aide de la CLI Google Cloud ou de l'API Cloud Build, ou utiliser la fonctionnalité Déclencheurs de compilation de Cloud Build pour créer un workflow d'intégration continue et de livraison continue (CI/CD) qui démarre de nouveaux builds en réponse aux modifications du code.

Vous pouvez intégrer des déclencheurs de compilation à de nombreux dépôts de code, en particulier à Cloud Source Repositories, GitHub et Bitbucket.

Afficher les résultats de compilations

Vous pouvez afficher les résultats de compilations à l'aide de la CLI gcloud, de l'API Cloud Build ou de la page Historique de compilation dans la section Cloud Build de Cloud Console, qui affiche les détails et les journaux de chaque compilation exécutée par Cloud Build. Pour obtenir des instructions, consultez Afficher les résultats de compilations.

Fonctionnement des compilations

Les étapes suivantes décrivent, d'une manière générale, le cycle de vie d'une compilation Cloud Build :

  1. Préparez le code de votre application et tous les éléments nécessaires.
  2. Créez un fichier de configuration de compilation au format YAML ou JSON, qui contient des instructions pour Cloud Build.
  3. Envoyez la compilation à Cloud Build.
  4. Cloud Build exécute la compilation en fonction de la configuration fournie.
  5. Le cas échéant, les artefacts compilés sont envoyés vers Artifact Registry.

Docker

Cloud Build utilise Docker pour exécuter des compilations. Pour chaque étape de compilation, Cloud Build exécute un conteneur Docker en tant qu'instance de docker run. Actuellement, Cloud Build exécute la version 19.03.8 de Docker.

Interfaces Cloud Build

Vous pouvez utiliser Cloud Build avec Google Cloud Console, l'outil de ligne de commande gcloud ou l'API REST Cloud Build.

Dans Cloud Console, vous pouvez afficher les résultats de compilations Cloud Build sur la page Historique de compilation et automatiser les compilations dans les déclencheurs de compilation.

Vous pouvez utiliser la CLI gcloud pour créer et gérer des builds. Vous pouvez exécuter des commandes pour effectuer des tâches comme envoyer une compilation, répertorier les builds et annuler une compilation.

Vous pouvez demander des compilations à l'aide de l'API REST Cloud Build.

Comme pour les autres API Cloud Platform, vous devez autoriser l'accès à l'aide d'OAuth2. Une fois l'accès autorisé, vous pouvez utiliser l'API pour démarrer de nouvelles compilations, afficher l'état et les informations relatifs à la compilation, répertorier des compilations par projet et annuler des compilations en cours de traitement.

Pour plus d'informations, consultez la section Documentation sur l'API.

Exécuter des compilations en local

Si vous souhaitez tester votre compilation avant de l'envoyer à Cloud Build, vous pouvez l'exécuter localement à l'aide de l'outil cloud-build-local. Pour savoir comment utiliser cet outil, consultez la page Compiler et déboguer en local.

Étapes suivantes