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 consulter 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 de demandes d'extraction

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

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

Pour savoir comment afficher les 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 CI

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

Pour déclencher manuellement une nouvelle exécution d'une suite CI, 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 CI que vous souhaitez exécuter (si vous ne disposez d'aucune suite CI 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 de 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 CI, cliquez sur Démarrer l'exécution.

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

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

Pour savoir comment afficher les 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 de CI, vous pouvez utiliser les options 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és pour la version de production, vous pouvez consulter le champ Default Production Branch (Branche de production par défaut) de la section Git Summary (Récapitulatif Git) de la page Branch Management (Gestion des branches) des Project Settings (Paramètres du projet) :

Pour l'option Mode développement, notez les 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 Gestion des branches des paramètres du projet de votre projet dans l'IDE Looker.
  • Pour valider une branche de développement, vous devez la transférer vers votre dépôt LookML. Dans l'IDE Looker, cela signifie que le développeur doit cliquer sur le bouton Commit Changes & Push (Enregistrer les modifications et envoyer) ou sélectionner l'option Commit (Enregistrer) dans le panneau Git Actions (Actions Git) de l'IDE.

Relancer manuellement une exécution de CI précédente

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

  • Si vous réexécutez une exécution déclenchée par une demande de pull, l'intégration continue s'exécute sur le même commit que l'exécution d'origine.
  • Si vous réexécutez une exécution déclenchée manuellement, l'intégration continue s'exécute sur l'état de production ou le HEAD de la branche 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 CI depuis l'exécution initiale, une nouvelle exécution inclura toutes les modifications que vous avez apportées à la suite CI depuis l'exécution initiale.

Pour relancer une exécution de CI, 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 pour l'exécution de CI 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, l'outil de validation du contenu lance l'exécution et vous redirige vers la page Exécuter pour la nouvelle exécution.

Pour savoir comment afficher les résultats, consultez la page de documentation Afficher les résultats d'exécution de l'intégration continue.

Annuler une exécution de CI

Si vous souhaitez annuler une exécution de CI en cours, vous pouvez le faire depuis la page Exécuter 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 pour l'exécution de CI 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ée sur la page Exécuter.