So importierst du einen Ordner oder Branch eines Repositorys
Füge den Link zu einer Ordner- oder Branch-Seite deines Git-Hosts ein. Kendor importiert nur diesen Teil und macht den Ordner zum Stamm des Projekts des Kandidaten.
Um einen Teil eines Repositorys zu importieren, öffne den Ordner oder Branch bei deinem Git-Host, kopiere den Link aus der Adressleiste des Browsers und füge ihn statt des schlichten Repository-Links in das Repository-Feld ein. Kendor liest Branch und Ordner aus dem Link, importiert nur diesen Ordner und macht ihn zum Stamm des Projekts des Kandidaten.
Das passt zu Monorepos, zu Repositorys, die mehrere Übungen nebeneinander enthalten, und zu Aufgaben, die auf einem eigenen Branch liegen.
Linkformen je Host
Der Branch kann auch ein Tag oder ein vollständiger Commit-Hash sein. Der Ordnerteil ist optional: Lass ihn weg, um das gesamte Repository auf diesem Branch zu importieren.
| Host | Branch- oder Ordner-Link |
|---|---|
| GitHub und GitHub Enterprise Server | https://github.com/<owner>/<repo>/tree/<branch>/<folder> |
| GitLab und GitLab (selbst verwaltet) | https://gitlab.com/<group>/<repo>/-/tree/<branch>/<folder> |
| Bitbucket | https://bitbucket.org/<workspace>/<repo>/src/<branch>/<folder> |
| Gitea und Forgejo | https://git.example.com/<owner>/<repo>/src/branch/<branch>/<folder> |
Bei Gitea und Forgejo verwendest du src/tag/<tag> für ein Tag und src/commit/<hash> für einen Commit. GitLab-Links können Untergruppen enthalten, etwa gitlab.com/acme/backend/platform/-/tree/main/services/api.
Links zu einer einzelnen Datei, etwa GitHub-/blob/-Seiten, werden nicht akzeptiert.
Beispiele
Ein Node.js-Dienst in einem Monorepo auf GitHub:
https://github.com/acme/platform/tree/main/services/api
Kendor importiert services/api aus dem Branch main. Eine Datei, die im Repository unter services/api/package.json lag, liegt in der Aufgabe unter package.json.
Ein getaggtes Release eines GitLab-Projekts, ganzes Repository:
https://gitlab.com/acme/rate-limiter/-/tree/v2.1.0
Ein Übungsordner auf Bitbucket:
https://bitbucket.org/acme/exercises/src/main/booking-api
Ein fixierter Commit auf einem Gitea-Server:
https://git.example.com/acme/platform/src/commit/4f9c2e1d8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d/services/api
Was das Neu-Verwurzeln ändert
Der Ordner, auf den du verlinkst, wird zur Spitze des Projekts des Kandidaten. Das wirkt sich auf einiges aus:
- Start-Setup. Kendor sucht
kendor.yamlim Stamm des Ordners, nicht im Stamm des Repositorys. Hat der Ordner keine, erkennt Kendor das Setup aus den eigenen Dateien des Ordners, etwa seinerpackage.jsonodergo.mod. - Dateien außerhalb des Ordners sind nicht enthalten. Hängt der Ordner von etwas an anderer Stelle im Repository ab, etwa einem gemeinsamen Paket oder einem Lockfile im Repository-Stamm, hat der Kandidat es nicht. Importiere stattdessen den übergeordneten Ordner oder kopiere das Benötigte in den Ordner.
- Die Limits gelten für den Ordner. Die Limits von 5.000 Dateien und 50 MB zählen nur die Dateien des Ordners, nachdem Abhängigkeitsordner ausgelassen wurden. Ist ein ganzes Repository zu groß, hilft meist der Import des benötigten Ordners.
- Der vorgeschlagene Titel stammt vom Ordnernamen,
services/booking-apischlägt also Booking Api vor. Du kannst ihn vor dem Hinzufügen ändern.
Das Ergebnis von Prüfen zeigt den Ordner und den Branch oder Commit hinter dem Repository-Namen, sodass du bestätigen kannst, was du importieren wirst, bevor du Aufgabe hinzufügen wählst.
Branch-Namen mit einem Schrägstrich
In einem Link behandelt Kendor das erste Segment nach tree/ (oder src/) als Branch und alles danach als Ordner. Ein Branch namens feature/new-api würde als Branch feature und Ordner new-api gelesen.
Für einen solchen Branch:
- Verwende auf github.com die Kurzform
owner/repo@feature/new-api. Das importiert das gesamte Repository auf diesem Branch, ohne einen Ordner zu wählen. - Verwende auf jedem Host stattdessen einen Link mit dem Commit-Hash statt des Branch-Namens. Kopiere den Hash des neuesten Commits auf dem Branch und setze ihn dorthin, wo der Branch steht.
Häufige Fehler
- No files found under "services/api" bedeutet, dass der Ordner auf diesem Branch nicht existiert oder nur Abhängigkeits- oder Build-Ordner enthält, die Kendor auslässt. Prüfe die Schreibweise, auch Groß- und Kleinschreibung.
- Repository or ref not found bedeutet, dass der Branch, das Tag oder der Commit nicht existiert oder das Repository privat ist. Siehe Ein privates Repository importieren.
- Use a repository or /tree/<branch>/<folder> URL (oder das GitLab-, Bitbucket- bzw. Gitea-Äquivalent) bedeutet, dass der Link auf etwas anderes als ein Repository, einen Branch oder einen Ordner zeigt, etwa eine Datei, einen Pull Request oder ein Issue.