Saltar para o conteúdo
KendorDocs

Como importar um repositório privado

Para proprietários ·

Um proprietário da organização adiciona um token só de leitura para o anfitrião Git em Integrações → Hosts de código. Depois, qualquer pessoa que crie triagens pode importar a partir dele.

Para importar um repositório privado, um proprietário da organização guarda um token de acesso só de leitura para o respetivo anfitrião Git em Integrações, na secção Hosts de código. O Kendor usa então esse token sempre que alguém da organização verifica ou importa um repositório desse anfitrião. Há um token por anfitrião, partilhado por toda a organização.

Antes de começares

  • Só os Proprietários podem adicionar, substituir ou remover tokens. Os editores e os leitores podem abrir a página e ver que anfitriões estão ligados, mas não os alterar.
  • Os editores e os proprietários podem importar repositórios privados assim que um token estiver guardado. Nunca veem o token em si.

Adicionar um token para o GitHub, GitLab ou Bitbucket

  1. Abre Integrações na barra lateral.
  2. Em Hosts de código, escolhe Conectar no cartão do GitHub, GitLab ou Bitbucket.
  3. Cria um token no anfitrião (vê a tabela abaixo) e cola-o em Token só de leitura.
  4. Escolhe Guardar.

O Kendor verifica os tokens do GitHub e do GitLab com o anfitrião quando guardas, e recusa um que o anfitrião rejeite. O Bitbucket não tem uma verificação que funcione para todos os tipos de token, por isso um token do Bitbucket é testado primeiro pela tua próxima importação.

Depois de guardado, a página mostra Ligado, os últimos quatro carateres do token, a data em que foi adicionado e quem o adicionou.

Que token criar

O Kendor só lê repositórios, por isso usa um token que não consiga fazer push. A dica por baixo do campo do token na página de cada anfitrião diz o mesmo:

Anfitrião Token Permissão
GitHub Token de acesso pessoal de granularidade fina, com Repository access definido para os repositórios que importas (não "Public repositories", a predefinição) Contents: Read-only
GitHub (alternativa) Token clássico Âmbito repo. Funciona, mas também pode escrever em todos os repositórios a que tens acesso.
GitLab Token de acesso pessoal, de grupo ou de projeto read_repository
Bitbucket Token de acesso de repositório, de projeto ou de workspace Repositories: Read

Para um token de API Atlassian do Bitbucket, preenche também E-mail da conta (somente tokens de API da Atlassian) com o email da conta Atlassian a que o token pertence. Deixa vazio para tokens de acesso de repositório, de projeto e de workspace.

Dica. Um token do GitHub também ajuda com repositórios públicos do github.com: as importações passam pelo limite de pedidos do teu token em vez do partilhado.

Adicionar um servidor auto-alojado

Os servidores GitHub Enterprise Server, GitLab autogerenciado, Gitea e Forgejo são adicionados no cartão Servidores próprios. O Kendor só importa de um servidor que a tua organização tenha adicionado, e cada servidor tem o seu próprio token.

  1. Em Hosts de código, escolhe Conectar em Servidores próprios.
  2. Escolhe o Tipo de servidor: GitLab (autogerenciado), GitHub Enterprise Server ou Gitea ou Forgejo.
  3. Indica o Nome do servidor, como git.example.com. Indica apenas o nome: sem porta, caminho nem endereço IP.
  4. Cola um Token só de leitura com as mesmas permissões que para a versão cloud desse anfitrião.
  5. Escolhe Adicionar servidor.

O Kendor verifica o token com o servidor antes de guardar. Se o servidor responder mas não for do tipo que escolheste, vês uma mensagem a dizer que não parece ser esse tipo de servidor.

Nota. O servidor tem de ser acessível a partir da internet por HTTPS na porta standard. O Kendor recusa endereços em redes privadas, por isso um servidor disponível apenas dentro da rede da tua empresa ou por VPN não pode ser usado. O Bitbucket Data Center não é suportado.

Como os tokens são guardados

  • Os tokens são encriptados antes de serem guardados, e só são usados para transferir o repositório que importas.
  • O Kendor nunca volta a mostrar um token depois de o guardares. A página mostra apenas os últimos quatro carateres, a data em que foi adicionado e quem o adicionou.
  • Um token só é enviado ao anfitrião para o qual foi guardado.

Substituir ou remover um token

Na página do anfitrião, escolhe Substituir para colar um novo token, ou Remover para o apagar. Remover pede-te primeiro que confirmes.

Depois de um token ser removido:

  • Os desafios que já importaste mantêm o seu código. Nada nas tuas triagens ou entrevistas de programação ao vivo muda.
  • As novas importações de repositórios privados desse anfitrião deixam de funcionar até alguém voltar a adicionar um token. Os repositórios públicos do github.com, gitlab.com e bitbucket.org continuam a importar.
  • Para um servidor auto-alojado, remover o seu token remove também o servidor. As ligações para ele passam então a ser tratadas como um anfitrião desconhecido.

Erros que significam que falta um token ou que está errado

Quando um token resolveria uma verificação falhada, o erro tem uma ligação Conecte nas configurações de Integrações que abre num novo separador. As mensagens mais comuns:

  • Repository or ref not found … If it's private, connect a GitHub token. Os anfitriões Git respondem "not found" para repositórios privados quando não é enviado nenhum token. Verifica a grafia da ligação e do ramo e depois adiciona um token.
  • Repository or ref not found … or the organization's token can't read it. Há um token guardado, mas não cobre este repositório. Para um token do GitHub de granularidade fina, adiciona o repositório à lista de acesso a repositórios dele.
  • … rejected the organization's token. O token expirou ou foi revogado. Substitui-o.
  • … isn't connected. Add it under Settings → Integrations to import from it. A ligação aponta para um servidor que a tua organização não adicionou. Adiciona-o como servidor auto-alojado.

Depois de corrigires o token, volta atrás e escolhe Verificar outra vez.

Este artigo foi útil?