Passer au contenu principal

Pourquoi intégrer Devin avec Bitbucket ?

Intégrer Devin à vos dépôts Bitbucket permet à Devin de créer des pull requests, de lire vos commentaires de PR, d’y répondre et de collaborer efficacement avec votre équipe. Devin devient ainsi un véritable collaborateur au sein de votre équipe d’ingénierie.

Prérequis

Avant de configurer l’intégration à Bitbucket, nous recommandons :
  • Compte de service dédié - Créez un nouveau compte Bitbucket spécifiquement pour Devin (par exemple, devin@yourcompany.com) plutôt que d’utiliser un compte utilisateur existant, afin de simplifier la gestion des accès et la traçabilité des actions
L’utilisation d’un compte de service dédié facilite le suivi de l’activité de Devin, la gestion des autorisations et le maintien des bonnes pratiques de sécurité au sein de votre organisation.

Configuration de l’intégration

Bitbucket Cloud

Il existe deux types de connexions Bitbucket Cloud. Choisissez celui qui correspond à ce que Devin doit faire pour vous : Les « écritures propres à Devin » désignent les pull requests ouvertes par Devin ainsi que les constats et les mises à jour de description publiés par Devin Review. Les actions que vous effectuez vous-même dans Devin Review (commentaires, réponses, refus d’une pull request) sont publiées en votre nom depuis votre propre compte Bitbucket lié, quel que soit le type de connexion ; consultez Devin Review.
Devin installe lui-même les webhooks nécessaires à la revue automatique de Devin Review, quel que soit le type de connexion, mais uniquement si la connexion dispose des droits d’administration sur le dépôt : un jeton d’accès doté des autorisations Webhooks: Read and write et Dépôts: Admin, ou une connexion OAuth dont le compte Bitbucket lié est administrateur du dépôt. Dans le cas contraire, le dépôt apparaît comme Skipped dans le statut des webhooks de la connexion, accompagné du motif fourni par Bitbucket, et les revues ne s’exécutent que lorsque vous ouvrez vous-même une pull request dans Devin Review.

Se connecter avec un jeton d’accès

  1. Dans Bitbucket, créez un jeton d’accès à l’espace de travail pour l’espace de travail dans lequel Devin doit intervenir, avec les étendues suivantes :
    • Dépôts: Admin
    • Pull requests: Write
    • Webhooks: Read and write
    Avec des étendues plus restreintes, Devin ne peut ni lire l’état de fusion ni installer de webhooks.
  2. Dans votre compte Devin, accédez à Settings > Connections > Bitbucket, ouvrez la liste déroulante à côté du bouton Connect, puis sélectionnez Connect with access token.
  3. Saisissez l’ID de l’espace de travail (my-workspace dans bitbucket.org/my-workspace) et le token, puis cliquez sur Connect.
Devin utilise le token pour cet espace de travail et publie au nom du token, et non en votre nom. Une fois la connexion active, Devin installe lui-même ses webhooks sur les dépôts de l’espace de travail ; le panneau de détails de la connexion affiche le résultat pour chaque dépôt, ainsi qu’un bouton Refresh pour relancer l’installation.

Se connecter avec OAuth

Utilisez OAuth lorsque votre espace de travail n’est pas sur Bitbucket Cloud Premium. Une connexion OAuth repose sur l’autorisation Bitbucket propre au compte lié : les actions d’écriture de Devin (les pull requests qu’il ouvre, les constats et les mises à jour de description publiés par Devin Review) apparaissent au nom de ce compte, et les webhooks ne sont installés que sur les dépôts dont ce compte est administrateur. C’est pourquoi les étapes ci-dessous commencent par la création d’un compte Bitbucket dédié : ne liez jamais le compte d’un collaborateur pour l’organisation. Si la connexion a été établie avant que l’application Bitbucket de Devin puisse gérer les webhooks, ses dépôts s’affichent avec le statut Skipped jusqu’à ce que vous la remplaciez.
  1. Créez un nouveau compte Bitbucket spécifiquement pour Devin (comme vous le feriez pour un compte personnel). Vous utiliserez ce compte, et non votre compte personnel, pendant le processus d’intégration.
  2. Dans votre compte Devin, allez dans Settings > Connections > Bitbucket et cliquez sur « Connect ».
