Une suite d'intégration continue (CI) est un ensemble d'instructions de validation associé à votre projet LookML. Un utilisateur Looker disposant de l'autorisation manage_ci peut configurer les éléments suivants dans une suite CI:
- Comment une exécution de validation de l'intégration continue est déclenchée (manuellement depuis l'IDE Looker ou automatiquement lorsqu'une demande d'extraction est envoyée à votre dépôt).
- Programmes de validation de CI à exécuter.
- Options supplémentaires pour chaque test de validation. Pour en savoir plus, consultez les pages de documentation de chacun des validateurs :
Avant de commencer
Avant de pouvoir créer une suite CI, vous avez besoin des éléments suivants:
- Une instance Looker qui répond aux exigences de la CI et qui est activée pour la CI.
- Un compte utilisateur Looker disposant de l'autorisation
manage_ci(cette autorisation est incluse dans l'ensemble d'autorisations de l'administrateur).
Créer une suite CI
Vous pouvez configurer et exécuter les validateurs sur la page Suites de l'IDE Looker:
Pour créer une suite CI, procédez comme suit:
- Dans l'IDE Looker, cliquez sur l'icône Intégration continue dans la barre de navigation de l'IDE.
- Cliquez sur l'onglet Suites pour ouvrir la page Suites.
- Sur la page Suites, vous pouvez créer une suite ou en modifier une existante :
- Pour créer une suite, cliquez sur le bouton Créer une suite.
- Pour modifier une suite existante, cliquez sur le bouton Modifier la suite correspondant.
- Saisissez un nom pour le nom de la suite. Si vous modifiez une suite existante, vous pouvez cliquer sur l'icône en forme de crayon pour modifier son nom.
(Facultatif) Activez l'option Déclencher pour les demandes d'extraction de Looker si vous souhaitez configurer des tests de validation automatiques chaque fois qu'un développeur Looker envoie une demande d'extraction'extraction à votre dépôt. Pour en savoir plus, consultez la section Déclencheurs de cette page.
Si vous activez le déclenchement des demande d'extraction pour une suite CI, vous pouvez éventuellement utiliser le champ Uniquement pour la branche cible pour spécifier que seules les requêtes pull vers des branches spécifiques du dépôt doivent déclencher l'exécution de la suite CI. Pour en savoir plus, consultez la section Déclencheurs de cette page.
Vous pouvez également activer les boutons d'activation des validateurs pour activer un validateur et configurer ses options. Pour en savoir plus, consultez les pages de documentation de chacun des validateurs:
Enregistrez les modifications:
- Si vous créez une suite, cliquez sur le bouton Créer une suite.
- Si vous modifiez une suite existante, cliquez sur le bouton Mettre à jour la suite.
Déclencheurs
Les builds CI peuvent être déclenchés de plusieurs manières:
- Automatiquement, lorsqu'un développeur Looker envoie une demande d'extraction d'extraction au dépôt de votre projet LookML.
- Manuellement, en utilisant le bouton Run suite (Exécuter la suite) sur la page Suites (Suites) de l'IDE Looker.
- Manuellement, en relancer une exécution de CI précédente, depuis la page Exécutions de l'IDE Looker.
Pour configurer une suite CI pour un déclenchement automatique sur les demande d'extraction d'extraction, activez l'option Déclencher sur les demandes d'extraction de Looker. Pour utiliser le déclenchement de demande d'extraction, votre dépôt Git doit être configuré par votre administrateur Looker sur la page Intégration continue d'administration de Looker.
Si vous activez les déclencheurs de demande d'extraction pour une suite CI, vous pouvez spécifier que seules les requêtes d'extraction vers des branches spécifiques du dépôt doivent déclencher l'exécution de la suite CI. Pour limiter les déclencheurs automatiques des demande d'extraction des exécutions de CI à des branches spécifiques de votre dépôt, saisissez une liste des branches séparées par une virgule dans le champ Uniquement pour la branche cible.
Par exemple, si un dépôt comporte trois branches nommées main, release_1 et dev, vous pouvez saisir main, release_1 dans le champ Only for target branch (Uniquement pour la branche cible). Cela signifie que les exécutions de CI seront déclenchées lorsqu'un développeur Looker enverra une demande d'extraction à la branche main ou release_1. Si un développeur Looker envoie une demande d'extraction à la branche dev, cela ne déclenche pas l'exécution automatique de la suite CI.
Supprimer une suite
Pour supprimer une suite CI, procédez comme suit:
- Dans l'IDE Looker, cliquez sur l'icône Intégration continue dans la barre de navigation de l'IDE.
- Cliquez sur l'onglet Suites pour ouvrir la page Suites.
- Sur la page Suites, cliquez sur le bouton Modifier la suite correspondant à la suite.
- Sur la page de la suite, cliquez sur le bouton Supprimer la suite.
- Dans la boîte de dialogue de confirmation, cliquez sur le bouton Supprimer la suite.