Warum Devin mit Bitbucket integrieren?
Durch die Integration von Devin in deine Bitbucket-Repositories kann Devin Pull Requests erstellen, PR-Kommentare lesen und beantworten und effektiv mit deinem Team zusammenarbeiten. So wird Devin zu einem echten Teammitglied in deinem Engineering-Team.Voraussetzungen
Bevor Sie die Bitbucket-Integration einrichten, empfehlen wir:- Dediziertes Servicekonto – Erstellen Sie ein neues Bitbucket-Konto speziell für Devin (z. B.
devin@yourcompany.com), anstatt ein bestehendes Benutzerkonto zu verwenden, um ein übersichtlicheres Zugriffsmanagement und nachvollziehbare Audit-Trails zu gewährleisten.
Die Verwendung eines dedizierten Servicekontos macht es einfacher, die Aktivitäten von Devin nachzuverfolgen, Berechtigungen zu verwalten und Sicherheits-Best-Practices in Ihrer gesamten Organisation einzuhalten.
Einrichten der Integration
Bitbucket Cloud
Für Bitbucket Cloud gibt es zwei Arten von Verbindungen. Wählen Sie die Variante, die zu den Aufgaben passt, die Devin übernehmen soll:
„Devins eigene Schreibvorgänge“ sind die Pull-Requests, die Devin öffnet, sowie die Befunde und Aktualisierungen der Beschreibung, die Devin Review veröffentlicht. Aktionen, die Sie selbst in Devin Review ausführen (Kommentare, Antworten, Ablehnen eines Pull-Requests), werden bei beiden Verbindungsarten unter Ihrem Namen über Ihr eigenes verknüpftes Bitbucket-Konto veröffentlicht; siehe Devin Review.
Mit einem Access-Token verbinden
-
Erstellen Sie in Bitbucket ein Workspace-Access-Token für den Workspace, in dem Devin arbeiten soll, mit den folgenden Scopes:
- Repositories: Admin
- Pull requests: Write
- Webhooks: Read and write
- Navigieren Sie in Ihrem Devin-Konto zu Settings > Connections > Bitbucket, öffnen Sie das Dropdown neben der Schaltfläche Connect und wählen Sie Connect with access token aus.
-
Geben Sie die Workspace-ID (also
my-workspaceinbitbucket.org/my-workspace) und das Token ein und klicken Sie anschließend auf Connect.
Mit OAuth verbinden
Verwenden Sie OAuth, wenn Ihr Workspace nicht Bitbucket Cloud Premium nutzt. Eine OAuth-Verbindung ist die eigene Bitbucket-Autorisierung des verknüpften Kontos: Devins eigene Schreibvorgänge (die Pull-Requests, die Devin öffnet, sowie die Befunde und Beschreibungs-Updates, die Devin Review veröffentlicht) erscheinen unter diesem Konto, und Webhooks werden nur in Repositorys installiert, für die dieses Konto Administratorrechte hat. Deshalb beginnen die folgenden Schritte mit einem dedizierten Bitbucket-Konto: Verknüpfen Sie für die Organisation niemals das Konto einer einzelnen Person. Wurde die Verbindung verknüpft, bevor Devins Bitbucket-App Webhooks verwalten konnte, werden ihre Repositorys als Skipped angezeigt, bis Sie sie ersetzen.- Erstellen Sie ein neues Bitbucket-Konto speziell für Devin (genauso wie Sie ein persönliches Konto erstellen würden). Verwenden Sie für die Integration dieses Konto, nicht Ihr persönliches.
- Gehen Sie in Ihrem Devin-Konto zu Settings > Connections > Bitbucket und klicken Sie auf „Connect“.

