Guide de démarrage rapide : Automatiser

Cette page explique comment utiliser Cloud Build pour automatiser les compilations.

Cloud Build utilise des déclencheurs de compilation pour activer l'automatisation CI/CD. Vous pouvez configurer des déclencheurs pour écouter les événements entrants, par exemple lorsqu'un nouveau commit est transféré vers un dépôt ou lorsqu'une demande d'extraction est lancée, puis Apellez automatiquement une compilation lorsque de nouveaux événements arrivent.

Vous allez créer un déclencheur et le configurer pour appeler une compilation chaque fois que vous transférerez une modification dans un dépôt GitHub.


Pour obtenir des conseils détaillés sur cette tâche directement dans l'éditeur Cloud Shell, cliquez sur Visite guidée:

VISITE GUIDÉE


La procédure décrite dans les sections suivantes, est la même que si vous cliquez sur Visite guidée.

Avant de commencer

  1. Connectez-vous à votre compte Google Cloud. Si vous débutez sur Google Cloud, créez un compte pour évaluer les performances de nos produits en conditions réelles. Les nouveaux clients bénéficient également de 300 $ de crédits gratuits pour exécuter, tester et déployer des charges de travail.
  2. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  3. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  4. Activez l'API Cloud Build.

    Activer l'API

  5. Installez et initialisez le SDK Cloud.
  6. Dans Google Cloud Console, sur la page de sélection du projet, sélectionnez ou créez un projet Google Cloud.

    Accéder au sélecteur de projet

  7. Assurez-vous que la facturation est activée pour votre projet Cloud. Découvrez comment vérifier que la facturation est activée pour votre projet.

  8. Activez l'API Cloud Build.

    Activer l'API

  9. Installez et initialisez le SDK Cloud.
  10. Si vous n'avez pas encore de compte, créez-en un sur GitHub.

  11. Si l'authentification à deux facteurs est configurée sur GitHub, créez un jeton d'accès personnel à utiliser à la place d'un mot de passe GitHub avec la ligne de commande.

Dupliquer et cloner un exemple de dépôt GitHub

Vous aurez besoin d'un exemple de code source pour compiler. Dans cette section, vous allez cloner un dépôt source existant contenant un exemple Hello World en langage Go dans votre propre compte utilisateur GitHub.
  1. Si vous n'avez pas encore de compte, créez-en un sur GitHub.

  2. Si l'authentification à deux facteurs est configurée sur GitHub, créez un jeton d'accès personnel à utiliser à la place d'un mot de passe GitHub avec la ligne de commande.

  3. Dupliquez le dépôt cloud-build-samples sur votre propre compte GitHub :

    1. Accédez au dépôt cloud-build-samples de Cloud Build.

    2. Cliquez sur l'icône Dupliquer en haut à droite de la page.

    3. Cliquez sur le compte utilisateur GitHub vers lequel vous souhaitez dupliquer le dépôt.

      Vous êtes automatiquement redirigé vers la page contenant votre version dupliquée du dépôt cloud-build-samples.

  4. Ouvrez un terminal dans votre environnement local.

  5. Clonez le dépôt dupliqué en exécutant la commande suivante, où GITHUB_USERNAME correspond au nom d'utilisateur de votre compte GitHub :

    git clone https://github.com/GITHUB_USERNAME/cloud-build-samples.git

Connecter Cloud Build à votre dépôt

Pour créer du code source sur GitHub à l'aide de déclencheurs, vous devez d'abord connecter Cloud Build à votre dépôt GitHub. Dans cette section, vous allez connecter votre dépôt cloud-build-samples à Cloud Build.
  1. Dans le menu de navigation de Google Cloud Console, cliquez sur Cloud Build > Déclencheurs.

    Ouvrir la page Déclencheurs

  2. Sélectionnez votre projet et cliquez sur Ouvrir.

  3. Cliquez sur Connecter un dépôt.

  4. Sous Sélectionner une source, sélectionnez GitHub (application GitHub Cloud Build).

  5. Cliquez sur Continuer.

  6. Authentifiez votre compte GitHub.

  7. Dans la section Sélectionner un dépôt, sélectionnez le nom d'utilisateur de votre compte GitHub. Si votre nom d'utilisateur n'apparaît pas dans la liste :

    1. Dans la liste Compte GitHub, cliquez sur +Ajouter.

      Une fenêtre pop-up s'affiche pour l'installation de l'application GitHub Cloud Build.

    2. Cliquez sur votre nom d'utilisateur GitHub.

    3. Cliquez sur Uniquement certains dépôts pour installer l'application Cloud Build GitHub sur certains dépôts.

    4. Dans le menu déroulant, sélectionnez GITHUB_USERNAME/cloud-build-samples, où GITHUB_USERNAME est le nom d'utilisateur de votre compte GitHub.

    5. Cliquez sur Installer.

      Vous serez peut-être invité à saisir le mot de passe associé à votre compte GitHub avant de continuer.

    6. Après l'installation de l'application GitHub Cloud Build, vous pouvez désormais voir votre nom d'utilisateur dans le menu déroulant du champ Compte GitHub. Sélectionnez votre nom d'utilisateur.

  8. Sous Dépôt, sélectionnez le dépôt GITHUB_USERNAME/cloud-build-samples.

  9. Cliquez sur la coche pour accepter les conditions d'utilisation de la connexion du déclencheur.

  10. Cliquez sur Connecter.

  11. Cliquez sur OK.

