Conectar o GitHub Issues: guia passo a passo
Abre uma issue no GitHub para cada teste com falha, adiciona um comentário quando o teste falha novamente e fecha a issue quando o teste passa sem problemas. O GitHub não aceita envio de arquivos, então a issue indica a pasta de evidências em vez de anexar a captura de tela. Este guia leva você do zero a uma conexão verificada e lista os erros que podem ocorrer, com suas causas e soluções.
Última atualização:
Mantenha suas credenciais em sigilo. Nunca cole um token, uma chave, uma senha ou uma URL de webhook em uma conversa. Insira esses dados apenas em Studio → Configurações → Integrações, onde são salvos no arquivo .env do seu espaço de trabalho e exibidos como pontos. O mesmo vale para um assistente de IA: ele pode orientar você neste guia, mas nunca precisa do seu token.
O que você precisa
- Uma conta do GitHub que possa abrir issues no repositório (de um colaborador ou do proprietário).
- Um repositório com Issues ativado (Configurações do repositório → Recursos → Issues).
- Um token de acesso pessoal com permissões granulares com Issues → Leitura e gravação nesse repositório, ou um token clássico com o escopo repo.
Obtenha as credenciais
- Abra https://github.com/settings/personal-access-tokens/new (um token com permissões granulares).
- Dê um nome ao token, defina uma data de expiração e, em Acesso ao repositório, escolha Somente repositórios selecionados, depois selecione o repositório que receberá as issues.
- Em Permissões → Permissões do repositório, defina Issues como Leitura e gravação. Nada mais é necessário.
- Gere o token e copie-o agora. O GitHub o exibe apenas uma vez. Não o cole em nenhum lugar além do Studio (próxima etapa).
Conecte no Studio
- No Studio, abra Configurações → Integrações → Conectar o GitHub Issues.
- Quando solicitado, insira o token e pressione Salvar & verificar. O Studio mostra a quem o token pertence e a quantos repositórios ele tem acesso.
- Selecione o repositório em "Destino das issues". A lista só exibe repositórios aos quais o token tem acesso e que estão com Issues ativado.
- Ative
GITHUB_ISSUES_ENABLED.
Verifique se funciona
- Verificar conexão mostra "conectado como <you>" e "<owner/repo> aceita issues". A verificação apenas lê dados; nunca abre uma issue.
- Abra Configurações → Integrações → Chamados e pressione Criar chamado de teste no destino do GitHub. Isso abre uma issue com a etiqueta nexus-test.
- Abra a issue no GitHub, confirme a etiqueta e feche-a ou exclua-a quando terminar.
Erros comuns
| O que você vê | Causa | Solução |
|---|---|---|
| "O GitHub recusou o token (401)" | O token está incorreto, expirou, foi revogado ou foi copiado de forma incompleta. | Crie um novo token com Issues → Leitura e gravação e salve-o novamente. |
| HTTP 403 | O token não tem a permissão Issues, o repositório não foi selecionado para ele ou o limite de requisições foi atingido. | Edite o token: defina Issues como Leitura e gravação e selecione o repositório. Se o problema for o limite de requisições, aguarde alguns minutos. |
| HTTP 404 | O repositório não existe, foi renomeado ou o token não tem acesso a ele (repositórios privados precisam ser selecionados em um token com permissões granulares). | Selecione o repositório na lista ou adicione-o ao acesso a repositórios do token. |
| HTTP 422 | O GitHub rejeitou um campo da issue, geralmente um responsável que não é colaborador, ou um título ou etiqueta que o GitHub não aceita. | Remova o responsável em Configurações → Integrações → Chamados ou adicione essa pessoa como colaboradora. |
| "<repo> está com Issues desativado" | O recurso Issues está desativado no repositório. | Ative Configurações → Recursos → Issues no repositório ou escolha outro. |
| "não foi possível acessar o GitHub (…)" ou "não respondeu a tempo" | Este computador não consegue acessar api.github.com: uma VPN ou um proxy, ou falta de conexão de rede. | Abra github.com em um navegador no mesmo computador e tente verificar novamente. |
| Tudo está certo na verificação, mas nenhuma issue aparece | GITHUB_ISSUES_ENABLED está definido como false; ou o resultado foi FLAKY ou um resultado de ambiente; ou foi uma execução em ambiente isolado; ou o teste já tem uma issue aberta (uma falha repetida adiciona um comentário). | Ative GITHUB_ISSUES_ENABLED e use Criar chamado de teste para confirmar a conexão. |
Chaves de configuração
| Chave | O que faz | Valor válido | Como verificar |
|---|---|---|---|
GITHUB_ISSUES_ENABLED | Criar problemas no GitHub para falhas | true ou false | Ative depois que Verificar conexão indicar sucesso e execute Criar chamado de teste. |
GITHUB_ISSUES_TOKEN | Token de acesso do GitHub (secreto, salvo apenas neste computador) | Uma linha, sem aspas, sem espaços | Verifique a conexão: "token recusado" significa que ele está incorreto, expirou ou foi revogado. |
GITHUB_ISSUES_REPO | Repositório do GitHub para problemas | owner/repo, como acme/web | Selecione na lista; o Studio só salva um repositório que o token permite acessar e que tenha Issues ativado. |
Mais: todas as integrações, o guia de Configurações, solução de problemas. Outros guias: Jira Cloud, Azure Boards, Slack, Microsoft Teams, Telegram.
Ainda com dificuldades? Escreva para [email protected] com a linha exata do erro exibido pelo Studio. Não inclua nenhum token.