Saltar al contenido
KendorDocs

Cómo importar un repositorio de Git como reto

Para propietarios y editores ·

Pega un enlace de un repositorio de GitHub, GitLab, Bitbucket o autoalojado en una prueba o en una entrevista de programación en vivo, elige Comprobar y luego añádelo como reto.

Para usar un repositorio como reto, pega su enlace en el campo de repositorio de una prueba de código o de una entrevista de programación en vivo, elige Comprobar para ver qué importará Kendor y luego elige Añadir reto. Kendor copia los archivos, configura cómo se ejecuta el proyecto y abre el nuevo reto en el editor para que lo revises.

Antes de empezar

  • Necesitas el rol de Propietario o Editor. Los lectores no pueden añadir retos.
  • Los repositorios públicos de github.com, gitlab.com y bitbucket.org funcionan de inmediato. Los repositorios privados y tus propios servidores de Git necesitan antes un token: consulta Importa un repositorio privado.

El campo de repositorio aparece en dos sitios:

  • Pruebas de código. Abre Pruebas, abre o crea una prueba y ve a la sección Retos. Cuando la prueba aún no tiene retos, el campo ocupa toda la sección. Cuando ya tiene uno, el campo queda bajo la lista como Pega la URL de un repositorio para añadir un reto, para que puedas añadir más.
  • Entrevistas de programación en vivo. Abre Programación en vivo y elige Nueva entrevista de programación en vivo. El campo está en la sección Código. Una entrevista de programación en vivo contiene un solo reto, así que el campo solo se muestra mientras está vacía.

Puedes pegar el enlace tal como lo muestra tu servicio de Git. Todos estos funcionan:

Forma Ejemplo
Página del repositorio https://github.com/acme/rate-limiter
Sin https:// gitlab.com/acme/rate-limiter
URL de clonado HTTPS https://bitbucket.org/acme/rate-limiter.git
URL de clonado SSH git@github.com:acme/rate-limiter.git
Página de una rama o carpeta https://github.com/acme/platform/tree/main/services/api
Abreviatura de GitHub acme/rate-limiter o acme/rate-limiter@v2

La abreviatura solo funciona con github.com. Lo que va después de @ es una rama, una etiqueta o un commit; sin ello, Kendor usa la rama predeterminada. Para importar una sola rama o carpeta, pega el enlace de su página, como se explica en Importa una carpeta o una rama.

No se acepta un enlace a un solo archivo, como las páginas /blob/ de GitHub. Usa en su lugar el enlace del repositorio, de la rama o de la carpeta.

Servicios de Git compatibles

Servicio Necesita token
github.com Solo para repositorios privados
gitlab.com Solo para repositorios privados
bitbucket.org (Bitbucket Cloud) Solo para repositorios privados
GitHub Enterprise Server Siempre: primero hay que añadir el servidor
GitLab autogestionado Siempre: primero hay que añadir el servidor
Gitea o Forgejo Siempre: primero hay que añadir el servidor

Los subgrupos de GitLab funcionan, por ejemplo https://gitlab.com/acme/backend/payments. Bitbucket Data Center (el Bitbucket autoalojado) no es compatible.

Si pegas un enlace a un servidor que tu organización no ha añadido, la comprobación se detiene con un mensaje que indica que el servicio no está conectado, y un enlace Conéctalo en los ajustes de Integraciones.

Qué muestra la comprobación

Comprobar es una prueba en seco que no cambia nada. El resultado muestra:

  • el servicio, el propietario, el repositorio, la carpeta y la rama o el commit al que se resolvió
  • el número de archivos y su tamaño total
  • si el proyecto tiene una configuración de arranque (más abajo)
  • el lenguaje que detectó Kendor, como detected Node.js 22

Debajo puedes ajustar el reto antes de añadirlo:

  • Título, sugerido a partir del nombre del repositorio o de la carpeta
  • Lenguaje, el lenguaje principal y su versión, además de los lenguajes adicionales que use el proyecto
  • Bases de datos, cuando el proyecto necesita PostgreSQL o Valkey
  • Cómo se ejecuta, un resumen de los servicios que iniciará Kendor

Si cambias el enlace, elige Volver a comprobar antes de añadir.

Cómo configura Kendor el proyecto

Cada reto se ejecuta a partir de un archivo kendor.yaml que indica cómo instalar e iniciar el proyecto. Durante la comprobación, Kendor busca uno en la raíz de lo que importas:

  • kendor.yaml encontrado: se usa tal cual el archivo del propio repositorio. La versión del lenguaje procede del archivo, así que no se puede cambiar en el selector de lenguaje.
  • configuración de arranque detectada: revísala en el editor: no hay kendor.yaml, así que Kendor escribe uno a partir de lo que encuentra, como package.json, go.mod, pyproject.toml, composer.json o Cargo.toml. Los repositorios con un proyecto por carpeta obtienen un servicio por carpeta. El reto nuevo se abre con la configuración detectada lista para que la revises.
  • sin kendor.yaml — configura el runtime en el editor: Kendor no pudo saber cómo arranca el proyecto. Los candidatos tendrán una terminal hasta que lo configures.

Consulta la referencia de kendor.yaml para ver el formato del archivo.

Qué se importa

Kendor copia los archivos, no el historial de Git. Deja fuera las carpetas de dependencias y de compilación, incluidas node_modules, vendor, .git, dist, build, target, .venv y __pycache__, de modo que los candidatos instalan las dependencias desde cero.

La importación tiene estos límites, contados después de dejar fuera esas carpetas:

Límite Valor
Archivos 5.000
Tamaño total 50 MB
Archivo individual más grande 5 MB
Descarga desde el servicio 80 MB

Un repositorio que supera el límite de archivos falla con la sugerencia de importar una subcarpeta en su lugar.

Consejo. Si ves un mensaje de límite de peticiones, espera unos minutos o pide a un propietario que añada un token para ese servicio, lo que aumenta el límite.

Después de añadir el reto

Añadir reto crea el reto y lo abre en el editor, donde puedes comprobar que se ejecuta y redactar el enunciado. El reto conserva una copia fija de los archivos: los cambios posteriores en el repositorio no lo modifican. Consulta Copias y actualizaciones.

¿Te ha resultado útil este artículo?