Exécuter des suites d'intégration continue

Bêta : Ce produit ou cette fonctionnalité est soumis aux "Conditions des offres pré-DG" de la section Conditions d'utilisation générales du service des Conditions spécifiques du service. Les produits et fonctionnalités pré-DG sont disponibles "en l'état" et peuvent avoir une compatibilité limitée. Pour en savoir plus, consultez les descriptions des étapes de lancement.

Si vous rencontrez un problème lors de la préversion publique de l'intégration continue, signalez-le à l'aide du formulaire Looker Continuous Integration - Preview Issue Tracker.

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

• Automatiquement lorsqu'un développeur Looker envoie une demande d'extraction au dépôt de votre projet LookML (pour savoir comment configurer cette option, consultez la page Créer une suite d'intégration continue).
• Manuellement en déclenchant une nouvelle exécution d'une suite CI à partir de l'IDE Looker.
• Manuellement en réexécutant une exécution CI précédente à partir de l'IDE Looker.

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 demandes 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 demandes d'extraction, la CI valide le dernier commit de la demande d'extraction et renvoie toutes les erreurs de cette version du dépôt.

Remarque : Pour les validateurs de la suite CI configurés pour effectuer une validation incrémentale, le validateur renvoie les erreurs qui n'existent que dans le commit de la demande d'extraction elle-même. Les validateurs activés pour la validation incrémentale ne renvoient pas d'erreur si elle existe déjà dans la version de production. Pour en savoir plus sur la validation incrémentale, consultez la documentation sur le validateur SQL ou le validateur de contenu.

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éclenchement manuel d'une nouvelle exécution d'une suite CI

Un utilisateur Looker disposant de l'autorisation see_ci peut déclencher manuellement une exécution 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 n'avez pas de suite CI pour votre projet, vous pouvez créer une suite CI).

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 Exécution pour la suite que vous avez déclenchée. Une fois les tests de validation terminés, la page Exécution affiche les résultats de chaque validateur. Vous pouvez quitter la page Exécution pendant l'exécution des tests de validation, puis y revenir ultérieurement 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 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é 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 les projets configurés avec le mode de déploiement avancé, la version de production est un commit ou un tag sélectionné dans le gestionnaire de déploiement par un développeur Looker disposant de l'autorisation deploy permission.
• Pour les projets sans mode de déploiement avancé, la version de production est la branche configurée dans le champ Nom de la branche de production Git de la page Configuration du projet des 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 dans l'IDE Looker.
• Pour valider une branche de développement, celle-ci doit être envoyée à votre dépôt LookML. Dans l'IDE Looker, cela signifie que le développeur doit cliquer sur le bouton Valider les modifications et envoyer ou sélectionner l'option Valider dans le panneau Actions Git de l'IDE.

Réexécution manuelle d'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 réexécution de l'exécution CI à partir de 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 la branche HEAD au moment de la réexécution, ce qui inclut tous les commits ultérieurs effectués depuis l'exécution CI initiale.

De plus, si vous avez modifié la suite CI depuis l'exécution initiale, une réexécution inclura toutes les modifications que vous avez apportées à la suite CI depuis l'exécution initiale.

Pour réexécuter une exécution 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 CI que vous souhaitez annuler.
4. Sur la page des résultats d'exécution 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 renvoie à la page Exécution 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.

Annulation d'une exécution CI

Si vous souhaitez annuler une exécution CI en cours, vous pouvez le faire à partir de 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écution 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.