Saltar para o conteúdo
KendorDocs

Como importar um repositório Git como desafio

Para proprietários e editores ·

Cola uma ligação de um repositório do GitHub, GitLab, Bitbucket ou auto-alojado numa triagem ou entrevista de programação ao vivo, escolhe Verificar e adiciona-o como desafio.

Para usar um repositório como desafio, cola a ligação dele no campo de repositório de uma triagem de código ou de uma entrevista de programação ao vivo, escolhe Verificar para pré-visualizar o que o Kendor vai importar e depois escolhe Adicionar desafio. O Kendor copia os ficheiros, configura a forma como o projeto corre e abre o novo desafio no editor para o reveres.

Antes de começares

  • Precisas da função Proprietário ou Editor. Os leitores não podem adicionar desafios.
  • Os repositórios públicos em github.com, gitlab.com e bitbucket.org funcionam logo. Os repositórios privados e os teus próprios servidores Git precisam primeiro de um token: vê Importar um repositório privado.

O campo de repositório aparece em dois sítios:

  • Triagens de código. Abre Triagens, abre ou cria uma triagem e vai à secção Desafios. Quando a triagem ainda não tem desafios, o campo preenche a secção. Quando já tem um, o campo fica por baixo da lista como Cole a URL de um repositório para adicionar um desafio, para poderes adicionar mais.
  • Entrevistas de programação ao vivo. Abre Programação ao vivo e escolhe Nova entrevista de programação ao vivo. O campo está na secção Código. Uma entrevista de programação ao vivo tem um só desafio, por isso o campo só aparece enquanto está vazia.

Podes colar a ligação tal como o teu anfitrião Git a mostra. Todas estas funcionam:

Forma Exemplo
Página do repositório https://github.com/acme/rate-limiter
Sem https:// gitlab.com/acme/rate-limiter
URL de clone HTTPS https://bitbucket.org/acme/rate-limiter.git
URL de clone SSH git@github.com:acme/rate-limiter.git
Página de ramo ou pasta https://github.com/acme/platform/tree/main/services/api
Atalho do GitHub acme/rate-limiter ou acme/rate-limiter@v2

O atalho só funciona para github.com. A parte depois de @ é um ramo, uma tag ou um commit; sem ela, o Kendor usa o ramo por omissão. Para importar um único ramo ou pasta, cola a ligação da respetiva página, como descrito em Importar uma pasta ou um ramo.

Uma ligação para um único ficheiro, como as páginas /blob/ do GitHub, não é aceite. Usa antes a ligação do repositório, do ramo ou da pasta.

Anfitriões Git suportados

Anfitrião Precisa de token
github.com Só para repositórios privados
gitlab.com Só para repositórios privados
bitbucket.org (Bitbucket Cloud) Só para repositórios privados
GitHub Enterprise Server Sempre: o servidor tem de ser adicionado primeiro
GitLab autogerenciado Sempre: o servidor tem de ser adicionado primeiro
Gitea ou Forgejo Sempre: o servidor tem de ser adicionado primeiro

Os subgrupos do GitLab funcionam, por exemplo https://gitlab.com/acme/backend/payments. O Bitbucket Data Center (o Bitbucket auto-alojado) não é suportado.

Se colares uma ligação para um servidor que a tua organização não adicionou, a verificação pára com uma mensagem a dizer que o anfitrião não está ligado, e uma ligação Conecte nas configurações de Integrações.

O que a verificação mostra

Verificar é um ensaio que não altera nada. O resultado mostra:

  • o anfitrião, o proprietário, o repositório, a pasta e o ramo ou commit a que correspondeu
  • o número de ficheiros e o seu tamanho total
  • se o projeto tem uma configuração de execução (vê abaixo)
  • a linguagem que o Kendor detetou, como Node.js 22 detetado

Por baixo podes ajustar o desafio antes de o adicionares:

  • Título, sugerido a partir do nome do repositório ou da pasta
  • Linguagem, a linguagem principal e a versão, mais as linguagens extra que o projeto usa
  • Bancos de dados, quando o projeto precisa de PostgreSQL ou Valkey
  • Como é executado, um resumo dos serviços que o Kendor vai iniciar

Se mudares a ligação, escolhe Verificar de novo antes de adicionar.

Como o Kendor configura o projeto

Todos os desafios correm a partir de um ficheiro kendor.yaml que diz como instalar e iniciar o projeto. Durante a verificação, o Kendor procura um na raiz do que importas:

  • kendor.yaml encontrado: o ficheiro do próprio repositório é usado tal como está. A versão da linguagem vem do ficheiro, por isso não pode ser alterada no seletor de linguagem.
  • configuração de execução detectada — revise no editor: não há kendor.yaml, por isso o Kendor escreve um a partir do que encontra, como package.json, go.mod, pyproject.toml, composer.json ou Cargo.toml. Os repositórios com um projeto por pasta ficam com um serviço por pasta. O novo desafio abre com a configuração detetada pronta para a reveres.
  • sem kendor.yaml — configure o runtime no editor: o Kendor não conseguiu perceber como o projeto arranca. Os candidatos ficam com um terminal até o configurares.

Vê a referência do kendor.yaml para o formato do ficheiro.

O que é importado

O Kendor copia os ficheiros, não o histórico do Git. Deixa de fora as pastas de dependências e de build, incluindo node_modules, vendor, .git, dist, build, target, .venv e __pycache__, para que os candidatos instalem as dependências de raiz.

A importação tem estes limites, contados depois de essas pastas serem deixadas de fora:

Limite Valor
Ficheiros 5.000
Tamanho total 50 MB
Maior ficheiro individual 5 MB
Transferência do anfitrião 80 MB

Um repositório acima do limite de ficheiros falha com a sugestão de importar uma subpasta.

Dica. Se vires uma mensagem de limite de pedidos, espera alguns minutos, ou pede a um proprietário que adicione um token para esse anfitrião, o que aumenta o limite.

Depois de adicionares o desafio

Adicionar desafio cria o desafio e abre-o no editor, onde podes verificar se corre e escrever o enunciado. O desafio mantém uma cópia fixa dos ficheiros: os pushes posteriores ao repositório não o alteram. Vê Cópias fixas e atualizações.

Este artigo foi útil?