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 CI avec l'option Déclencher pour les demandes d'extraction de Looker, la CI 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 également spécifier que les requêtes d'extraction ne doivent déclencher des exécutions CI automatiques que pour certaines branches de votre dépôt.)

Pour les exécutions de validation automatique des demande d'extraction d'extraction, l'intégration continue valide le dernier commit de la demande d'extraction 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 depuis l'IDE Looker.

Pour déclencher manuellement une nouvelle exécution d'une suite CI :

  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 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 l'exécution déclenchée, l'IDE Looker affiche la page Exécuter pour 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 chaque validateur. 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 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 CI, vous pouvez utiliser les options de l'espace de travail pour valider la version de production 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 Branche de production par défaut de la section Résumé Git de la page Gestion des branches des Paramètres du projet dans l'IDE Looker :

Pour l'option Mode Développement, notez les points suivants pour valider les branches de développement dans 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 l'envoyer à 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 envoyer) ou sélectionner l'option Commit (Valider) dans le panneau "Actions Git" de l'IDE.

Relancer manuellement une exécution CI 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 CI depuis l'IDE Looker :

  • Si vous réexécutez une exécution déclenchée par une demande d'extraction, 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 branche au moment de la ré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 la première exécution, une nouvelle exécution inclura toutes les modifications que vous avez apportées à la suite CI depuis la première exécution.

Pour relancer une exécution CI :

  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 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 Exécuter à nouveau, le validateur de 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 CI

Si vous souhaitez annuler une exécution CI 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 pour l'exécution 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é sur la page Exécuter.