GitHub-Konnektor einrichten¶
Der GitHub-Konnektor synchronisiert Dateien aus GitHub-Repositories in die Wissensdatenbank der Plattform. Ideal für technische Dokumentation, README-Dateien und Wikis.
Nur für Administratoren
Voraussetzungen¶
- Ein GitHub-Konto mit Zugriff auf das gewünschte Repository
- Ein Personal Access Token (PAT) mit
repo-Berechtigung
Konnektor erstellen¶
- Öffnen Sie das Customer Portal → Konnektoren
- Klicken Sie auf Neuer Konnektor
- Wählen Sie den Typ GitHub
- Füllen Sie die Konfiguration aus:
| Feld | Beschreibung | Beispiel |
|---|---|---|
| Name | Bezeichnung für den Konnektor | GitHub Doku-Repo |
| Repository | Pfad zum Repository | firma/dokumentation |
| Branch | Branch zur Synchronisation | main |
| Token | GitHub Personal Access Token | ghp_*** |
| Pfad-Filter | Optional: Nur bestimmte Ordner/Dateien | docs/**/*.md |
| Zugriffsgruppe | Optional: Zugriffsgruppe für die synchronisierten Dokumente | Entwicklung |
- Klicken Sie auf Verbindung testen
- Nach erfolgreichem Test können Sie die Dateien und Ordner des Repositories direkt im Portal durchsuchen und den gewünschten Pfad-Filter gezielt setzen
- Bei Erfolg: Speichern
Personal Access Token erstellen¶
- Gehen Sie zu GitHub → Settings → Developer Settings → Personal Access Tokens → Fine-grained tokens
- Klicken Sie auf Generate new token
- Vergeben Sie einen Namen und wählen Sie das Repository
- Berechtigung: Contents → Read-only
- Klicken Sie auf Generate token
- Kopieren Sie den Token
Synchronisation starten¶
Nach dem Erstellen können Sie die erste Synchronisation manuell starten. Siehe Synchronisation starten und überwachen.