Exécuter des suites d'intégration continue

Les exécutions d'intégration continue (CI) peuvent être déclenchées de plusieurs manières :

Une fois les tests de validation terminés, vous pouvez examiner les résultats, comme décrit sur la page de documentation Afficher les résultats d'exécution de l'intégration continue.

Déclenchement automatique à partir des demandes d'extraction

Si vous avez activé votre suite d'intégration continue avec Déclencher pour les demandes d'extraction de Looker, l'intégration continue déclenchera automatiquement une exécution de validation lorsqu'un développeur Looker enverra une demande d'extraction'extraction à votre dépôt LookML. (Vous pouvez éventuellement spécifier que seules les demandes d'extraction vers certaines branches de votre dépôt doivent déclencher des exécutions d'IC automatiques.)

Pour les exécutions de validation automatique des demande d'extraction d'extraction, l'IC valide le dernier commit de la demande d'extraction d'extraction et renvoie toutes les erreurs de cette version du dépôt.

Pour en savoir plus sur l'affichage des résultats, consultez la page de documentation Afficher les résultats d'exécution de l'intégration continue.

Déclenchement automatique à partir des demandes d'extraction de projets importés

Si vous avez activé votre suite d'intégration continue dans un projet en aval (spoke) avec l'option Déclencher sur les demandes d'extraction des projets importés, l'intégration continue déclenche automatiquement une exécution de validation dans le projet spoke lorsqu'un développeur ouvre ou met à jour une demande d'extraction d'extraction dans le dépôt d'un projet en amont (hub) auquel il est abonné.

Lors d'une exécution d'IC déclenchée par une demande d'extraction d'un projet importé, Looker effectue les actions suivantes :

  1. Valide la version en production du projet spoke tout en épinglant temporairement le projet hub importé au commit de la demande d'extraction;extraction.
  2. Écrit le résultat de l'exécution de l'intégration continue du projet spoke dans la demande d'extraction d'extraction du dépôt du projet hub.

Pour en savoir plus sur l'affichage des résultats, consultez la page de documentation Afficher les résultats d'exécution de l'intégration continue.

Déclenchement automatique depuis dbt Cloud

Si vous avez activé votre suite d'intégration continue avec Déclencher pour les demandes d'extraction de dbt Cloud, l'intégration continue déclenchera automatiquement une exécution de validation lorsque le job d'intégration continue dbt Cloud spécifié se terminera.

Une exécution CI déclenchée par un job dbt Cloud CI est conçue pour vérifier si les modifications de schéma apportées dans dbt vont endommager le contenu LookML. Pendant l'exécution, Looker effectue les actions suivantes :

  1. Il reçoit la notification de dbt Cloud une fois le job terminé.
  2. Extrait les détails du schéma temporaire créé par dbt Cloud pour cette exécution spécifique.
  3. Remplace l'attribut utilisateur configuré (par exemple, l'attribut de schéma de votre connexion) par le nom de ce schéma temporaire.
  4. Exécute les validateurs d'intégration continue sur ce schéma temporaire.

Cela vous permet de détecter les modifications destructives (comme les colonnes supprimées ou les tables renommées) avant que les modifications dbt ne soient fusionnées en production. Une fois l'exécution terminée, la valeur de l'attribut utilisateur revient à sa valeur standard pour les utilisateurs de l'intégration continue.

Déclenchement automatique selon une programmation

Si vous avez activé votre suite d'intégration continue avec Déclencher selon une planification, l'intégration continue déclenchera automatiquement une exécution de validation selon la planification que vous spécifiez.

Pour les exécutions de validation planifiées automatiques, l'intégration continue valide la version de production du dépôt et renvoie toutes les erreurs de cette version.

Pour en savoir plus sur l'affichage des résultats, consultez la page de documentation Afficher les résultats d'exécution de l'intégration continue.

Déclencher manuellement une nouvelle exécution d'une suite d'intégration continue

Un utilisateur Looker disposant de l'autorisation see_ci peut déclencher manuellement une exécution d'IC à partir de l'IDE Looker.

Pour déclencher manuellement une nouvelle exécution d'une suite d'intégration continue, procédez comme suit :

  1. Dans l'IDE Looker, cliquez sur l'icône Intégration continue dans la barre de navigation de l'IDE.
  2. Cliquez sur Suites pour ouvrir la page Suites.
  3. Cliquez sur le bouton Exécuter la suite pour la suite d'intégration continue que vous souhaitez exécuter (si vous n'avez pas de suite d'intégration continue pour votre projet, vous pouvez en créer une).

  4. Dans la boîte de dialogue Déclencher une exécution manuellement, utilisez les options Espace de travail pour sélectionner la branche que vous souhaitez valider (pour en savoir plus, consultez la section Espace de travail) :

    • Pour valider la version en production de votre projet LookML, cliquez sur Production.
    • Si vous souhaitez valider une branche de développement de votre projet LookML, cliquez sur Mode Développement. Utilisez le menu déroulant Branche pour sélectionner la branche de développement à valider.

  5. Pour déclencher l'exécution de la suite d'intégration continue, cliquez sur Lancer l'exécution.

