Bitbucket-Konnektor einrichten¶
Der Bitbucket-Konnektor synchronisiert Dateien aus Repositories einer selbst gehosteten Bitbucket Data Center / Server-Instanz in die Wissensdatenbank der Plattform. Ideal für technische Dokumentation, README-Dateien und Wikis in On-Premise-Umgebungen.
Nur für Administratoren
Nur Data Center / Server (On-Premise)
Der Konnektor unterstützt ausschließlich selbst gehostete Bitbucket-Instanzen (Bitbucket Data Center / Server, REST API 1.0). Bitbucket Cloud (bitbucket.org) wird nicht unterstützt, da die Cloud-Variante eine andere, inkompatible API verwendet.
Voraussetzungen¶
- Eine erreichbare Bitbucket Data Center / Server-Instanz (On-Premise)
- Ein Benutzerkonto mit Lesezugriff auf das gewünschte Repository
- Projekt-Key und Repository-Slug des gewünschten Repositories
Konnektor erstellen¶
- Öffnen Sie das Customer Portal → Konnektoren
- Klicken Sie auf Neuer Konnektor
- Wählen Sie den Typ Bitbucket
- Füllen Sie die Konfiguration aus:
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Name | Bezeichnung für den Konnektor | Bitbucket Doku-Repo |
| Bitbucket Base URL | URL der Bitbucket-Instanz | https://bitbucket.unternehmen.local |
| Benutzername | Benutzername mit Lesezugriff | bitbucket-user |
| Passwort | Passwort des Benutzerkontos | *** |
| Project Key | Key des Bitbucket-Projekts | IT |
| Repository Slug | Repository-Slug | dokumentation |
| Branch | Branch zur Synchronisation (Standard: main) |
main |
| Ordnerpfad | Optional: Nur bestimmten Ordner synchronisieren (Standard: /) |
/docs |
| Dateimuster | Optional: Kommagetrennte Glob-Muster für Dateitypen | *.md,*.txt |
| SSL-Zertifikat prüfen | SSL-Zertifikat verifizieren (Standard: an) | an |
| Zugriffsgruppe | Optional: Zugriffsgruppe für die synchronisierten Dokumente | Entwicklung |
- Klicken Sie auf Verbindung testen
- Bei Erfolg: Speichern
Unterstützte Dateitypen¶
Der Konnektor synchronisiert die üblichen Dokument- und Textformate, u. a. md, txt, pdf, docx, xlsx, pptx, html, json, yaml und csv. Mit dem Dateimuster-Feld (Glob-Muster wie *.md,*.txt) lässt sich die Auswahl gezielt einschränken.
Synchronisation starten¶
Nach dem Erstellen können Sie die erste Synchronisation manuell starten. Der Konnektor unterstützt inkrementelle Synchronisation (Delta-Sync) und überträgt bei späteren Läufen nur geänderte Dateien. Siehe Synchronisation starten und überwachen.