Zum Inhalt springen
KendorDocs

So importierst du ein Git-Repository als Aufgabe

Für Eigentümer und Bearbeiter ·

Füge den Link eines GitHub-, GitLab-, Bitbucket- oder selbst gehosteten Repositorys in ein Screening oder Live-Coding-Interview ein, wähle Prüfen und füge es dann als Aufgabe hinzu.

Um ein Repository als Aufgabe zu nutzen, füge seinen Link in das Repository-Feld eines Coding-Screenings oder eines Live-Coding-Interviews ein, wähle Prüfen, um eine Vorschau des Imports zu sehen, und wähle dann Aufgabe hinzufügen. Kendor kopiert die Dateien, richtet ein, wie das Projekt läuft, und öffnet die neue Aufgabe im Editor, damit du sie durchsehen kannst.

Bevor du startest

  • Du brauchst die Rolle Eigentümer oder Bearbeiter. Betrachter können keine Aufgaben hinzufügen.
  • Öffentliche Repositorys auf github.com, gitlab.com und bitbucket.org funktionieren sofort. Private Repositorys und deine eigenen Git-Server brauchen zuerst ein Token: siehe Ein privates Repository importieren.

Das Repository-Feld erscheint an zwei Stellen:

  • Coding-Screenings. Öffne Screenings, öffne oder erstelle ein Screening und gehe zum Abschnitt Aufgaben. Hat das Screening noch keine Aufgaben, füllt das Feld den Abschnitt aus. Sobald es eine hat, steht das Feld unter der Liste als Repository-URL einfügen, um eine Aufgabe hinzuzufügen, sodass du weitere hinzufügen kannst.
  • Live-Coding-Interviews. Öffne Live-Coding und wähle Neues Live-Coding-Interview. Das Feld befindet sich im Abschnitt Code. Ein Live-Coding-Interview enthält eine Aufgabe, das Feld wird also nur angezeigt, solange es leer ist.

Du kannst den Link so einfügen, wie dein Git-Host ihn anzeigt. Alle diese Formen funktionieren:

Form Beispiel
Repository-Seite https://github.com/acme/rate-limiter
Ohne https:// gitlab.com/acme/rate-limiter
HTTPS-Clone-URL https://bitbucket.org/acme/rate-limiter.git
SSH-Clone-URL git@github.com:acme/rate-limiter.git
Branch- oder Ordner-Seite https://github.com/acme/platform/tree/main/services/api
GitHub-Kurzform acme/rate-limiter oder acme/rate-limiter@v2

Die Kurzform funktioniert nur für github.com. Der Teil nach @ ist ein Branch, Tag oder Commit; ohne ihn verwendet Kendor den Standard-Branch. Um einen einzelnen Branch oder Ordner zu importieren, füge den Link seiner Seite ein, wie unter Einen Ordner oder Branch importieren beschrieben.

Ein Link zu einer einzelnen Datei, etwa die /blob/-Seiten von GitHub, wird nicht akzeptiert. Verwende stattdessen den Link zum Repository, Branch oder Ordner.

Unterstützte Git-Hosts

Host Braucht ein Token
github.com Nur für private Repositorys
gitlab.com Nur für private Repositorys
bitbucket.org (Bitbucket Cloud) Nur für private Repositorys
GitHub Enterprise Server Immer: Der Server muss zuerst hinzugefügt werden
GitLab (selbst verwaltet) Immer: Der Server muss zuerst hinzugefügt werden
Gitea oder Forgejo Immer: Der Server muss zuerst hinzugefügt werden

GitLab-Untergruppen funktionieren, zum Beispiel https://gitlab.com/acme/backend/payments. Bitbucket Data Center (das selbst gehostete Bitbucket) wird nicht unterstützt.

Wenn du einen Link zu einem Server einfügst, den deine Organisation nicht hinzugefügt hat, bricht die Prüfung mit der Meldung ab, dass der Host nicht verbunden ist, und mit einem Link In den Integrationseinstellungen verbinden.

Was die Prüfung zeigt

Prüfen ist ein Probelauf, der nichts verändert. Das Ergebnis zeigt:

  • Host, Eigentümer, Repository, Ordner und den Branch oder Commit, zu dem aufgelöst wurde
  • die Anzahl der Dateien und ihre Gesamtgröße
  • ob das Projekt ein Start-Setup hat (siehe unten)
  • die von Kendor erkannte Sprache, etwa Node.js 22 erkannt

Darunter kannst du die Aufgabe anpassen, bevor du sie hinzufügst:

  • Titel, vorgeschlagen aus dem Namen des Repositorys oder Ordners
  • Sprache, die Hauptsprache und Version, plus alle weiteren Sprachen, die das Projekt nutzt
  • Datenbanken, wenn das Projekt PostgreSQL oder Valkey braucht
  • So läuft es, eine Zusammenfassung der Dienste, die Kendor starten wird

Wenn du den Link änderst, wähle vor dem Hinzufügen Erneut prüfen.

Wie Kendor das Projekt einrichtet

Jede Aufgabe läuft aus einer kendor.yaml-Datei, die beschreibt, wie das Projekt installiert und gestartet wird. Bei der Prüfung sucht Kendor im Stamm dessen, was du importierst, nach einer:

  • kendor.yaml gefunden: Die eigene Datei des Repositorys wird unverändert verwendet. Die Sprachversion stammt aus der Datei und lässt sich daher nicht in der Sprachauswahl ändern.
  • Start-Setup erkannt – im Editor prüfen: Es gibt keine kendor.yaml, daher schreibt Kendor eine aus dem, was es findet, etwa package.json, go.mod, pyproject.toml, composer.json oder Cargo.toml. Repositorys mit einem Projekt pro Ordner erhalten einen Dienst pro Ordner. Die neue Aufgabe öffnet sich mit dem erkannten Setup, bereit zur Durchsicht.
  • keine kendor.yaml — Runtime im Editor konfigurieren: Kendor konnte nicht erkennen, wie das Projekt startet. Kandidaten bekommen ein Terminal, bis du es einrichtest.

Das Dateiformat findest du in der kendor.yaml-Referenz.

Was importiert wird

Kendor kopiert die Dateien, nicht die Git-Historie. Es lässt Abhängigkeits- und Build-Ordner aus, darunter node_modules, vendor, .git, dist, build, target, .venv und __pycache__, sodass Kandidaten Abhängigkeiten frisch installieren.

Der Import hat diese Limits, gezählt nachdem diese Ordner ausgelassen wurden:

Limit Wert
Dateien 5.000
Gesamtgröße 50 MB
Größte einzelne Datei 5 MB
Download vom Host 80 MB

Ein Repository über dem Dateilimit scheitert mit dem Vorschlag, stattdessen einen Unterordner zu importieren.

Tipp. Siehst du eine Meldung zum Rate-Limit, warte ein paar Minuten oder lass einen Eigentümer ein Token für diesen Host hinzufügen, was das Limit anhebt.

Nachdem du die Aufgabe hinzugefügt hast

Aufgabe hinzufügen erstellt die Aufgabe und öffnet sie im Editor, wo du prüfen kannst, ob sie läuft, und die Aufgabenstellung schreiben kannst. Die Aufgabe behält eine feste Kopie der Dateien: Spätere Pushes ins Repository ändern sie nicht. Siehe Snapshots und Aktualisierungen.

War dieser Artikel hilfreich?