Back to Gitlabhq

Diffblue Cover

doc-locale/fr-fr/integration/diffblue_cover.md

19.3.06.3 KB
Original Source

{{< details >}}

  • Édition : Gratuite, GitLab Premium, GitLab Ultimate
  • Offre : GitLab.com, GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

Vous pouvez intégrer l'outil d'IA par apprentissage par renforcement Diffblue Cover à vos pipelines CI/CD, afin d'écrire et de maintenir automatiquement des tests unitaires Java pour vos projets GitLab. L'intégration de Diffblue Cover Pipeline for GitLab vous permet d'effectuer automatiquement les opérations suivantes :

  • Écrire une suite de tests unitaires de base pour vos projets.
  • Écrire de nouveaux tests unitaires pour le nouveau code.
  • Mettre à jour les tests unitaires existants dans votre code.
  • Supprimer les tests unitaires existants dans votre code lorsqu'ils ne sont plus nécessaires.

Configurer l'intégration {#configure-the-integration}

Pour intégrer Diffblue Cover dans votre pipeline :

  1. Rechercher et configurer l'intégration Diffblue Cover.
  2. Configurer un pipeline pour un exemple de projet à l'aide de l'éditeur de pipeline GitLab et du modèle de pipeline Diffblue Cover.
  3. Créer une suite de tests unitaires de base complète pour le projet.

Configurer Diffblue Cover {#configure-diffblue-cover}

  1. Dans la barre supérieure, sélectionnez Rechercher ou accéder à et trouvez votre projet.

  2. Sélectionnez Paramètres > Intégrations.

  3. Trouvez Diffblue Cover et sélectionnez Configurer.

  4. Remplissez les champs :

    • Cochez la case Actif.

    • Saisissez votre Clé de licence Diffblue Cover fournie dans votre e-mail de bienvenue ou par votre organisation. Si nécessaire, sélectionnez le lien Essayer Diffblue Cover pour vous inscrire à un essai gratuit.

    • Saisissez les détails de votre jeton d'accès GitLab (Nom et Secret) pour permettre à Diffblue Cover d'accéder à votre projet. En général, utilisez un jeton d'accès au projet GitLab project access token avec le rôle Developer, ainsi que les portées api et write_repository. Si nécessaire, vous pouvez utiliser un jeton d'accès de groupe ou un jeton d'accès personnel personal access token, toujours avec le rôle Developer, ainsi que les portées api et write_repository.

      [!note] L'utilisation d'un jeton d'accès avec des permissions excessives représente un risque de sécurité. Si vous utilisez un jeton d'accès personnel, envisagez de créer un utilisateur dédié dont l'accès est limité au seul projet concerné, afin de minimiser l'impact en cas de fuite du jeton.

  5. Sélectionnez Enregistrer les modifications. Votre intégration Diffblue Cover est désormais <mark style="color:green;">Actif</mark> et prête à être utilisée dans votre projet.

Configurer un pipeline {#configure-a-pipeline}

Créez un pipeline de merge request pour le projet qui télécharge la dernière version de Diffblue Cover, compile le projet, écrit des tests unitaires Java pour le projet et commit les modifications dans la branche.

  1. Dans la barre supérieure, sélectionnez Rechercher ou accéder à et trouvez votre projet.

  2. Copiez le contenu du modèle Diffblue-Cover.gitlab-ci.yml dans le fichier .gitlab-ci.yml de votre projet.

    [!note] Lorsque vous utilisez le modèle de pipeline Diffblue Cover avec votre propre projet et un fichier de pipeline existant, ajoutez le contenu du modèle Diffblue à votre fichier et modifiez-le selon vos besoins. Pour plus d'informations, consultez Cover Pipeline for GitLab dans la documentation Diffblue.

  3. Saisissez un message de commit.

  4. Saisissez un nouveau nom de Branche. Par exemple, add-diffblue-cover-pipeline.

  5. Sélectionnez Start a new merge request with these changes.

  6. Sélectionnez Valider les modifications.

Créer une suite de tests unitaires de base {#create-a-baseline-unit-test-suite}

  1. Dans le formulaire Nouvelle requête de fusion, saisissez un Titre (par exemple, « Ajouter le pipeline Cover et créer une suite de tests unitaires de base ») et renseignez les autres champs.
  2. Sélectionnez Créer une requête de fusion. Le pipeline de merge request exécute Diffblue Cover pour créer la suite de tests unitaires de base pour le projet.
  3. Une fois le pipeline terminé, les modifications peuvent être examinées depuis l'onglet Modifications. Lorsque vous êtes satisfait, fusionnez les mises à jour dans votre dépôt. Accédez aux dossiers src/test dans le dépôt du projet pour voir les tests unitaires créés par Diffblue Cover (avec le suffixe *DiffblueTest.java).

Modifications de code ultérieures {#subsequent-code-changes}

Lors de modifications de code ultérieures sur un projet, le pipeline de merge request exécute Diffblue Cover, mais ne met à jour que les tests associés. Le diff résultant peut ensuite être analysé pour vérifier le nouveau comportement, détecter les régressions et repérer tout changement de comportement non planifié dans le code.

Étapes suivantes {#next-steps}

Cette rubrique présente certaines des fonctionnalités clés de Cover Pipeline for GitLab et explique comment utiliser l'intégration dans un pipeline. Les fonctionnalités plus larges et plus avancées, disponibles via les commandes dcover dans le modèle de pipeline, peuvent être implémentées pour étendre encore davantage vos capacités de tests unitaires. Pour plus d'informations, consultez Cover Pipeline for GitLab dans la documentation Diffblue.