-
Sie werden zu Bitbucket weitergeleitet. Dort sollten Sie:
- sich mit dem Bitbucket-Konto anmelden, das Sie für Devin erstellt haben (nicht mit Ihrem persönlichen Konto)
- die erforderlichen Berechtigungen erteilen, damit Devin mit Ihren Repositorys arbeiten kann
- Anschließend kehren Sie zur Devin-Einstellungsseite zurück, wo Sie überprüfen können, dass die Integration aktiv ist.
Ältere OAuth-Verbindung ersetzen
Eine OAuth-Verbindung behält die Berechtigungen, die sie zum Zeitpunkt der Verknüpfung hatte. Eine Verbindung, die verknüpft wurde, bevor die Bitbucket-App von Devin Webhooks verwalten konnte, zeigt ihre Repositories daher als Skipped an, und ihr Webhook-Status fordert Sie auf, sie erneut zu verbinden. Eine bestehende Verbindung lässt sich jedoch nicht direkt erneut verbinden: Ein erneutes Verbinden legt eine zweite Verbindung mit demselben Namen an, und die erste bleibt Skipped. Ersetzen Sie stattdessen die alte Verbindung:- Öffnen Sie den Detailbereich der Verbindung und notieren Sie, was Sie dort angepasst haben, z. B. die Repository-Berechtigungen und Manage access. Keine dieser Einstellungen wird in die neue Verbindung übernommen.
- Klicken Sie auf der Registerkarte General auf Disconnect connection. Bis der nächste Schritt abgeschlossen ist, hat Devin keinen Zugriff auf diese Repositories.
- Öffnen Sie unter Settings > Connections > Bitbucket das Dropdown neben Connect with access token, wählen Sie Connect with OAuth (any Bitbucket plan) aus und melden Sie sich mit demselben Bitbucket-Konto an.
- Übernehmen Sie die in Schritt 1 notierten Einstellungen erneut. Die neue Verbindung hat zunächst Zugriff auf alle Workspaces, die das verknüpfte Konto sehen kann. Bei einem Enterprise-Konto hat sie anfangs keinen Zugriff auf Organisationen. Gewähren Sie ihn Ihren Organisationen daher erneut.
Bitbucket Data Center
Für Organisationen, die Bitbucket Data Center (selbstgehostet) verwenden, gehen Sie wie folgt vor:- Erstellen Sie ein dediziertes Servicekonto in Ihrer Bitbucket-Data-Center-Instanz für Devin.
- Gehen Sie in Ihrem Devin-Konto zu Settings > Connections > Bitbucket, öffnen Sie das Dropdown neben der Schaltfläche Connect und wählen Sie Connect with Bitbucket Data Center aus.

