O GitHub se conecta por meio do Coroid App do GitHub ou um token de acesso pessoal. Configure-o em Configurações → Conexões → Controle de versão.
App ou token
Prefira o App. Ele concede acesso por repositório em vez de por usuário, continua funcionando mesmo quando a pessoa que o configurou sai da empresa e recebe eventos de webhook sem necessidade de polling.
Use um token quando a instalação do App exigir aprovação de administrador de organização que você não possa obter.
| App do GitHub | Token de acesso pessoal | |
|---|---|---|
| Escopo de acesso | Por repositório | Tudo o que o usuário pode ver |
| Continua ativo mesmo após a saída do instalador | Sim | Não |
| Eventos de webhook | Sim | Polling |
| Atribuição | O App | O proprietário do token |
Instalar o App
Escolha o GitHub em Configurações → Conexões → Controle de versão e siga o fluxo de instalação. O GitHub pergunta quais repositórios devem ter acesso; você pode alterar isso posteriormente nas configurações próprias do GitHub.
Se um repositório não aparecer ao criar um projeto, é quase certo que o App não recebeu permissão para esse repositório específico — essa é, de longe, a causa mais comum.
Usar um token
Crie um token clássico com o escopo repo , ou um token refinado com leitura e escrita em conteúdo e pull requests, e cole-o nas configurações de controle de versão.
Os tokens são criptografados em repouso, nunca são retornados pelo API e nunca são incluídos nas exportações de configurações.
Issues do GitHub
A mesma conexão permite importar issues como tarefas. Veja Importar tarefas.
O que o Coroid faz no seu repositório
- lê o código para entendê-lo e modificá-lo
- cria uma branch por tarefa
- envia essa branch e abre um pull request do pull request contra a sua branch base
Ele nunca commita na sua branch padrão nem faz merge. Suas regras de proteção de branch, verificações obrigatórias e revisão permanecem inalteradas.