Connecter Bitbucket Cloud
  1. Vous serez redirigé vers Bitbucket, où vous devrez :
    • Vous connecter avec le compte Bitbucket que vous avez créé pour Devin (et non votre compte personnel)
    • Accorder les autorisations nécessaires pour que Devin puisse travailler avec vos dépôts
  2. Une fois cette étape terminée, vous serez renvoyé vers la page des paramètres de Devin, où vous pourrez confirmer que l’intégration est active.

Remplacer une ancienne connexion OAuth

Une connexion OAuth conserve les autorisations dont elle disposait au moment où elle a été liée. Une connexion liée avant que l’application Bitbucket de Devin puisse gérer les webhooks affiche donc ses dépôts comme Skipped, et son statut de webhook vous invite à la reconnecter. Il n’est pas possible de la reconnecter telle quelle : une nouvelle connexion ajoute une seconde connexion portant le même nom, et la première reste Skipped. Remplacez plutôt l’ancienne connexion :
  1. Ouvrez le panneau de détails de la connexion et notez les réglages que vous y avez modifiés, comme ses autorisations de dépôt et Manage access. Aucun de ces réglages n’est reporté sur la nouvelle connexion.
  2. Dans l’onglet General, cliquez sur Disconnect connection. Devin n’a plus accès à ces dépôts tant que l’étape suivante n’est pas terminée.
  3. Dans Settings > Connections > Bitbucket, ouvrez la liste déroulante à côté de Connect with access token, sélectionnez Connect with OAuth (any Bitbucket plan), puis connectez-vous avec le même compte Bitbucket.
  4. Réappliquez les réglages notés à l’étape 1. Au départ, la nouvelle connexion a accès à tous les espaces de travail visibles par le compte lié. Sur un compte Enterprise, elle n’a au départ accès à aucune organisation : accordez-lui de nouveau l’accès à vos organisations.
Devin installe ensuite lui-même les webhooks, et le panneau de détails de la nouvelle connexion affiche le résultat pour chaque dépôt. Si vous vous êtes déjà reconnecté, vous avez deux connexions portant le même nom. Notez les paramètres de chacune, déconnectez-les toutes les deux, puis connectez-vous une seule fois comme indiqué aux étapes 3 et 4.

Bitbucket Data Center

Pour les organisations utilisant Bitbucket Data Center (autohébergé), procédez comme suit :
  1. Créez un compte de service dédié pour Devin dans votre instance Bitbucket Data Center.
  2. Dans votre compte Devin, accédez à Settings > Connections > Bitbucket, ouvrez le menu déroulant à côté du bouton Connect, puis sélectionnez Connect with Bitbucket Data Center.
Connecter Bitbucket Data Center
  1. Configurez la connexion en indiquant :
    • Bitbucket Host : le domaine de votre Bitbucket Data Center (par exemple bitbucket.mycompany.com)
    • Bitbucket Username : le nom d’utilisateur du compte de service
    • Bitbucket HTTP Access Token : un HTTP access token créé pour le compte de service. Vous pourrez le remplacer ultérieurement via Rotate access token dans le panneau de détails de la connexion.
Configuration de Bitbucket Data Center
  1. Accordez au compte de service les autorisations appropriées au niveau des projets et des repositories dans votre instance Bitbucket Data Center.
  2. Une fois la configuration terminée, le statut de l’intégration sera confirmé dans vos paramètres Devin.

Configuration du webhook (Bitbucket Data Center)

