Como importar um repositório Git como desafio
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.
Onde colar a ligação
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.
Ligações que o Kendor aceita
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, comopackage.json,go.mod,pyproject.toml,composer.jsonouCargo.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.