So importierst du ein privates Repository
Ein Eigentümer der Organisation fügt unter Integrationen → Code-Hosts ein schreibgeschütztes Token für den Git-Host hinzu. Danach kann jeder, der Screenings baut, daraus importieren.
Um ein privates Repository zu importieren, speichert ein Eigentümer der Organisation unter Integrationen im Abschnitt Code-Hosts ein schreibgeschütztes Zugriffstoken für dessen Git-Host. Kendor nutzt dieses Token dann, wann immer jemand in der Organisation ein Repository von diesem Host prüft oder importiert. Es gibt ein Token pro Host, geteilt von der ganzen Organisation.
Bevor du startest
- Nur Eigentümer können Tokens hinzufügen, ersetzen oder entfernen. Bearbeiter und Betrachter können die Seite öffnen und sehen, welche Hosts verbunden sind, aber nichts ändern.
- Bearbeiter und Eigentümer können private Repositorys importieren, sobald ein Token gespeichert ist. Das Token selbst sehen sie nie.
Ein Token für GitHub, GitLab oder Bitbucket hinzufügen
- Öffne Integrationen in der Seitenleiste.
- Wähle unter Code-Hosts bei der Karte GitHub, GitLab oder Bitbucket die Option Verbinden.
- Erstelle beim Host ein Token (siehe Tabelle unten) und füge es in Lese-Token ein.
- Wähle Speichern.
Kendor prüft GitHub- und GitLab-Tokens beim Speichern mit dem Host und lehnt eines ab, das der Host zurückweist. Bitbucket hat keine Prüfung, die für jeden Token-Typ funktioniert, ein Bitbucket-Token wird daher erst durch deinen nächsten Import getestet.
Nach dem Speichern zeigt die Seite Verbunden, die letzten vier Zeichen des Tokens, das Datum des Hinzufügens und wer es hinzugefügt hat.
Welches Token du erstellen solltest
Kendor liest Repositorys nur, verwende also ein Token, das nicht pushen kann. Der Hinweis unter dem Token-Feld auf der Seite jedes Hosts sagt dasselbe:
| Host | Token | Berechtigung |
|---|---|---|
| GitHub | Fine-grained Personal Access Token, mit Repository access auf die Repositorys gesetzt, die du importierst (nicht „Public repositories“, die Voreinstellung) | Contents: Read-only |
| GitHub (Alternative) | Klassisches Token | Scope repo. Es funktioniert, kann aber auch in jedes Repository schreiben, auf das du Zugriff hast. |
| GitLab | Persönliches, Gruppen- oder Projekt-Access-Token | read_repository |
| Bitbucket | Repository-, Projekt- oder Workspace-Access-Token | Repositories: Read |
Fülle für ein Bitbucket-Atlassian-API-Token außerdem Konto-E-Mail (nur Atlassian-API-Tokens) mit der E-Mail-Adresse des Atlassian-Kontos aus, zu dem das Token gehört. Lass es bei Repository-, Projekt- und Workspace-Access-Tokens leer.
Tipp. Ein GitHub-Token hilft auch bei öffentlichen github.com-Repositorys: Importe laufen dann über das eigene Rate-Limit deines Tokens statt über das gemeinsame.
Einen selbst gehosteten Server hinzufügen
GitHub Enterprise Server, GitLab (selbst verwaltet), Gitea und Forgejo werden auf der Karte Eigene Server hinzugefügt. Kendor importiert nur von einem Server, den deine Organisation hinzugefügt hat, und jeder Server hat sein eigenes Token.
- Wähle unter Code-Hosts bei Eigene Server die Option Verbinden.
- Wähle den Servertyp: GitLab (selbst verwaltet), GitHub Enterprise Server oder Gitea oder Forgejo.
- Gib den Servernamen ein, etwa
git.example.com. Gib nur den Namen ein: keinen Port, keinen Pfad und keine IP-Adresse. - Füge ein Lese-Token mit denselben Berechtigungen wie für die Cloud-Version dieses Hosts ein.
- Wähle Server hinzufügen.
Kendor prüft das Token vor dem Speichern mit dem Server. Antwortet der Server, ist aber nicht vom gewählten Typ, siehst du eine Meldung, dass er nicht wie ein Server dieser Art aussieht.
Hinweis. Der Server muss aus dem Internet per HTTPS auf dem Standardport erreichbar sein. Kendor lehnt Adressen in privaten Netzwerken ab, ein Server, der nur im Firmennetz oder über ein VPN verfügbar ist, kann also nicht verwendet werden. Bitbucket Data Center wird nicht unterstützt.
Wie Tokens gespeichert werden
- Tokens werden vor dem Speichern verschlüsselt und nur verwendet, um das Repository herunterzuladen, das du importierst.
- Kendor zeigt ein Token nach dem Speichern nie wieder an. Die Seite zeigt nur die letzten vier Zeichen, das Datum des Hinzufügens und wer es hinzugefügt hat.
- Ein Token wird immer nur an den Host gesendet, für den es gespeichert wurde.
Ein Token ersetzen oder entfernen
Wähle auf der Seite des Hosts Ersetzen, um ein neues Token einzufügen, oder Entfernen, um es zu löschen. Vor dem Entfernen wirst du um Bestätigung gebeten.
Nachdem ein Token entfernt wurde:
- Bereits importierte Aufgaben behalten ihren Code. An deinen Screenings oder Live-Coding-Interviews ändert sich nichts.
- Neue Importe privater Repositorys von diesem Host funktionieren nicht mehr, bis jemand erneut ein Token hinzufügt. Öffentliche Repositorys auf github.com, gitlab.com und bitbucket.org lassen sich weiterhin importieren.
- Bei einem selbst gehosteten Server entfernt das Entfernen seines Tokens auch den Server. Links dazu werden dann als unbekannter Host behandelt.
Fehler, die auf ein fehlendes oder falsches Token hindeuten
Wenn ein Token eine fehlgeschlagene Prüfung beheben würde, enthält der Fehler einen Link In den Integrationseinstellungen verbinden, der sich in einem neuen Tab öffnet. Die häufigsten Meldungen:
- Repository or ref not found … If it's private, connect a GitHub token. Git-Hosts antworten bei privaten Repositorys mit „nicht gefunden“, wenn kein Token gesendet wird. Prüfe die Schreibweise des Links und des Branches und füge dann ein Token hinzu.
- Repository or ref not found … or the organization's token can't read it. Ein Token ist gespeichert, deckt dieses Repository aber nicht ab. Bei einem fine-grained GitHub-Token füge das Repository zu seiner Repository-Zugriffsliste hinzu.
- … rejected the organization's token. Das Token ist abgelaufen oder wurde widerrufen. Ersetze es.
- … isn't connected. Add it under Settings → Integrations to import from it. Der Link zeigt auf einen Server, den deine Organisation nicht hinzugefügt hat. Füge ihn als selbst gehosteten Server hinzu.
Gehe nach dem Beheben des Tokens zurück und wähle erneut Prüfen.