Configuration du dépôt GitHub modèle

Les étapes d’exercice de code créent un dépôt GitHub privé pour chaque candidat à partir d’un dépôt modèle. Ce guide explique comment configurer correctement votre dépôt modèle.

Qu’est-ce qu’un dépôt modèle ?

Les dépôts modèles permettent de générer de nouveaux dépôts avec la même arborescence et les mêmes fichiers. Lorsqu’un candidat atteint une étape d’exercice de code, Kit utilise l’API GitHub pour créer une nouvelle copie privée de votre dépôt modèle.

Important : le dépôt source doit être explicitement marqué comme modèle sur GitHub. Un dépôt classique ne peut pas servir de modèle : l’API GitHub rejettera la requête.

Comment marquer un dépôt comme modèle

1. Accédez à votre dépôt sur GitHub
2. Cliquez sur Settings (icône d’engrenage dans la barre de navigation du dépôt)
3. Dans General, repérez la section Template repository en haut de la page
4. Cochez la case Template repository
5. Cliquez sur Save changes (le paramètre prend effet immédiatement)

Une fois activé, GitHub affiche un badge « Template » sur la page du dépôt.

Checklist des prérequis

Prérequis	Détails
GitHub App installée	Votre organisation doit avoir l’application GitHub Kit installée et active (Intégrations > GitHub)
Dépôt existant	Le org/repo spécifié dans la configuration de l’étape doit exister sur GitHub
Marqué comme modèle	Le dépôt doit avoir « Template repository » coché dans Settings > General
Accès accordé à l’application	L’installation de l’application GitHub Kit doit avoir accès au dépôt modèle
Organisation correspondante	L’installation de l’application GitHub doit couvrir l’organisation dans laquelle les dépôts des candidats seront créés
Évaluateurs connectés	Chaque évaluateur assigné à l’étape doit connecter son propre compte GitHub dans Kit, sans quoi il n’a aucun accès aux dépôts des candidats (voir Accès des évaluateurs aux dépôts des candidats)

Configurer le modèle dans Kit

1. Accédez à votre offre d’emploi > Étapes
2. Sélectionnez ou créez une étape Exercice de code
3. Dans le champ GitHub Template, sélectionnez un dépôt dans la liste déroulante ou saisissez le nom org/repo
4. La liste déroulante n’affiche que les dépôts déjà marqués comme modèles. Si votre dépôt n’apparaît pas, vérifiez qu’il est bien marqué comme modèle sur GitHub
5. Enregistrez la configuration de l’étape

Kit valide automatiquement que le dépôt est un modèle valide après l’enregistrement. En cas de problème, un avertissement s’affiche sur la carte de l’étape.

Accès des évaluateurs aux dépôts des candidats

Les dépôts des candidats sont privés. Quand un candidat soumet son travail, Kit invite les évaluateurs assignés à l’étape dans son dépôt, en lecture, via le compte GitHub personnel de chaque évaluateur. Kit ne connaît ce compte que si l’évaluateur a connecté son propre compte GitHub dans Kit.

Connexion	Qui la fait	Ce qu’elle apporte
Connexion de l’organisation : Intégrations > GitHub	Un administrateur, une fois par compte	Permet à Kit de créer les dépôts des candidats à partir de votre modèle
Appartenance à l’organisation GitHub : sur GitHub même	Un propriétaire de l’organisation GitHub	Rien dans Kit. Inviter un évaluateur dans votre organisation GitHub ne lui donne pas accès aux dépôts des candidats
Connexion GitHub personnelle : Paramètres > Comptes connectés	Chaque évaluateur, une fois par personne	Permet à Kit d’inviter cet évaluateur dans les dépôts des candidats

Votre organisation peut être entièrement connectée sans qu’aucun de vos évaluateurs ne puisse ouvrir le moindre dépôt de candidat.

Évaluateurs : connectez GitHub une seule fois

1. Ouvrez Paramètres > Comptes connectés
2. Sous Connecter un fournisseur, cliquez sur GitHub
3. Autorisez Kit sur GitHub

Une seule opération, une fois par personne. À partir de là, Kit vous invite dans les dépôts des candidats au fil des soumissions, et rattrape celles que vous avez manquées : dès que vous vous connectez, Kit vous donne accès à tous les dépôts d’exercice de code auxquels vous auriez déjà dû avoir accès. Personne n’a à refaire une étape ni à renvoyer une invitation.