Vous allez créer un déclencheur dans la section suivante.

Créer un déclencheur

  1. Ouvrez la page Déclencheurs dans Google Cloud Console :

    Ouvrir la page Déclencheurs

  2. Sélectionnez votre projet dans le menu déroulant du sélecteur de projet, en haut de la page.

  3. Cliquez sur Ouvrir.

  4. Sur la page Déclencheurs, cliquez sur Créer un déclencheur.

  5. Sur la page Créer un déclencheur, saisissez les paramètres suivants :

    • Nom : saisissez hello-world-trigger comme nom de votre déclencheur.

    • Événement : sélectionnez Déployer sur une branche en tant qu'événement du dépôt pour appeler votre déclencheur.

    • Source : sélectionnez le dépôt cloud-build-samples comme source, qui contient votre code source et votre fichier de configuration de compilation.

    • Configuration de la compilation : sélectionnez Fichier de configuration Cloud Build comme fichier de configuration de compilation.

    • Emplacement du fichier de configuration Cloud Build : spécifiez le chemin d'accès à votre fichier de configuration Cloud Build en tant que quickstart-automate/cloudbuild.yaml.

  6. Cliquez sur Créer pour enregistrer le déclencheur de compilation.

Valider une modification

Dans cette section, vous allez valider une modification apportée à votre dépôt cloud-build-samples cloné sur votre propre compte GitHub.

  1. Dans votre terminal, accédez au répertoire quickstart-automate :

    cd code-examples/quickstart-automate
  2. Ouvrez le fichier main.go et remplacez la ligne "Hello, world!" par "Hello, universe!"

              package main
    
              import (
                  "fmt"
              )
    
              func main() {
                  fmt.Println("Hello, universe!")
              }
       
  3. Examinez cloudbuild.yaml, le fichier de configuration de compilation utilisé par Cloud Build. Lorsqu'une compilation est appelée avec un déclencheur, l'étape de compilation de ce fichier indique à Cloud Build d'utiliser l'image golang de Docker Hub pour compiler et exécuter le fichier main.go.

             steps:
             - name: golang
               args: ['go', 'run', 'quickstart-automate/main.go']
        
  4. Revenez au répertoire racine de votre dépôt :

       cd ..
  5. Validez vos modifications dans GitHub en exécutant les commandes suivantes :

        
        git add quickstart-automate/main.go
        git commit -m "update text"
        git push

    Vous pouvez être invité à saisir vos identifiants lorsque vous transférez du code vers votre dépôt. Si vous y êtes invité, saisissez votre nom d'utilisateur et votre mot de passe, ou un jeton d'authentification.

Vous venez de déployer une modification dans le dépôt. Votre déclencheur lance alors une compilation automatique.

Afficher les informations sur le build

Dans cette section, vous allez afficher les détails de la compilation associée à votre compilation appelée après avoir validé une modification.
  1. Dans le menu de navigation de Google Cloud Console, cliquez sur Cloud Build > Historique.

    Ouvrir la page Cloud Build

  2. Sélectionnez votre projet et cliquez sur Ouvrir.

    La page Build history (Historique de compilation) s'affiche :

    Capture d'écran de la page d'historique de compilation pour l'automatisation

  3. Dans la colonne Build, cliquez sur le nom d'un build.

  4. Sur la page Informations sur la compilation, cliquez surArtefacts de compilation.

    Un résultat semblable aux lignes suivantes s'affiche :

    Capture d'écran des artefacts de compilation

  5. Pour afficher le journal des compilations, cliquez sur l'icône de téléchargement, puis affichez le fichier téléchargé.

Vous avez appelé une compilation Cloud Build à l'aide d'un déclencheur et consulté les informations sur la compilation.

Effectuer un nettoyage

Pour éviter que les ressources utilisées dans cette page soient facturées sur votre compte Google Cloud, procédez comme suit :

  1. Dans le menu de navigation de Google Cloud Console, cliquez sur Cloud Build > Déclencheurs.

    Ouvrir la page Déclencheurs

  2. Sélectionnez votre projet et cliquez sur Ouvrir.

  3. Sur la ligne hello-world-trigger, cliquez sur le menu d'actions (icône représentant des points verticaux) à l'extrémité droite de la ligne.

  4. Sélectionnez Supprimer.

Vous avez maintenant supprimé le déclencheur associé à votre dépôt cloné.

Étape suivante