Comment construire un exercice à la maison à partir du dépôt de votre entreprise
Découpez une petite tranche exécutable de votre vraie base de code, retirez secrets et historique, faites-la démarrer avec un seul fichier de configuration et dimensionnez la tâche selon la limite de temps.
Pour construire un exercice à la maison à partir du dépôt de votre entreprise, copiez une petite tranche de la vraie base de code dans un dépôt séparé, retirez les secrets, l'historique et tout ce qui est confidentiel, et assurez-vous qu'elle s'installe et démarre avec une seule commande. Rédigez ensuite une tâche qui tient dans environ la moitié de la limite de temps, avec des tests qui montrent au candidat ce que signifie « terminé ».
Pourquoi utiliser votre propre code ?
Une tâche dans votre propre base de code vous montre comment un candidat traite le code sur lequel il travaillerait réellement : vos conventions, vos frameworks, votre genre de désordre. Elle montre aussi au candidat à quoi ressemble le poste, ce qui aide les bons profils à dire oui et laisse les mauvaises adéquations se retirer tôt.
Le coût, c'est la préparation. Une tranche d'un vrai système doit s'exécuter seule, sans votre VPN, votre base de données de préproduction ni votre registre de paquets interne. Prévoyez quelques heures pour la première. Chaque tâche construite ensuite sur la même tranche coûte beaucoup moins cher.
Choisir la bonne tranche
Ne donnez pas tout le dépôt. Choisissez le plus petit morceau qui reste réaliste.
- Un service, pas la plateforme. Une API seule avec ses propres tests est idéale. Si elle appelle trois services internes, remplacez-les par quelques lignes qui renvoient des données fixes.
- Du code que les gens modifient vraiment. Le module de facturation qui reçoit une modification à chaque sprint est un meilleur choix qu'une couche de framework que personne ne touche.
- Assez de contexte pour explorer. Quelques milliers de lignes, c'est très bien. Les candidats doivent pouvoir s'y retrouver en dix minutes.
- Une vraie jonction pour la tâche. Cherchez un endroit où une correction de bug ou une petite fonctionnalité s'insère naturellement, comme une validation manquante, un endpoint sans pagination ou une requête lente.
Utiliser un seul dossier d'un monorepo
Si votre code vit dans un monorepo, vous n'avez souvent rien à extraire : pointez l'exercice vers le seul dossier qui contient le service. Vérifiez qu'il n'importe pas de paquets partagés depuis ailleurs dans le dépôt, ou intégrez dans ce dossier les quelques-uns dont il a besoin.
Retirer secrets, historique et tout ce qui est confidentiel
Traitez la tranche comme une publication open source. Les candidats liront chaque fichier.
- Démarrez un dépôt neuf. Copiez les fichiers, ne faites pas de fork. L'historique Git peut contenir d'anciennes clés, des noms internes et des commentaires que vous préféreriez ne pas partager.
- Retirez les secrets. Supprimez les fichiers
.envet remplacez-les par un.env.exampleavec des valeurs factices. Cherchez les clés d'API, les jetons, les noms d'hôtes internes et les chaînes de connexion. - Retirez les données clients. Les fixtures et les fichiers de seed contiennent souvent des copies d'enregistrements réels. Remplacez-les par des données inventées.
- Vérifiez les commentaires et la documentation. Les TODO qui nomment des clients, les liens vers des wikis internes et les références à des incidents doivent tous disparaître.
- Faites attention aux licences. Du code tiers sous licence restrictive peut ne pas être partageable, même en entretien.
Astuce. Demandez à quelqu'un qui n'a pas construit la tranche de la cloner sur une machine propre. Tout ce sur quoi il doit poser une question est un endroit où un candidat va rester bloqué.
Faites-la fonctionner sans vous
Le candidat ne doit pas passer la première demi-heure à installer des choses. Visez une commande d'installation, une commande de démarrage et une commande de test, et documentez-les dans le README.
- Figez les versions du langage et des dépendances avec un fichier de verrouillage.
- Remplacez les appels aux services internes par de petits faux locaux.
- Si le service a besoin d'une base de données, utilisez une vraie, avec un petit seed. Voir Comment construire un exercice à la maison avec une vraie base de données.
- Lancez les tests une fois. Si certains sont instables, corrigez-les ou supprimez-les avant qu'un candidat les voie.
Gardez la tâche sous la limite de temps
L'erreur la plus fréquente dans un exercice à la maison est une tâche qui prend deux fois plus de temps qu'annoncé. Les candidats qui ont un emploi et une famille en paient le prix, et vous les perdez.
- Chronométrez-vous sur une copie propre, puis assurez-vous que la tâche tient dans la moitié de la limite.
- Un objectif clair. « Ajoutez la pagination à
GET /orders, avec des tests » suffit pour 90 minutes dans une base de code inconnue. - Dites-leur ce qu'il ne faut pas faire. « Inutile de toucher à l'interface » évite aux candidats de deviner le périmètre.
- Laissez de la place pour un court compte rendu de ce qu'ils feraient ensuite. Il montre le jugement et coûte cinq minutes.
Le faire dans Kendor
Kendor importe un dépôt directement dans un défi et l'exécute dans un bac à sable. Les candidats ne clonent ni n'installent rien en local. Voir Importer depuis n'importe quel hébergeur Git.
Importer le dépôt
Dans une épreuve, collez l'URL dans URL du dépôt et choisissez Vérifier. Kendor affiche un aperçu de l'import : le nombre de fichiers, la taille, le langage détecté et si le dépôt contient déjà un kendor.yaml. Renseignez ensuite le Titre, la Langue et les éventuelles Bases de données, puis choisissez Ajouter le défi.
- Hébergeurs : github.com, gitlab.com et bitbucket.org, ainsi que votre propre GitHub Enterprise Server, GitLab, Gitea ou Forgejo.
- Limites : jusqu'à 50 Mo et 5 000 fichiers, sans aucun fichier de plus de 5 Mo.
- Les dossiers de dépendances tels que
node_modules,vendoret.venvsont laissés de côté. Le bac à sable installe lui-même les dépendances.
Dépôts privés
Un propriétaire de l'organisation ajoute un jeton en lecture seule pour l'hébergeur sous Intégrations → Hébergeurs de code. Les jetons sont stockés chiffrés, et Kendor n'en affiche jamais que les quatre derniers caractères. Utilisez un jeton limité aux seuls dépôts que vous allez importer. Voir Dépôts privés.
Un seul dossier d'un monorepo
Collez un lien vers une branche ou un dossier, par exemple github.com/acme/platform/tree/main/services/billing, et seule cette partie est importée. Voir Dossiers de monorepo.
Un instantané figé
L'import est une copie des fichiers à ce commit, sans l'historique Git. Les push ultérieurs sur le dépôt ne modifient pas une épreuve déjà envoyée : chaque candidat reçoit donc le même code. Voir Instantanés et mises à jour.
Le faire tourner avec kendor.yaml
Un kendor.yaml à la racine du projet indique à Kendor comment l'installer, le démarrer et le tester. Si le dépôt en contient un, Kendor l'utilise. Sinon, Kendor détecte une configuration à partir des fichiers du projet et ajoute un kendor.yaml que vous relisez dans la Configuration d'exécution de l'éditeur.
version: 1
runtime:
type: node
version: "22"
databases:
- type: postgres
version: "18"
init: db/seed.sql
install:
commands:
- npm ci
services:
api:
dev:
command: npm run dev
port: 3000
test:
command: node --test
preview:
service: apiPour un projet avec plusieurs services, chacun a sa propre entrée sous services, avec un workDir pour son dossier. Voir la référence de kendor.yaml et Applications multi-services.
Fixer la limite de temps et la vérifier
Dans les paramètres de l'épreuve, choisissez une Limite de temps. 90 minutes est la valeur par défaut ; les préréglages vont de 30 minutes à 4 heures, ou vous pouvez saisir une durée personnalisée. Choisissez ensuite Aperçu côté candidat, lancez les tests depuis l'onglet Tests, et faites la tâche vous-même contre la montre.
Remarque. Ce qui apparaît dans le terminal du candidat est enregistré pour les évaluateurs. C'est une raison de plus de s'assurer que la tranche ne contient aucun vrai identifiant : tout ce qui y est affiché se retrouve dans l'enregistrement.