La première fois que vous êtes ajouté comme évaluateur sur une étape d’exercice de code, Kit vous envoie un e-mail de bienvenue. Si votre compte GitHub n’est pas encore connecté, cet e-mail s’ouvre sur un bouton Connecter GitHub.

Administrateurs : repérer les évaluateurs manquants

Kit signale le manque avant même qu’un candidat ne soumette :

• La section Évaluateurs de l’étape affiche un avertissement ambré nommant précisément les évaluateurs sans compte GitHub connecté.
• L’étape porte une icône d’avertissement dans la liste des étapes, et l’offre la compte dans son récapitulatif à configurer.
• Si un candidat soumet alors qu’un évaluateur n’est toujours pas connecté, Kit prévient par e-mail et dans l’application cet évaluateur ainsi que les responsables de l’étape.

Personne ne peut le faire à la place de l’évaluateur, ni vous, ni un propriétaire de l’organisation GitHub. Demandez à chaque évaluateur nommé de suivre les trois étapes ci-dessus, ou réassignez l’évaluation à quelqu’un de déjà connecté.

Bonnes pratiques pour les dépôts modèles

• Incluez un README clair avec les instructions de l’exercice, les attentes et les consignes de soumission
• Ajoutez un .gitignore adapté au langage et au framework utilisés
• Incluez du code de démarrage ou un squelette sur lequel les candidats pourront s’appuyer
• Restez minimaliste : n’incluez que le nécessaire pour démarrer
• Ajoutez une configuration CI (GitHub Actions) si vous souhaitez des tests automatisés sur les soumissions des candidats
• N’incluez pas de secrets, de clés API ou de code propriétaire

Dépannage

Problème	Cause	Solution
Le candidat reste bloqué sur l’indicateur de chargement « Setting Up »	Le dépôt modèle n’est pas marqué comme modèle	Accédez à Settings > General du dépôt et cochez « Template repository »
Erreur « Setup encountered an issue »	Dépôt modèle introuvable ou non marqué comme modèle	Vérifiez que le dépôt existe et est marqué comme modèle, puis relancez la configuration
Dépôt modèle absent de la liste déroulante	Le dépôt n’est pas marqué comme modèle	Marquez-le comme modèle dans les paramètres GitHub, puis rechargez la page
Avertissement « GitHub App not installed »	Aucune connexion GitHub active	Installez l’application GitHub Kit depuis les paramètres des intégrations
Avertissement « GitHub template repository not set »	Le champ github_template est vide	Sélectionnez un modèle dans la configuration de l’étape
Le candidat ne peut pas accéder à son dépôt	L’invitation GitHub n’a pas été envoyée ou acceptée	Vérifiez le nom d’utilisateur GitHub du candidat et le statut de l’invitation au dépôt
L’évaluateur ne peut pas ouvrir le dépôt d’un candidat	Cet évaluateur n’a aucun compte GitHub personnel connecté dans Kit	Demandez-lui de connecter GitHub dans Paramètres > Comptes connectés ; l’accès aux dépôts manqués est accordé automatiquement une fois la connexion faite
L’évaluateur fait partie de notre organisation GitHub mais n’a toujours pas accès	L’appartenance à l’organisation n’équivaut pas à connecter GitHub dans Kit	Même solution : l’évaluateur connecte lui-même GitHub dans Kit
Installée sur GitHub mais non connectée dans Kit	L’application est bien arrivée sur votre organisation, mais GitHub n’a jamais confirmé que vous en êtes propriétaire, l’installation reste donc en attente	Ouvrez Intégrations > GitHub, choisissez Terminer la connexion, puis Confirmer sur GitHub
En attente d’un propriétaire de l’organisation	Vous n’êtes pas propriétaire de l’organisation, GitHub a donc soumis l’installation à un propriétaire pour approbation	Demandez à un propriétaire d’approuver l’application GitHub Kit sur GitHub, puis relancez Installer l’application GitHub

Voir aussi

• Configuration des modèles de processus : configuration YAML pour les étapes d’exercice de code
• Évaluations et retours : comment les évaluateurs sont assignés et prévenus, et comment leurs votes décident d’une étape
• Documentation GitHub sur les dépôts modèles