Bitbucket-Integration

Integriere Bitbucket -Commits, -Bereiche und -Pull-Requests mit ClickUp-Aufgaben. Dies ermöglicht Ihnen:

  • Sehen Sie alle Bitbucket-Aktivitäten, die mit einer Aufgabe in ClickUp zusammenhängen.

  • Optional erhältst du Benachrichtigungen über ClickUp-Elemente, wenn neue Bitbucket-Aktivitäten zu Aufgaben hinzugefügt werden.

  • Binden Sie automatisch (oder manuell) Aktivitäten von Bitbucket an ClickUp-Aufgaben an.

  • Ändern Sie automatisch Status mit Bitbucket-Aktionen, indem Sie die ClickUp-Aufgaben-ID Ihren Commits in diesem Format hinzufügen #{taskID}[status] Zum Beispiel: #1abc2de[geschlossen]

Screenshot einer Benachrichtigung über Aktivitäten in einer Bitbucket-Aufgabe.

Was du wissen musst

Autorisieren Sie ClickUp, eine Verbindung zu Bitbucket herzustellen

Sie können ClickUp und Bitbucket.org oder die selbst gehostete Version von Bitbucket integrieren. Der Autorisierungsprozess unterscheidet sich je nach verwendeter Bitbucket-Version.

Option 1: Autorisieren Sie ein Bitbucket.org -Konto

Hinweis: Nur ClickUp Administratoren können Repositories zu den Spaces Ihres Teams hinzufügen.

  1. Öffnen Sie das App-Center.
  2. Klicken Sie auf Bitbucket.
  3. Klicken Sie auf Bitbucket für Team aktivieren.
  4. Klicken Sie auf + Bitbucket hinzufügen.
  5. Wählen Sie Nein, ich verwende bitbucket.com und klicken Sie auf Bitbucket verknüpfen.

    Screenshot der Aufforderung, den Typ des Bitbucket Kontos auszuwählen, das du verwendest.
  6. Wenn Sie nicht angemeldet sind, werden Sie aufgefordert, sich bei Ihrem Bitbucket.org-Konto anzumelden

  7. Überprüfen Sie die erforderlichen Berechtigungen und klicken Sie auf Zugriff gewähren

Screenshot der Berechtigungsnachricht zur Autorisierung von ClickUp.

Nachdem Sie Ihr Konto autorisiert haben, gehen Sie zum nächsten Schritt über und verknüpfen Sie Ihre Bitbucket-Repositorys mit Ihrem Workspace.

Option 2: Autorisieren Sie ein selbstgehostetes Bitbucket -Konto

Wenn Sie eine selbst gehostete Version von Bitbucket verwenden, können Sie ClickUp durch Erstellen eines HTTP-Zugriffstokens autorisieren. Erfahren Sie mehr über Bitbucket HTTP-Zugriffstoken.

  1. Öffnen Sie das App-Center.
  2. Klicken Sie auf Bitbucket
  3. Klicken Sie auf Bitbucket für Team aktivieren
  4. Klicken + Bitbucket hinzufügen
  5. Wählen Sie Ja, ich verwende eine gehostete Version von Bitbucket und folgen Sie den nächsten Schritten in Bitbucket.

    Screenshot der Option, die gehostete Version von Bitbucket zu verwenden.
  6. Klicken Sie in Ihrem gehosteten Bitbucket oben rechts auf Ihren Benutzerprofil-Avatar.

  7. Wählen Sie Konto verwalten.

    Screenshot des Benutzerprofilmenüs von Bitbucket.
  8. Wählen Sie HTTP Zugriffstokens in der Seitenleiste aus.

  9. Erstellen Sie ein neues Zugriffstoken mit Administrator -Berechtigungen für Projekte und Repositorys.

  10. Kopieren Sie das HTTP-Zugangstoken, das bereitgestellt wird.

  11. Fügen Sie in ClickUp den kopierten Token in das Feld Zugriffstoken ein.

  12. Gib die Details deines Bitbucket-Kontos ein:

    • Host-URL

    • Kanonische URL (optional)

    Screenshot der Bitbucket-Kontodetails.
  13. Wählen Sie Ihre Einstellungen:

    • Gehostetes Geheimnis verwenden?

    • Statische IP

  14. Klicke auf Link Bitbucket.

Nachdem Sie Ihr Konto autorisiert haben, gehen Sie zum nächsten Schritt über und verknüpfen Sie Ihre Bitbucket-Repositorys mit Ihrem Workspace.

Verknüpfen Sie Bitbucket-Repositorys mit Ihrem Workspace.

ClickUp ermöglicht es mehreren Personen, Bitbucket innerhalb Ihres Workspaces zu autorisieren, und erlaubt Ihnen auch, anzupassen, welche Repositories mit Ihrem Workspace geteilt werden.

Das bedeutet, dass Sie Ihr persönliches Konto autorisieren können, ohne alle Ihre Repositories anzuhängen; Sie können individuell auswählen, welche angehängt werden sollen.

Durch das Anhängen eines Repositorys erhalten Benutzer keinen Zugriff auf die Codebase deines Repositorys. Sie ermöglicht es den Benutzern, die Elemente des Verlaufs dieses Repositorys an den/die von dir angegebenen Space(s) anzuhängen.

Hinweis: Sie können nur Bitbucket-Repositorys verknüpfen, bei denen Sie Administratorzugriff haben.

