Saltar para o conteúdo
KendorDocs

Como importar uma pasta ou um ramo de um repositório

Para proprietários e editores ·

Cola a ligação de uma página de pasta ou de ramo do teu anfitrião Git. O Kendor importa só essa parte e faz da pasta a raiz do projeto do candidato.

Para importar parte de um repositório, abre a pasta ou o ramo no teu anfitrião Git, copia a ligação da barra de endereços do browser e cola-a no campo de repositório em vez da ligação simples do repositório. O Kendor lê o ramo e a pasta a partir da ligação, importa apenas essa pasta e faz dela a raiz do projeto do candidato.

Isto serve para monorepos, repositórios que guardam vários exercícios lado a lado e desafios que vivem no seu próprio ramo.

O ramo pode também ser uma tag ou um hash de commit completo. A parte da pasta é opcional: deixa-a de fora para importar o repositório inteiro nesse ramo.

Anfitrião Ligação de ramo ou pasta
GitHub e GitHub Enterprise Server https://github.com/<owner>/<repo>/tree/<branch>/<folder>
GitLab e GitLab autogerenciado https://gitlab.com/<group>/<repo>/-/tree/<branch>/<folder>
Bitbucket https://bitbucket.org/<workspace>/<repo>/src/<branch>/<folder>
Gitea e Forgejo https://git.example.com/<owner>/<repo>/src/branch/<branch>/<folder>

Para o Gitea e o Forgejo, usa src/tag/<tag> para uma tag e src/commit/<hash> para um commit. As ligações do GitLab podem incluir subgrupos, como gitlab.com/acme/backend/platform/-/tree/main/services/api.

As ligações para um único ficheiro, como as páginas /blob/ do GitHub, não são aceites.

Exemplos

Um serviço Node.js num monorepo no GitHub:

https://github.com/acme/platform/tree/main/services/api

O Kendor importa services/api do ramo main. Um ficheiro que estava em services/api/package.json no repositório fica em package.json no desafio.

Uma versão com tag de um projeto GitLab, repositório inteiro:

https://gitlab.com/acme/rate-limiter/-/tree/v2.1.0

Uma pasta de exercício no Bitbucket:

https://bitbucket.org/acme/exercises/src/main/booking-api

Um commit fixo num servidor Gitea:

https://git.example.com/acme/platform/src/commit/4f9c2e1d8a7b6c5d4e3f2a1b0c9d8e7f6a5b4c3d/services/api

O que a mudança de raiz altera

A pasta para a qual apontas passa a ser o topo do projeto do candidato. Isso afeta algumas coisas:

  • Configuração de execução. O Kendor procura o kendor.yaml na raiz da pasta, não na raiz do repositório. Se a pasta não tiver nenhum, o Kendor deteta a configuração a partir dos ficheiros da própria pasta, como o package.json ou o go.mod.
  • Os ficheiros fora da pasta não são incluídos. Se a pasta depende de algo noutro ponto do repositório, como um pacote partilhado ou um lockfile na raiz do repositório, o candidato não o terá. Importa antes a pasta-mãe, ou copia para a pasta o que for preciso.
  • Os limites aplicam-se à pasta. Os limites de 5.000 ficheiros e 50 MB contam apenas os ficheiros da pasta, depois de as pastas de dependências serem deixadas de fora. Se um repositório inteiro for demasiado grande, importar a pasta de que precisas costuma ser a solução.
  • O título sugerido vem do nome da pasta, por isso services/booking-api sugere Booking Api. Podes alterá-lo antes de adicionar.

O resultado de Verificar mostra a pasta e o ramo ou commit a seguir ao nome do repositório, para confirmares o que estás prestes a importar antes de escolheres Adicionar desafio.

Nomes de ramo que contêm uma barra

Numa ligação, o Kendor trata o primeiro segmento depois de tree/ (ou src/) como o ramo e tudo o que vem a seguir como a pasta. Um ramo chamado feature/new-api seria lido como o ramo feature e a pasta new-api.

Para um ramo assim:

  • No github.com, usa o atalho owner/repo@feature/new-api. Isto importa o repositório inteiro nesse ramo, sem escolher uma pasta.
  • Em qualquer anfitrião, usa uma ligação com o hash do commit em vez do nome do ramo. Copia o hash do último commit do ramo e põe-no onde vai o ramo.

Erros comuns

  • No files found under "services/api" significa que a pasta não existe nesse ramo, ou só tem pastas de dependências ou de build que o Kendor deixa de fora. Verifica a grafia, incluindo maiúsculas e minúsculas.
  • Repository or ref not found significa que o ramo, a tag ou o commit não existe, ou que o repositório é privado. Vê Importar um repositório privado.
  • Use a repository or /tree/<branch>/<folder> URL (ou o equivalente do GitLab, Bitbucket ou Gitea) significa que a ligação aponta para algo que não é um repositório, ramo ou pasta, como um ficheiro, um pull request ou um issue.
Este artigo foi útil?