Aller au contenu
KendorDocs

Comment importer un dépôt Git comme exercice

Pour les propriétaires et les éditeurs ·

Collez un lien de dépôt GitHub, GitLab, Bitbucket ou auto-hébergé dans une épreuve ou un entretien de codage en direct, choisissez Vérifier, puis ajoutez-le comme exercice.

Pour utiliser un dépôt comme exercice, collez son lien dans le champ de dépôt d’une épreuve de code ou d’un entretien de codage en direct, choisissez Vérifier pour prévisualiser ce que Kendor va importer, puis choisissez Ajouter le défi. Kendor copie les fichiers, configure l’exécution du projet et ouvre le nouvel exercice dans l’éditeur pour que vous puissiez le relire.

Avant de commencer

  • Vous avez besoin du rôle Propriétaire ou Éditeur. Les lecteurs ne peuvent pas ajouter d’exercices.
  • Les dépôts publics sur github.com, gitlab.com et bitbucket.org fonctionnent immédiatement. Les dépôts privés et vos propres serveurs Git nécessitent d’abord un jeton : voir Importer un dépôt privé.

Le champ de dépôt apparaît à deux endroits :

  • Épreuves de code. Ouvrez Épreuves, ouvrez ou créez une épreuve, et allez à la section Exercices. Tant que l’épreuve n’a pas d’exercice, le champ occupe toute la section. Dès qu’elle en a un, le champ se place sous la liste sous la forme Collez l'URL d'un dépôt pour ajouter un exercice, pour que vous puissiez en ajouter d’autres.
  • Entretiens de codage en direct. Ouvrez Codage en direct et choisissez Nouvel entretien de codage en direct. Le champ se trouve dans la section Code. Un entretien de codage en direct contient un seul exercice : le champ n’apparaît donc que tant qu’il est vide.

Vous pouvez coller le lien tel que votre hébergeur Git l’affiche. Tous ceux-ci fonctionnent :

Forme Exemple
Page du dépôt https://github.com/acme/rate-limiter
Sans https:// gitlab.com/acme/rate-limiter
URL de clonage HTTPS https://bitbucket.org/acme/rate-limiter.git
URL de clonage SSH git@github.com:acme/rate-limiter.git
Page d’une branche ou d’un dossier https://github.com/acme/platform/tree/main/services/api
Raccourci GitHub acme/rate-limiter ou acme/rate-limiter@v2

Le raccourci ne fonctionne que pour github.com. La partie après @ est une branche, une étiquette (tag) ou un commit ; sans elle, Kendor utilise la branche par défaut. Pour importer une seule branche ou un seul dossier, collez le lien de sa page, comme décrit dans Importer un dossier ou une branche.

Un lien vers un seul fichier, comme les pages /blob/ de GitHub, n’est pas accepté. Utilisez plutôt le lien du dépôt, de la branche ou du dossier.

Hébergeurs Git pris en charge

Hébergeur Nécessite un jeton
github.com Uniquement pour les dépôts privés
gitlab.com Uniquement pour les dépôts privés
bitbucket.org (Bitbucket Cloud) Uniquement pour les dépôts privés
GitHub Enterprise Server Toujours : le serveur doit d’abord être ajouté
GitLab autogéré Toujours : le serveur doit d’abord être ajouté
Gitea ou Forgejo Toujours : le serveur doit d’abord être ajouté

Les sous-groupes GitLab fonctionnent, par exemple https://gitlab.com/acme/backend/payments. Bitbucket Data Center (le Bitbucket auto-hébergé) n’est pas pris en charge.

Si vous collez un lien vers un serveur que votre organisation n’a pas ajouté, la vérification s’arrête avec un message indiquant que l’hébergeur n’est pas connecté, et un lien Connectez-le dans les paramètres Intégrations.

Ce que montre la vérification

Vérifier est un essai à blanc qui ne modifie rien. Le résultat affiche :

  • l’hébergeur, le propriétaire, le dépôt, le dossier et la branche ou le commit auquel il a abouti
  • le nombre de fichiers et leur taille totale
  • si le projet dispose d’une configuration de démarrage (voir plus bas)
  • le langage que Kendor a détecté, comme Node.js 22 détecté

En dessous, vous pouvez ajuster l’exercice avant de l’ajouter :

  • Titre, suggéré d’après le nom du dépôt ou du dossier
  • Langage, le langage principal et sa version, ainsi que les éventuels langages supplémentaires utilisés par le projet
  • Bases de données, quand le projet a besoin de PostgreSQL ou de Valkey
  • Comment il s’exécute, un résumé des services que Kendor va démarrer

Si vous modifiez le lien, choisissez Revérifier avant d’ajouter.

Comment Kendor configure le projet

Chaque exercice s’exécute à partir d’un fichier kendor.yaml qui indique comment installer et démarrer le projet. Pendant la vérification, Kendor en cherche un à la racine de ce que vous importez :

  • kendor.yaml trouvé : le fichier du dépôt est utilisé tel quel. La version du langage vient du fichier : elle ne peut donc pas être modifiée dans le sélecteur de langage.
  • configuration de démarrage détectée — vérifiez-la dans l'éditeur : il n’y a pas de kendor.yaml, donc Kendor en écrit un à partir de ce qu’il trouve, comme package.json, go.mod, pyproject.toml, composer.json ou Cargo.toml. Les dépôts avec un projet par dossier obtiennent un service par dossier. Le nouvel exercice s’ouvre avec la configuration détectée, prête à être relue.
  • pas de kendor.yaml — configurez le runtime dans l’éditeur : Kendor n’a pas pu déterminer comment le projet démarre. Les candidats disposent d’un terminal tant que vous ne l’avez pas configuré.

Voir la référence de kendor.yaml pour le format du fichier.

Ce qui est importé

Kendor copie les fichiers, pas l’historique Git. Il laisse de côté les dossiers de dépendances et de build, notamment node_modules, vendor, .git, dist, build, target, .venv et __pycache__ : les candidats installent donc les dépendances à neuf.

L’import a ces limites, comptées après exclusion de ces dossiers :

Limite Valeur
Fichiers 5 000
Taille totale 50 Mo
Plus gros fichier 5 Mo
Téléchargement depuis l’hébergeur 80 Mo

Un dépôt qui dépasse la limite de fichiers échoue, avec la suggestion d’importer plutôt un sous-dossier.

Astuce. Si vous voyez un message de limite de débit, attendez quelques minutes, ou demandez à un propriétaire d’ajouter un jeton pour cet hébergeur, ce qui relève la limite.

Après l’ajout de l’exercice

Ajouter le défi crée l’exercice et l’ouvre dans l’éditeur, où vous pouvez vérifier qu’il s’exécute et rédiger l’énoncé. L’exercice conserve une copie figée des fichiers : les pushs ultérieurs vers le dépôt ne le modifient pas. Voir Instantanés et mises à jour.

Cet article vous a-t-il aidé ?