Cómo importar una carpeta o una rama de un repositorio
Pega el enlace de la página de una carpeta o una rama de tu servicio de Git. Kendor importa solo esa parte y convierte la carpeta en la raíz del proyecto del candidato.
Para importar una parte de un repositorio, abre la carpeta o la rama en tu servicio de Git, copia el enlace de la barra de direcciones del navegador y pégalo en el campo de repositorio en lugar del enlace simple del repositorio. Kendor lee la rama y la carpeta del enlace, importa solo esa carpeta y la convierte en la raíz del proyecto del candidato.
Esto va bien con monorepos, con repositorios que guardan varios ejercicios uno al lado del otro y con retos que viven en su propia rama.
Formas de enlace para cada servicio
La rama también puede ser una etiqueta o un hash de commit completo. La parte de la carpeta es opcional: omítela para importar todo el repositorio en esa rama.
| Servicio | Enlace de rama o carpeta |
|---|---|
| GitHub y GitHub Enterprise Server | https://github.com/<owner>/<repo>/tree/<branch>/<folder> |
| GitLab y GitLab autogestionado | https://gitlab.com/<group>/<repo>/-/tree/<branch>/<folder> |
| Bitbucket | https://bitbucket.org/<workspace>/<repo>/src/<branch>/<folder> |
| Gitea y Forgejo | https://git.example.com/<owner>/<repo>/src/branch/<branch>/<folder> |
En Gitea y Forgejo, usa src/tag/<tag> para una etiqueta y src/commit/<hash> para un commit. Los enlaces de GitLab pueden incluir subgrupos, como gitlab.com/acme/backend/platform/-/tree/main/services/api.
No se aceptan enlaces a un solo archivo, como las páginas /blob/ de GitHub.
Ejemplos
Un servicio de Node.js en un monorepo de GitHub:
https://github.com/acme/platform/tree/main/services/api
Kendor importa services/api de la rama main. Un archivo que estaba en services/api/package.json en el repositorio queda en package.json en el reto.
Una versión etiquetada de un proyecto de GitLab, con todo el repositorio:
https://gitlab.com/acme/rate-limiter/-/tree/v2.1.0
Una carpeta de ejercicio en Bitbucket:
https://bitbucket.org/acme/exercises/src/main/booking-api
Un commit fijado en un servidor de Gitea:
https://git.example.com/acme/platform/src/commit/4f9c2e1d8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d/services/api
Qué cambia al cambiar la raíz
La carpeta a la que enlazas se convierte en la parte superior del proyecto del candidato. Eso afecta a varias cosas:
- Configuración de arranque. Kendor busca
kendor.yamlen la raíz de la carpeta, no en la raíz del repositorio. Si la carpeta no tiene ninguno, Kendor detecta la configuración a partir de los propios archivos de la carpeta, como supackage.jsonogo.mod. - Los archivos fuera de la carpeta no se incluyen. Si la carpeta depende de algo que está en otra parte del repositorio, como un paquete compartido o un lockfile en la raíz del repositorio, el candidato no lo tendrá. Importa en su lugar la carpeta superior, o copia a la carpeta lo que haga falta.
- Los límites se aplican a la carpeta. Los límites de 5.000 archivos y 50 MB cuentan solo los archivos de la carpeta, después de dejar fuera las carpetas de dependencias. Si un repositorio entero es demasiado grande, importar la carpeta que necesitas suele ser la solución.
- El título sugerido procede del nombre de la carpeta, así que
services/booking-apisugiere Booking Api. Puedes cambiarlo antes de añadir.
El resultado de Comprobar muestra la carpeta y la rama o el commit después del nombre del repositorio, para que puedas confirmar lo que vas a importar antes de elegir Añadir reto.
Nombres de rama que contienen una barra
En un enlace, Kendor trata el primer segmento después de tree/ (o src/) como la rama y todo lo que sigue como la carpeta. Una rama llamada feature/new-api se leería como la rama feature y la carpeta new-api.
Para una rama así:
- En github.com, usa la abreviatura
owner/repo@feature/new-api. Importa todo el repositorio en esa rama, sin elegir una carpeta. - En cualquier servicio, usa un enlace con el hash del commit en lugar del nombre de la rama. Copia el hash del último commit de la rama y ponlo donde va la rama.
Errores habituales
- No files found under "services/api" significa que la carpeta no existe en esa rama, o que solo contiene carpetas de dependencias o de compilación que Kendor deja fuera. Comprueba la ortografía, incluidas las mayúsculas y minúsculas.
- Repository or ref not found significa que la rama, la etiqueta o el commit no existen, o que el repositorio es privado. Consulta Importa un repositorio privado.
- Use a repository or /tree/<branch>/<folder> URL (o el equivalente de GitLab, Bitbucket o Gitea) significa que el enlace apunta a algo distinto de un repositorio, una rama o una carpeta, como un archivo, una pull request o una incidencia.