Saltar al contenido
KendorDocs

Cómo importar una carpeta o una rama de un repositorio

Para propietarios y editores ·

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.

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.yaml en 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 su package.json o go.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-api sugiere 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.
¿Te ha resultado útil este artículo?