Como conectar sua conta GitHub à Zenifra
Para usar repositórios GitHub na Zenifra, você precisa concluir duas etapas: vincular sua conta GitHub à sua conta Zenifra e instalar o GitHub App Zenifra na conta pessoal ou organização que possui os repositórios.
Pré-requisitos
- Uma conta ativa na Zenifra
- Uma conta no GitHub
- Permissão para instalar apps no GitHub na conta ou organização desejada
Passo 1 — Vincule sua conta GitHub à Zenifra
- Faça login no console da Zenifra.
- Abra a área de configurações da sua conta.
- Inicie a conexão com a sua conta GitHub.
- Autorize o vínculo entre GitHub e Zenifra.
Esse vínculo identifica qual usuário do GitHub será usado pela Zenifra. Ele não libera repositórios por si só. O acesso aos repositórios depende da instalação do GitHub App Zenifra.
Passo 2 — Instale o GitHub App Zenifra
Depois de vincular a conta, abra a página de instalação do app:
Na instalação, o GitHub pedirá que você escolha onde o app será instalado e quais repositórios poderão ser usados pela Zenifra.
A instalação do app define quais contas e quais repositórios a Zenifra poderá enxergar no momento de criar ou atualizar projetos com origem GitHub.
Passo 3 — Escolha conta pessoal ou organização
Conta pessoal
Escolha sua conta pessoal quando os repositórios que você quer usar pertencem ao seu usuário do GitHub. Esse é o fluxo mais simples para projetos próprios, testes e aplicações individuais.
Organização
Escolha uma organização quando os repositórios pertencem a um workspace compartilhado no GitHub. Dependendo das regras da organização, a instalação do app pode exigir aprovação de um administrador antes de ficar disponível.
Se você trabalha com mais de uma organização, instale o app separadamente em cada uma que deverá disponibilizar repositórios para a Zenifra.
Passo 4 — Escolha os repositórios
Durante a instalação, o GitHub normalmente oferece duas opções:
- Todos os repositórios: libera acesso automático aos repositórios atuais e futuros daquela conta ou organização.
- Apenas repositórios selecionados: libera somente os repositórios escolhidos manualmente.
Se você quer limitar o acesso inicial, prefira a seleção manual. Se o repositório esperado não aparecer depois no console da Zenifra, revise a instalação do app e confirme se ele foi incluído.
Como confirmar que a integração funcionou
Depois de concluir a instalação:
- Volte ao console da Zenifra.
- Inicie o fluxo de criação ou edição de um projeto com origem GitHub.
- Verifique se a conta pessoal ou organização correta aparece.
- Confirme se o repositório esperado está disponível para seleção.
Se a conta apareceu, mas um repositório específico não apareceu, o vínculo da conta está funcionando e o ajuste necessário provavelmente está na instalação do app ou na seleção de repositórios.
Solução de problemas
O repositório não aparece na Zenifra
Verifique se o app Zenifra foi instalado na conta certa e se o repositório foi incluído na instalação. Isso é comum quando a instalação foi feita com a opção de repositórios selecionados.
A organização não aparece na página de instalação
Confirme se o seu usuário do GitHub tem permissão para instalar apps nessa organização. Algumas organizações também restringem instalações para administradores.
O app foi instalado, mas ainda falta acesso
Algumas organizações exigem aprovação adicional após o início da instalação. Nesses casos, peça para um administrador revisar e concluir a autorização.
Instalei o app na conta errada
Abra novamente a página de instalação do app e refaça o processo escolhendo a conta pessoal ou organização correta.