L'exécution de la suite d'intégration continue peut prendre plusieurs minutes, en fonction de la taille de votre projet, des validateurs inclus dans la suite d'intégration continue et de la configuration de la suite d'intégration continue.

Une fois que vous avez déclenché une exécution, l'IDE Looker affiche la page Exécuter de la suite que vous avez déclenchée. Une fois les tests de validation terminés, la page Exécuter affiche les résultats de chacun des validateurs. Vous pouvez quitter la page Exécuter pendant l'exécution des tests de validation, puis y revenir plus tard pour consulter les résultats.

Pour en savoir plus sur l'affichage des résultats, consultez la page de documentation Afficher les résultats d'exécution de l'intégration continue.

Espace de travail

Lorsque vous déclenchez manuellement une exécution d'IC, vous pouvez utiliser les options de l'espace de travail pour valider la version de production de votre dépôt ou une branche de développement de votre dépôt.

Pour l'option Production, si vous souhaitez identifier la branche ou le commit utilisé pour la version en production, vous pouvez consulter l'IDE Looker dans le champ Default Production Branch (Branche de production par défaut) de la section Git Summary (Résumé Git) de la page Branch Management (Gestion des branches) des Project Settings (Paramètres du projet) :

Pour l'option Mode développeur, tenez compte des points suivants pour valider les branches de développement de votre projet :

  • Pour afficher les branches de votre projet LookML et identifier la branche de production et les branches personnelles de vos développeurs, consultez la page Branch Management (Gestion des branches) des Project Settings (Paramètres du projet) de votre projet dans l'IDE Looker.
  • Pour valider une branche de développement, celle-ci doit être transférée vers votre dépôt LookML. Dans l'IDE Looker, cela signifie que le développeur doit cliquer sur le bouton Commit Changes & Push (Valider les modifications et les transférer) ou sélectionner l'option Commit (Valider) dans le panneau "Git Actions" de l'IDE.

Réexécuter manuellement une exécution d'intégration continue précédente

Pour les exécutions terminées (qu'elles aient réussi, échoué, généré une erreur ou été annulées), un utilisateur Looker disposant de l'autorisation see_ci peut déclencher manuellement une nouvelle exécution de l'exécution d'IC à partir de l'IDE Looker :

  • Si vous relancez une exécution déclenchée par une demande d'extraction (qui est déclenchée par une demande d'extraction d'extraction dans le dépôt du projet ou dans un projet importé), l'intégration continue s'exécute sur le même commit que l'exécution d'origine.
  • Si vous relancez une exécution déclenchée manuellement, l'intégration continue s'exécute sur l'état de production ou la branche HEAD au moment de la nouvelle exécution, ce qui inclut tous les commits ultérieurs effectués depuis l'exécution initiale de l'intégration continue.

De plus, si vous avez modifié la suite d'intégration continue depuis l'exécution initiale, une nouvelle exécution inclura toutes les modifications que vous avez apportées à la suite d'intégration continue depuis l'exécution initiale.

Pour relancer une exécution d'intégration continue, procédez comme suit :

  1. Dans l'IDE Looker, cliquez sur l'icône Intégration continue dans la barre de navigation de l'IDE.
  2. Cliquez sur Exécutions pour ouvrir la page Exécutions.
  3. Sur la page Exécutions, cliquez sur le bouton Afficher l'exécution correspondant à l'exécution d'intégration continue que vous souhaitez annuler.
  4. Sur la page des résultats de l'exécution sélectionnée, cliquez sur le bouton Réexécuter en haut de la page.

Une fois que vous avez cliqué sur Réexécuter, le validateur de contenu lance l'exécution et vous redirige vers la page Exécuter pour la nouvelle exécution.

Pour en savoir plus sur l'affichage des résultats, consultez la page de documentation Afficher les résultats d'exécution de l'intégration continue.

Annuler une exécution d'intégration continue

Si vous souhaitez annuler une exécution d'intégration continue en cours, vous pouvez le faire depuis sa page Exécution en procédant comme suit :

  1. Dans l'IDE Looker, cliquez sur l'icône Intégration continue dans la barre de navigation de l'IDE.
  2. Cliquez sur Exécutions pour ouvrir la page Exécutions.
  3. Sur la page Exécutions, cliquez sur le bouton Afficher l'exécution correspondant à l'exécution d'intégration continue que vous souhaitez annuler.
  4. Sur la page Exécuter de l'exécution sélectionnée, cliquez sur le bouton Annuler en haut de la page.

Une fois que vous avez cliqué sur Annuler, l'intégration continue annule l'exécution et affiche l'état Annulé sur la page Exécution.