Screenshot von Bitbucket-Repositorys und der Option, diese zu ClickUp hinzuzufügen.

Schritt 3: Wählen Sie, welche Spaces mit Ihren Repositories verbunden sind

Sie können anpassen, welche Spaces mit Repositories verbunden sind, indem Sie das Dropdown-Menü rechts von Team Repos erweitern. Um Bitbucket-Elemente an Aufgaben anzuhängen, muss der Space mit dem Repository verbunden sein.

Screenshot zeigt die Verknüpfung von Bitbucket-Repositorys mit ClickUp-Spaces.

Bitbucket-Aktivitäten automatisch in ClickUp zuordnen

ClickUp erfasst automatisch jede neue Aktivität und ordnet sie den Aufgaben zu.

Um dies zu ermöglichen, müssen Sie:

Fügen Sie eine ClickUp Aufgaben-ID an beliebiger Stelle des Pull-Request-Titels, des Branch-Namens oder der Commit-Nachricht in einem dieser Formate hinzu:

#{task_id}

CU-{task_id}

{custom_task_id}

Zum Beispiel:

#1abc2de

CU-1abc2de

prefix-1

Manuelle Zuordnung von Bitbucket-Aktivitäten

Screenshot des Bitbucket-Symbols auf einer ClickUp-Aufgabe.
  1. Klicken Sie auf das Bitbucket-Symbol bei einer beliebigen Aufgabe

  2. Wählen Sie ein Repo aus

  3. Wählen Sie einen Bereich

  4. Fügen Sie Ihren Commit hinzu

Aufgabenstatus automatisch über Bitbucket ändern

Sie können auch den Status einer Aufgabe über ein Commit oder einen Pull Request ändern.
Um dies zu tun:

Fügen Sie die Aufgaben-ID von ClickUp in einem Teil der Commit-Nachricht sowie den gewünschten Status in Klammern ein.
Zum Beispiel: #ud5b[ready]

Animation einer Statusänderung einer Aufgabe durch einen Git-Push in Bitbucket.

Hinweis: Sie können auch Aufgaben-IDs von Bitbucket zurück zu ClickUp verlinken!

Screenshot eines Commits in Bitbucket.
  1. Gehe zu den Repository-Einstellungen

  2. Klicken Sie auf Links

  3. Neuen Link hinzufügen

  4. Verknüpfungstyp: Benutzerdefiniert

  5. Link-URL: app.clickup.com/t/\1

  6. Link-Schlüssel: CU-(\w{3,10})(\[\w+\])?

Dies gilt sowohl für Commits als auch für Pull Requests.

Aktionen

Erstelle schnell und einfach neue Bereiche aus ClickUp heraus mit unseren schnellen Aktionen.

  1. Klicken Sie auf das Bitbucket-Symbol, um das Git-Modalfenster zu öffnen

  2. Auf der linken Seite finden Sie eine Vielzahl von automatisch generierten Schnellkopieroptionen wie vorgeschlagener Name, Befehl zum Auschecken und Verknüpfen eines neuen Bereichs lokal, Befehl zum Verknüpfen eines einzelnen Commits oder ein Befehl zum Öffnen eines Pull-Requests

Screenshot des Git-Branch-Modals in einer ClickUp-Aufgabe.

Sie können den automatisch generierten Namen in den Einstellungen der Bitbucket-Integration anpassen!

Screenshot der Einstellungen für den Bitbucket-Bereichsnamen.

Pull Requests

Nun können Sie Pull Requests direkt in ClickUp erstellen oder bestehende verknüpfen! So erstellen Sie einen neuen Pull Request in ClickUp:

  1. Klicke auf das Bitbucket-Symbol der Aufgabe, mit der du sie verknüpfen möchtest, und klicke auf den Button "New Pull Request".

  2. Im modalen Fenster wird ein vorgeschlagener Titel für den Pull Request automatisch ausgefüllt. Wenn Ihnen der automatisch generierte Titel nicht gefällt, können Sie ihn in den Bitbucket-Integrationseinstellungen anpassen.

  3. Wählen Sie einen Ziel- und Quellbereich

  4. Beschreibung eingeben

  5. Erstellen Sie den Pull-Request.

Sobald Sie einen Pull-Request in ClickUp erstellen oder einen vorhandenen verlinken, wird ein Link zur zugehörigen ClickUp-Aufgabe dem Pull-Request hinzugefügt!

Screenshot einer mit einer Aufgabe verknüpften Benachrichtigung in Bitbucket.

Sobald ein Pull-Request verknüpft ist, können Sie sehen, wer ihn geöffnet hat, den Prüfer (falls einer zugewiesen ist), den CI/CD-Status und den Status des Pull-Requests (offen, Überprüfung angefordert, in Überprüfung, zusammengeführt, geschlossen) direkt in der verknüpften ClickUp-Aufgabe!

Screenshot der Pull Request Aktivität in ClickUp's modalem Fenster.

Hast du Probleme mit Bitbucket?

Lies unser Dokument zur Fehlerbehebung oder frage den Kundensupport von Bitbucket hier.

Bitbucket-Integration entfernen

Nur Workspace-Eigentümer und Administratoren können Integrationen deaktivieren.

Um die Integration zu entfernen, aus dem App-Center:

  1. Wähle Bitbucket aus.
  2. Scrollen Sie nach unten und klicken Sie auf Die Autorisierung für meine Bitbucket-Repositorys entfernen.

War dieser Beitrag hilfreich?