Come importare un repository Git come sfida
Incolla il link di un repository GitHub, GitLab, Bitbucket o self-hosted in una prova o in un colloquio di coding dal vivo, scegli Verifica, poi aggiungilo come sfida.
Per usare un repository come sfida, incolla il suo link nel campo del repository di una prova di coding o di un colloquio di coding dal vivo, scegli Verifica per vedere in anteprima che cosa importerà Kendor, poi scegli Aggiungi sfida. Kendor copia i file, imposta come il progetto viene eseguito e apre la nuova sfida nell'editor così puoi controllarla.
Prima di iniziare
- Ti serve il ruolo di Proprietario o Editor. I visualizzatori non possono aggiungere sfide.
- I repository pubblici su github.com, gitlab.com e bitbucket.org funzionano subito. I repository privati e i tuoi server Git richiedono prima un token: vedi Importare un repository privato.
Dove incollare il link
Il campo del repository compare in due posti:
- Prove di coding. Apri Prove, apri o crea una prova e vai alla sezione Sfide. Quando la prova non ha ancora sfide, il campo riempie la sezione. Quando ne ha già una, il campo si trova sotto l'elenco come Incolla l'URL di un repository per aggiungere una sfida, così puoi aggiungerne altre.
- Colloqui di coding dal vivo. Apri Coding dal vivo e scegli Nuovo colloquio di coding dal vivo. Il campo si trova nella sezione Codice. Un colloquio di coding dal vivo contiene una sola sfida, quindi il campo compare solo finché è vuoto.
Link accettati da Kendor
Puoi incollare il link come lo mostra il tuo host Git. Funzionano tutti questi:
| Forma | Esempio |
|---|---|
| Pagina del repository | https://github.com/acme/rate-limiter |
Senza https:// |
gitlab.com/acme/rate-limiter |
| URL di clone HTTPS | https://bitbucket.org/acme/rate-limiter.git |
| URL di clone SSH | git@github.com:acme/rate-limiter.git |
| Pagina di un branch o di una cartella | https://github.com/acme/platform/tree/main/services/api |
| Forma abbreviata di GitHub | acme/rate-limiter o acme/rate-limiter@v2 |
La forma abbreviata funziona solo per github.com. La parte dopo @ è un branch, un tag o un commit; senza di essa, Kendor usa il branch predefinito. Per importare un singolo branch o una singola cartella, incolla il link della sua pagina, come descritto in Importare una cartella o un branch.
Un link a un singolo file, come le pagine /blob/ di GitHub, non viene accettato. Usa invece il link del repository, del branch o della cartella.
Host Git supportati
| Host | Richiede un token |
|---|---|
| github.com | Solo per i repository privati |
| gitlab.com | Solo per i repository privati |
| bitbucket.org (Bitbucket Cloud) | Solo per i repository privati |
| GitHub Enterprise Server | Sempre: il server deve essere aggiunto prima |
| GitLab (self-managed) | Sempre: il server deve essere aggiunto prima |
| Gitea o Forgejo | Sempre: il server deve essere aggiunto prima |
I sottogruppi di GitLab funzionano, ad esempio https://gitlab.com/acme/backend/payments. Bitbucket Data Center (il Bitbucket self-hosted) non è supportato.
Se incolli il link di un server che la tua organizzazione non ha aggiunto, la verifica si ferma con un messaggio che dice che l'host non è collegato, e con un link Collegalo nelle impostazioni Integrazioni.
Che cosa mostra la verifica
Verifica è una prova a secco che non cambia nulla. Il risultato mostra:
- l'host, il proprietario, il repository, la cartella e il branch o il commit a cui è stato risolto
- il numero di file e la loro dimensione totale
- se il progetto ha una configurazione di avvio (vedi sotto)
- il linguaggio rilevato da Kendor, ad esempio detected Node.js 22
Sotto puoi regolare la sfida prima di aggiungerla:
- Titolo, suggerito dal nome del repository o della cartella
- Linguaggio, il linguaggio principale e la versione, più gli eventuali linguaggi extra usati dal progetto
- Database, quando il progetto ha bisogno di PostgreSQL o Valkey
- Come viene eseguito, un riepilogo dei servizi che Kendor avvierà
Se cambi il link, scegli Ricontrolla prima di aggiungere.
Come Kendor imposta il progetto
Ogni sfida viene eseguita da un file kendor.yaml che dice come installare e avviare il progetto. Durante la verifica Kendor ne cerca uno nella radice di ciò che importi:
- kendor.yaml trovato: il file del repository viene usato così com'è. La versione del linguaggio viene dal file, quindi non si può cambiare nel selettore del linguaggio.
- configurazione di avvio rilevata: controllala nell'editor: non c'è un
kendor.yaml, quindi Kendor ne scrive uno a partire da ciò che trova, comepackage.json,go.mod,pyproject.toml,composer.jsonoCargo.toml. I repository con un progetto per cartella ottengono un servizio per cartella. La nuova sfida si apre con la configurazione rilevata pronta da controllare. - nessun kendor.yaml — configura il runtime nell'editor: Kendor non è riuscito a capire come parte il progetto. I candidati hanno un terminale finché non lo configuri.
Per il formato del file vedi il riferimento di kendor.yaml.
Che cosa viene importato
Kendor copia i file, non la cronologia Git. Esclude le cartelle delle dipendenze e di build, tra cui node_modules, vendor, .git, dist, build, target, .venv e __pycache__, così i candidati installano le dipendenze da zero.
L'importazione ha questi limiti, conteggiati dopo aver escluso quelle cartelle:
| Limite | Valore |
|---|---|
| File | 5.000 |
| Dimensione totale | 50 MB |
| File singolo più grande | 5 MB |
| Download dall'host | 80 MB |
Un repository che supera il limite di file fallisce con il suggerimento di importare invece una sottocartella.
Suggerimento. Se vedi un messaggio di limite di richieste, aspetta qualche minuto, oppure chiedi a un proprietario di aggiungere un token per quell'host, cosa che alza il limite.
Dopo aver aggiunto la sfida
Aggiungi sfida crea la sfida e la apre nell'editor, dove puoi verificare che venga eseguita e scrivere la traccia. La sfida conserva una copia fissa dei file: i push successivi al repository non la modificano. Vedi Snapshot e aggiornamenti.