Skip to main content

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

Die Einrichtung ist ganz einfach! So starten Sie:
  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.

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-Account zu Settings > Connections > Bitbucket und klicken Sie auf die Bitbucket-Data-Center-Verbindung, um deren Detailbereich zu öffnen.
  2. Klicken Sie im Tab 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.
Webhooks stehen nur für Bitbucket-Data-Center-Verbindungen zur Verfügung. Bitbucket-Cloud-Verbindungen bieten keine Webhook-Option.

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.
  • 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 beginnen (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 Servicekonto die entsprechenden Workspace- und Repository-Berechtigungen
  • Konfigurieren Sie im Bitbucket Data Center den Webhook, damit Devin PR-Events in Echtzeit erhält