Zum Hauptinhalt springen

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.
Devin installiert die für das Auto-Review von Devin Review benötigten Webhooks bei beiden Verbindungsarten selbst, allerdings nur dort, wo die Verbindung das Repository verwalten darf: bei einem Access-Token mit Webhooks: Read and write und Repositories: Admin oder bei einer OAuth-Verbindung, deren verknüpftes Bitbucket-Konto Administrator des Repositorys ist. Andernfalls wird das Repository im Webhook-Status der Verbindung mit der von Bitbucket angegebenen Begründung als Skipped angezeigt, und Reviews laufen nur, wenn Sie einen Pull-Request selbst in Devin Review öffnen.

Mit einem Access-Token verbinden

  1. 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
    Mit eingeschränkteren Scopes kann Devin weder den Merge-Status lesen noch Webhooks installieren.
  2. 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.
  3. Geben Sie die Workspace-ID (also my-workspace in bitbucket.org/my-workspace) und das Token ein und klicken Sie anschließend auf Connect.
Devin verwendet das Token für diesen Workspace und postet im Namen des Tokens, nicht in Ihrem Namen. Sobald die Verbindung aktiv ist, installiert Devin seine Webhooks selbstständig in den Repositories des Workspace. Im Detailbereich der Verbindung sehen Sie das Ergebnis für jedes Repository sowie eine Schaltfläche Refresh, über die Sie die Installation erneut ausführen können.

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.
  1. 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.
  2. Gehen Sie in Ihrem Devin-Konto zu Settings > Connections > Bitbucket und klicken Sie auf „Connect“.
Bitbucket Cloud verbinden
  1. 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
  2. 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:
  1. Ö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.
  2. Klicken Sie auf der Registerkarte General auf Disconnect connection. Bis der nächste Schritt abgeschlossen ist, hat Devin keinen Zugriff auf diese Repositories.
  3. Ö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.
  4. Ü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.
Devin installiert die Webhooks anschließend selbst, und der Detailbereich der neuen Verbindung zeigt das Ergebnis für jedes Repository an. Falls Sie sich bereits erneut verbunden haben, gibt es zwei Verbindungen mit demselben Namen. Notieren Sie die Einstellungen beider Verbindungen, trennen Sie beide und verbinden Sie sich anschließend einmal neu, wie in den Schritten 3 und 4 beschrieben.

Bitbucket Data Center

Für Organisationen, die Bitbucket Data Center (selbstgehostet) verwenden, gehen Sie wie folgt vor:
  1. Erstellen Sie ein dediziertes Servicekonto in Ihrer Bitbucket-Data-Center-Instanz für Devin.
  2. 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.
Bitbucket Data Center verbinden
  1. 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-Data-Center-Konfiguration
  1. Gewähren Sie dem Servicekonto die entsprechenden Projekt- und Repository-Berechtigungen in Ihrer Bitbucket-Data-Center-Instanz.
  2. 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.
  1. Gehen Sie in Ihrem Devin-Konto zu Settings > Connections > Bitbucket und klicken Sie auf die Bitbucket-Data-Center-Verbindung, um deren Detailbereich zu öffnen.
  2. 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).
  3. Öffnen Sie in Bitbucket Data Center die Repository- oder Projekteinstellungen und gehen Sie zu Webhooks.
  4. Erstellen Sie einen Webhook und fügen Sie die Webhook-URL ein.
  5. Wählen Sie unter den Pull request-Events die Optionen Opened, Source branch updated, Merged, Declined und Comment added aus.
  6. 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.
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):
  1. 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.
  2. 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.
  3. Fügen Sie die Client-ID und das Client-Secret der Anwendung in den Devin-Dialog ein und klicken Sie auf Register.
Für jeden Nutzer: Verknüpfen Sie Ihr Bitbucket-Konto, sobald Devin Review Sie dazu auffordert, oder über die verknüpften Konten in Ihrem Profil.
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 @Devin oder Devin als eigenständigem Wort beginnen, etwa Devin fix this (das Präfix devinai wird ebenfalls akzeptiert). Kommentare, die (aside) oder !aside enthalten oder mit aside beginnen, 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