GitHub Issues koppelen: stapsgewijze handleiding
Opent één GitHub-issue per mislukte test, plaatst een reactie wanneer de test opnieuw mislukt en sluit het issue wanneer de test zonder problemen slaagt. GitHub accepteert geen bestandsuploads, dus het issue vermeldt de map met bewijsmateriaal in plaats van de schermafbeelding bij te voegen. Deze handleiding helpt je van nul naar een gecontroleerde verbinding en beschrijft mogelijke fouten met hun oorzaak en oplossing.
Laatst bijgewerkt:
Houd je toegangsgegevens privé. Plak nooit een token, sleutel, wachtwoord of webhook-URL in een chat. Voer deze alleen in via Studio → Instellingen → Integraties, waar ze worden opgeslagen in het .env-bestand van je werkruimte en als stippen worden weergegeven. Hetzelfde geldt voor een AI-assistent: die kan je door deze handleiding leiden, maar heeft je token nooit nodig.
Wat je nodig hebt
- Een GitHub-account dat issues in de repository kan openen (een medewerker of de eigenaar).
- Een repository waarin Issues is ingeschakeld (repository-instellingen → Functies → Issues).
- Een fijnmazig persoonlijk toegangstoken met Issues → Lezen en schrijven voor die repository, of een klassiek token met het bereik repo.
De toegangsgegevens verkrijgen
- Open https://github.com/settings/personal-access-tokens/new (een fijnmazig token).
- Geef het een naam, stel een vervaldatum in en kies onder Repositorytoegang de optie Alleen geselecteerde repository's. Selecteer vervolgens de repository die de issues moet ontvangen.
- Stel onder Machtigingen → Repositorymachtigingen Issues in op Lezen en schrijven. Verder is niets nodig.
- Genereer het token en kopieer het meteen. GitHub toont het maar één keer. Plak het nergens anders dan in de Studio (volgende stap).
Koppelen in de Studio
- Open in de Studio Instellingen → Integraties → GitHub Issues koppelen.
- Voer het token in wanneer daarom wordt gevraagd en druk op Opslaan & controleren. De Studio toont van wie het token is en tot hoeveel repository's het toegang geeft.
- Selecteer de repository onder "Issues gaan naar". De lijst toont alleen repository's waartoe het token toegang heeft en waarin Issues is ingeschakeld.
- Schakel
GITHUB_ISSUES_ENABLEDin.
Controleren of het werkt
- Verbinding controleren toont "aangemeld als <you>" en "<owner/repo> accepteert issues". De controle leest alleen gegevens; er wordt nooit een issue geopend.
- Open Instellingen → Integraties → Tickets en druk bij de GitHub-bestemming op Testticket aanmaken. Er wordt één issue geopend met het label nexus-test.
- Open het op GitHub, controleer het label en sluit of verwijder het wanneer je klaar bent.
Veelvoorkomende fouten
| Wat je ziet | Oorzaak | Oplossing |
|---|---|---|
| "GitHub heeft het token geweigerd (401)" | Het token is onjuist, verlopen, ingetrokken of onvolledig gekopieerd. | Maak een nieuw token aan met Issues → Lezen en schrijven en sla het opnieuw op. |
| HTTP 403 | Het token mist de machtiging voor Issues, de repository is er niet voor geselecteerd of de aanvraaglimiet is bereikt. | Bewerk het token: stel Issues in op Lezen en schrijven en selecteer de repository. Als de aanvraaglimiet is bereikt, wacht dan een paar minuten. |
| HTTP 404 | De repository bestaat niet, heeft een andere naam gekregen of is niet toegankelijk met het token (privérepository's moeten bij een fijnmazig token geselecteerd zijn). | Selecteer de repository in de lijst of voeg deze toe aan de repositorytoegang van het token. |
| HTTP 422 | GitHub heeft een veld van het issue geweigerd, meestal een toegewezen persoon die geen medewerker is, of een titel of label dat GitHub niet accepteert. | Verwijder de toegewezen persoon onder Instellingen → Integraties → Tickets of voeg die persoon toe als medewerker. |
| "Issues is uitgeschakeld voor <repo>" | De functie Issues is uitgeschakeld voor de repository. | Schakel in de repository Instellingen → Functies → Issues in of kies een andere repository. |
| "kon GitHub niet bereiken (…)" of "antwoordde niet op tijd" | Deze pc kan api.github.com niet bereiken: een VPN of proxy, of geen netwerkverbinding. | Open github.com in een browser op dezelfde pc en voer de controle opnieuw uit. |
| Alle controles slagen, maar er verschijnt geen issue | GITHUB_ISSUES_ENABLED staat op false; of het resultaat was FLAKY of een omgevingsresultaat; of de test is in een sandbox uitgevoerd; of de test heeft al een openstaand issue (bij een herhaalde mislukking wordt in plaats daarvan een reactie geplaatst). | Schakel GITHUB_ISSUES_ENABLED in en gebruik Testticket aanmaken om te bevestigen dat de verbinding werkt. |
Instellingssleutels
| Sleutel | Wat het doet | Geldige waarde | Zo controleert u dit |
|---|---|---|---|
GITHUB_ISSUES_ENABLED | GitHub-issues aanmaken bij mislukte tests | true of false | Schakel dit in nadat Verbinding controleren is geslaagd en voer vervolgens Testticket aanmaken uit. |
GITHUB_ISSUES_TOKEN | GitHub-toegangstoken (geheim, alleen op deze computer opgeslagen) | Eén regel, geen aanhalingstekens, geen spaties | Verbinding controleren: "token geweigerd" betekent dat het onjuist, verlopen of ingetrokken is. |
GITHUB_ISSUES_REPO | GitHub-repository voor issues | owner/repo, zoals acme/web | Kies er een uit de lijst; de Studio slaat alleen een repository op waartoe het token toegang heeft en waarvoor Issues is ingeschakeld. |
Meer: alle integraties, de instellingenhandleiding, problemen oplossen. Andere handleidingen: Jira Cloud, Azure Boards, Slack, Microsoft Teams, Telegram.
Kom je er nog steeds niet uit? Mail naar [email protected] met de exacte foutregel die Studio toont. Stuur geen token mee.