Come importare una cartella o un branch di un repository
Incolla il link alla pagina di una cartella o di un branch del tuo host Git. Kendor importa solo quella parte e rende la cartella la radice del progetto del candidato.
Per importare una parte di un repository, apri la cartella o il branch sul tuo host Git, copia il link dalla barra degli indirizzi del browser e incollalo nel campo del repository al posto del semplice link del repository. Kendor legge il branch e la cartella dal link, importa solo quella cartella e la rende la radice del progetto del candidato.
Questo è adatto ai monorepo, ai repository che tengono più esercizi affiancati e alle sfide che vivono su un branch proprio.
Forme del link per ogni host
Il branch può essere anche un tag o l'hash completo di un commit. La parte della cartella è facoltativa: omettila per importare l'intero repository a quel branch.
| Host | Link di un branch o di una cartella |
|---|---|
| GitHub e GitHub Enterprise Server | https://github.com/<owner>/<repo>/tree/<branch>/<folder> |
| GitLab e GitLab self-managed | https://gitlab.com/<group>/<repo>/-/tree/<branch>/<folder> |
| Bitbucket | https://bitbucket.org/<workspace>/<repo>/src/<branch>/<folder> |
| Gitea e Forgejo | https://git.example.com/<owner>/<repo>/src/branch/<branch>/<folder> |
Per Gitea e Forgejo, usa src/tag/<tag> per un tag e src/commit/<hash> per un commit. I link di GitLab possono includere sottogruppi, come gitlab.com/acme/backend/platform/-/tree/main/services/api.
I link a un singolo file, come le pagine /blob/ di GitHub, non vengono accettati.
Esempi
Un servizio Node.js in un monorepo su GitHub:
https://github.com/acme/platform/tree/main/services/api
Kendor importa services/api dal branch main. Un file che nel repository si trovava in services/api/package.json si trova in package.json nella sfida.
Una release con tag di un progetto GitLab, intero repository:
https://gitlab.com/acme/rate-limiter/-/tree/v2.1.0
Una cartella di esercizio su Bitbucket:
https://bitbucket.org/acme/exercises/src/main/booking-api
Un commit fissato su un server Gitea:
https://git.example.com/acme/platform/src/commit/4f9c2e1d8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d/services/api
Che cosa cambia con la nuova radice
La cartella a cui punti il link diventa la cima del progetto del candidato. Questo influisce su alcune cose:
- Configurazione di avvio. Kendor cerca
kendor.yamlnella radice della cartella, non nella radice del repository. Se la cartella non ne ha uno, Kendor rileva la configurazione dai file della cartella stessa, come il suopackage.jsonogo.mod. - I file fuori dalla cartella non sono inclusi. Se la cartella dipende da qualcosa altrove nel repository, come un pacchetto condiviso o un lockfile nella radice del repository, il candidato non l'avrà. Importa invece la cartella superiore, oppure copia nella cartella ciò che serve.
- I limiti si applicano alla cartella. I limiti di 5.000 file e 50 MB contano solo i file della cartella, dopo aver escluso le cartelle delle dipendenze. Se un intero repository è troppo grande, importare la cartella che ti serve di solito è la soluzione.
- Il titolo suggerito deriva dal nome della cartella, quindi
services/booking-apisuggerisce Booking Api. Puoi cambiarlo prima di aggiungere.
Il risultato di Verifica mostra la cartella e il branch o il commit dopo il nome del repository, così puoi confermare ciò che stai per importare prima di scegliere Aggiungi sfida.
Nomi di branch che contengono una barra
In un link, Kendor considera il primo segmento dopo tree/ (o src/) come il branch e tutto ciò che segue come la cartella. Un branch chiamato feature/new-api verrebbe letto come il branch feature e la cartella new-api.
Per un branch di questo tipo:
- Su github.com, usa la forma abbreviata
owner/repo@feature/new-api. Importa l'intero repository a quel branch, senza scegliere una cartella. - Su qualsiasi host, usa un link con l'hash del commit al posto del nome del branch. Copia l'hash dell'ultimo commit del branch e mettilo dove va il branch.
Errori comuni
- No files found under "services/api" significa che la cartella non esiste su quel branch, oppure contiene solo cartelle di dipendenze o di build che Kendor esclude. Controlla l'ortografia, comprese maiuscole e minuscole.
- Repository or ref not found significa che il branch, il tag o il commit non esiste, oppure che il repository è privato. Vedi Importare un repository privato.
- Use a repository or /tree/<branch>/<folder> URL (o l'equivalente per GitLab, Bitbucket o Gitea) significa che il link punta a qualcosa di diverso da un repository, un branch o una cartella, come un file, una pull request o una issue.