La configuration d’un webhook permet à Devin de recevoir en temps réel les événements de pull request de Bitbucket Data Center, afin que le statut et les commentaires de la PR soient transmis à la session Devin qui travaille sur cette PR.
  1. Dans votre compte Devin, allez dans Settings > Connections > Bitbucket et cliquez sur la connexion Bitbucket Data Center pour ouvrir son panneau de détails.
  2. Dans l’onglet General, cliquez sur Configure sur la ligne Webhook. La boîte de dialogue affiche l’URL du webhook ainsi qu’un secret token — copiez le token dès maintenant, car il n’est affiché qu’une seule fois (vous pourrez le régénérer ultérieurement depuis cette même boîte de dialogue).
  3. Dans Bitbucket Data Center, ouvrez les paramètres du repository ou du projet, puis allez dans Webhooks.
  4. Créez un webhook et collez-y l’URL du webhook.
  5. Sous les événements Pull request, sélectionnez Opened, Source branch updated, Merged, Declined et Comment added.
  6. Sous Authentication, choisissez Basic, saisissez n’importe quel nom d’utilisateur et collez le secret token en guise de mot de passe.
Les connexions Bitbucket Cloud ne disposent pas de boîte de dialogue de webhook : Devin installe lui-même les webhooks, sur une connexion par jeton d’accès ou sur une connexion OAuth dont le compte Bitbucket lié est administrateur du repository.
Par défaut, toutes les actions de Devin sur Bitbucket Data Center sont attribuées au compte de service. En associant votre propre compte, vous pouvez commenter, ajouter ou retirer des relecteurs, approuver et refuser des pull requests (PR) en votre nom depuis Devin Review. Configuration administrateur (une seule fois par hôte Bitbucket Data Center) :
  1. Dans Devin, accédez à Settings > Connections > Bitbucket et cliquez sur Register app sous Bitbucket Data Center user OAuth. La boîte de dialogue indique l’URL de redirection et les autorisations à utiliser.
  2. Dans Bitbucket Data Center, accédez à Administration > Application links, sélectionnez Create link, puis choisissez External application et Incoming. Collez l’URL de redirection et accordez l’autorisation Repositories: Write.
  3. Collez le client ID et le client secret de l’application dans la boîte de dialogue de Devin, puis cliquez sur Register.
Pour chaque utilisateur : associez votre compte Bitbucket lorsque Devin Review vous y invite, ou depuis la section des comptes associés de votre profil.
Supprimer l’application enregistrée dans Devin dissocie le compte Bitbucket Data Center de tous les utilisateurs de cet hôte.

Utiliser Devin avec l’intégration Bitbucket

Après avoir connecté Bitbucket, configurez vos dépôts sur Devin’s Machine.
Comment Devin réagit aux commentaires sur les PR.
  • Bitbucket Cloud : Devin ne sort pas automatiquement de veille pour les commentaires sur ses pull requests. Il peut néanmoins les traiter si vous les lui signalez directement dans la session. Les webhooks que Devin installe sur une connexion Cloud sont destinés à Devin Review, et non aux sessions.
  • Bitbucket Data Center : une fois le webhook configuré, tout commentaire sur une pull request suivie par une session Devin est transmis à cette session, et Devin y répond. Un administrateur d’organisation peut restreindre ce comportement via l’option Require @Devin to respond dans Settings > Devin > Pull requests : Devin ne répond alors qu’aux commentaires commençant par @Devin ou par le mot Devin seul, comme Devin fix this (le préfixe devinai est également accepté). Les commentaires contenant (aside) ou !aside, ou commençant par aside, sont toujours ignorés. En l’absence de webhook, Data Center se comporte comme Bitbucket Cloud.

Bonnes pratiques

  • Créez un compte Bitbucket dédié pour Devin
  • Activez la protection des branches sur les branches main/master
  • Accordez au compte de service les autorisations appropriées sur l’espace de travail et les dépôts
  • Sur Bitbucket Cloud, liez un compte Bitbucket créé pour Devin (administrateur du dépôt) lors de la connexion via OAuth ; Devin publie alors en tant que compte lié
  • Sur Bitbucket Data Center, configurez le webhook afin que Devin reçoive les événements de PR en temps réel