Vai al contenuto
KendorDocs

Come importare un repository Git come sfida

Per proprietari ed editor ·

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.

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.

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, come package.json, go.mod, pyproject.toml, composer.json o Cargo.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.

Questo articolo ti è stato utile?