Comment importer un dépôt Git comme exercice
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é.
Où coller le lien
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.
Liens acceptés par Kendor
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, commepackage.json,go.mod,pyproject.toml,composer.jsonouCargo.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.