- Konfigurieren Sie die Verbindung, indem Sie Folgendes angeben:
- Bitbucket Host: Ihre Bitbucket-Data-Center-Domain (z. B.
bitbucket.mycompany.com) - Bitbucket Username: der Nutzername des Servicekontos
- Bitbucket HTTP Access Token: ein HTTP-Access-Token, das für das Servicekonto erstellt wurde. Sie können es später über Rotate access token im Detailbereich der Verbindung ersetzen.
- Bitbucket Host: Ihre Bitbucket-Data-Center-Domain (z. B.

- Gewähren Sie dem Servicekonto die entsprechenden Projekt- und Repository-Berechtigungen in Ihrer Bitbucket-Data-Center-Instanz.
- Sobald die Konfiguration abgeschlossen ist, sehen Sie in Ihren Devin-Einstellungen, dass der Integrationsstatus bestätigt ist.
Webhook-Konfiguration (Bitbucket Data Center)
Mit einem konfigurierten Webhook kann Devin Pull-Request-Events aus Bitbucket Data Center in Echtzeit empfangen, sodass PR-Status und Kommentare an die Devin-Sitzung übermittelt werden, die am PR arbeitet.- Gehen Sie in Ihrem Devin-Konto zu Settings > Connections > Bitbucket und klicken Sie auf die Bitbucket-Data-Center-Verbindung, um deren Detailbereich zu öffnen.
- Klicken Sie auf der Registerkarte General in der Zeile Webhook auf Configure. Der Dialog zeigt die Webhook-URL und ein Secret-Token an – kopieren Sie das Token jetzt, denn es wird nur einmal angezeigt (Sie können es später über denselben Dialog neu generieren).
- Öffnen Sie in Bitbucket Data Center die Repository- oder Projekteinstellungen und gehen Sie zu Webhooks.
- Erstellen Sie einen Webhook und fügen Sie die Webhook-URL ein.
- Wählen Sie unter den Pull request-Events die Optionen Opened, Source branch updated, Merged, Declined und Comment added aus.
- Wählen Sie unter Authentication die Option Basic, geben Sie einen beliebigen Nutzernamen ein und fügen Sie das Secret-Token als Passwort ein.
Für Bitbucket-Cloud-Verbindungen gibt es keinen Webhook-Dialog: Devin richtet die Webhooks selbst ein – bei einer Access-Token-Verbindung oder bei einer OAuth-Verbindung, deren verknüpftes Bitbucket-Konto Administrator des Repositorys ist.
Ihr Bitbucket Data Center-Konto verknüpfen
Standardmäßig wird alles, was Devin in Bitbucket Data Center ausführt, dem Dienstkonto zugeordnet. Wenn Sie Ihr eigenes Konto verknüpfen, können Sie in Devin Review unter Ihrem eigenen Namen kommentieren, Reviewer hinzufügen oder entfernen sowie PRs genehmigen und ablehnen. Admin-Setup (einmalig pro Bitbucket Data Center-Host):- Gehen Sie in Devin zu Settings > Connections > Bitbucket und klicken Sie unter Bitbucket Data Center user OAuth auf Register app. Im Dialog werden die zu verwendende Weiterleitungs-URL und die erforderlichen Berechtigungen angezeigt.
- Gehen Sie in Bitbucket Data Center zu Administration > Application links, wählen Sie Create link und anschließend External application und Incoming. Fügen Sie die Weiterleitungs-URL ein und erteilen Sie die Berechtigung Repositories: Write.
- Fügen Sie die Client-ID und das Client-Secret der Anwendung in den Devin-Dialog ein und klicken Sie auf Register.
Wenn Sie die registrierte Anwendung in Devin entfernen, wird die Verknüpfung der Bitbucket Data Center-Konten aller Nutzer auf diesem Host aufgehoben.
Devin mit der Bitbucket-Integration verwenden
Nachdem Sie Bitbucket verbunden haben, richten Sie Ihre Repositorys auf Devin’s Machine ein.Wie Devin auf PR-Kommentare reagiert.
- Bitbucket Cloud: Devin wacht bei Kommentaren zu seinen Pull-Requests nicht automatisch auf. Devin kann sie dennoch bearbeiten, wenn Sie ihn in der Sitzung direkt darauf hinweisen. Die Webhooks, die Devin bei einer Cloud-Verbindung installiert, sind für Devin Review bestimmt, nicht für Sitzungen.
- Bitbucket Data Center: Sobald der Webhook konfiguriert ist, wird ein Kommentar zu einem Pull-Request, den eine Devin-Sitzung verfolgt, an diese Sitzung übermittelt und Devin antwortet darauf. Ein Organisations-Admin kann dies über Require @Devin to respond unter Settings > Devin > Pull requests einschränken, sodass Devin nur auf Kommentare antwortet, die mit
@DevinoderDevinals eigenständigem Wort beginnen, etwaDevin fix this(das Präfixdevinaiwird ebenfalls akzeptiert). Kommentare, die(aside)oder!asideenthalten oder mitasidebeginnen, werden immer ignoriert. Ohne Webhook verhält sich Data Center wie Bitbucket Cloud.
Best Practices
- Erstellen Sie ein dediziertes Bitbucket-Konto für Devin
- Aktivieren Sie Branch-Schutz für die Branches main und master
- Gewähren Sie dem Dienstkonto die entsprechenden Workspace- und Repository-Berechtigungen
- Verknüpfen Sie in Bitbucket Cloud beim Verbinden über OAuth ein eigens für Devin angelegtes Bitbucket-Konto (mit Repository-Admin-Rechten); Devin postet dann unter dem verknüpften Konto
- Konfigurieren Sie im Bitbucket Data Center den Webhook, damit Devin PR-Events in Echtzeit erhält

