Problemas do GitHub
Corrija problemas de organizações durante a configuração, repositórios ausentes, webhooks falhos, permissões e branches divergentes na integração GitHub do Jamdesk.
A maioria dos problemas de integração com o GitHub está relacionada a permissões, falhas de webhook ou divergências de branch.
Organização não aparece durante a configuração
Durante o fluxo de configuração inicial, o Jamdesk mostra suas organizações do GitHub para que você escolha onde criar o repositório. A lista vem da API OAuth do GitHub, e o GitHub oculta organizações em dois casos:
- Restrições do aplicativo OAuth: sua organização restringe o acesso de aplicativos de terceiros (padrão do GitHub para organizações novas) e ainda não aprovou o Jamdesk.
- SAML SSO: sua organização exige autenticação SAML antes que a API a retorne.
Se você for proprietário da organização, poderá aprovar o Jamdesk imediatamente:
- Clique em grant Jamdesk access on GitHub abaixo do seletor de organização (ou acesse GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk)
- Em Organization access, clique em Grant ao lado da sua organização
- De volta ao fluxo de configuração do Jamdesk, clique em refresh the list. Sua organização aparecerá imediatamente
Se você for membro (e não proprietário), verá um botão Request; clicar nele enviará uma solicitação de aprovação aos administradores da organização.
Se você for membro sem direitos de proprietário, envie primeiro uma solicitação de aprovação aos administradores:
- Acesse GitHub → Settings → Applications → Authorized OAuth Apps → Jamdesk
- Em Organization access, clique em Request ao lado da sua organização. Isso notificará os administradores da organização
- Um administrador aprova a solicitação em Settings → Third-party access → OAuth application policy da organização (as solicitações pendentes mostram um botão Approve)
- Retorne ao fluxo de configuração do Jamdesk e clique em refresh the list; sua organização deverá aparecer
Consulte o guia do GitHub sobre como aprovar aplicativos OAuth para sua organização para ver instruções detalhadas.
Não quer esperar a aprovação do administrador? Escolha sua conta pessoal durante a configuração e transfira o repositório para sua organização depois:
- Conclua a configuração do Jamdesk usando sua conta pessoal
- Acesse o repositório criado no GitHub
- Navegue até Settings → General → Danger Zone
- Clique em Transfer e selecione sua organização como destino
- No Jamdesk, desconecte e reconecte o repositório na página Settings do seu projeto
Desconectar e reconectar gera uma nova URL de documentação (por exemplo, your-project.jamdesk.app pode mudar). Se você já tiver compartilhado sua URL ou configurado um domínio personalizado, entre em contato com o suporte antes de desconectar para que possamos preservar sua configuração.
Repositório não aparece
Se o repositório não aparecer na lista:
- Acesse GitHub → Settings → Applications → Jamdesk
- Verifique se o acesso ao repositório foi concedido
- Clique em Configure para adicionar mais repositórios
Para repositórios da organização:
- Um administrador da organização deve aprovar o Jamdesk
- Acesse as configurações da organização → Third-party access
- Aprove a solicitação de acesso do Jamdesk
Repositórios privados exigem autorização do GitHub. Autorize o Jamdesk novamente, se necessário.
Builds não são acionados
Se os pushes não acionarem builds:
- Acesse seu repositório no GitHub
- Navegue até Settings → Webhooks
- Encontre o webhook do Jamdesk
- Verifique se há erros em "Recent Deliveries"
Os builds são acionados somente na branch configurada. Verifique Settings no Jamdesk.
- Acesse Settings do projeto no Jamdesk
- Clique em Re-sync GitHub
Erros de webhook
404 Not Found
Não foi possível acessar o endpoint do webhook.
Correção: sincronize novamente a conexão do GitHub nas configurações do projeto.
401 Unauthorized
Falha na autenticação.
Correção:
- Acesse as configurações da sua conta do GitHub
- Navegue até Applications → Authorized OAuth Apps
- Revogue o Jamdesk
- Autorize novamente nas configurações do Jamdesk
500 Server Error
Problema temporário do Jamdesk.
Correção: aguarde alguns minutos e faça push novamente ou acione um rebuild manual.
Erros de permissão
"Repository not found" durante o build:
- O repositório pode ter sido excluído ou renomeado
- O Jamdesk pode ter perdido o acesso
- Autorize novamente sua conexão do GitHub
Problemas de branch
Build na branch errada
Verifique a branch configurada em Settings → Repository.
Branch renomeada ou excluída
Atualize a configuração da branch para corresponder ao novo nome.