Als je GitHub koppelt, kan FixControl een Pull Request openen met de patch van een agent nadat die patch is goedgekeurd (de Run fix → verifiëren → goedkeuren → PR-flow). FixControl pusht nooit naar je standaardbranch en merget nooit: in de Pull Request nemen je eigen review en CI het over.
Voordat je begint
- Je bent admin van je FixControl-organisatie.
- Je mag GitHub Apps installeren op het GitHub-account of de organisatie die eigenaar is van de repositories (of een GitHub-eigenaar keurt de installatie voor je goed).
- Je weet welke repositories FixControl mag bereiken.
GitHub koppelen
- Open Instellingen → Kanalen → Code- & patch-levering → GitHub.
- Klik op GitHub koppelen. Je krijgt drie opties.
- Kies er één en volg de stappen hieronder.
| Installeren op GitHub | Device-code | Personal Access Token | |
|---|---|---|---|
| Aanbevolen voor | Bijna iedereen | Headless-installaties, of als je in deze browser niet bij FixControl kunt inloggen | Als de andere twee niet lukken |
| PR-attributie | De FixControl-bot | Jouw GitHub-gebruiker | Jouw GitHub-gebruiker |
| Levensduur token | Kortlevend, automatisch geroteerd | Tot je hem op GitHub intrekt | Tot je hem intrekt |
| Toegang tot repositories | Alleen de repositories die je selecteert | Alles wat jouw GitHub-gebruiker kan bereiken | Alles wat het token kan bereiken |
Optie 1: Installeren op GitHub (aanbevolen)
- Kies Installeren op GitHub en klik op Doorgaan op GitHub.
- Kies op GitHub het account of de organisatie en selecteer de repositories die FixControl mag benaderen.
- Bevestig. Je komt terug in FixControl en de verbinding staat op gekoppeld.
De GitHub App van FixControl wordt door FixControl geregistreerd en beheerd. Je maakt zelf geen app, private key of webhook-geheim aan.
Optie 2: Gebruik een device-code
- Kies Gebruik een device-code en klik op Device-code aanvragen.
- Open de GitHub-link op het scherm, plak de Gebruikerscode en keur goed.
- De FixControl-pagina pikt de goedkeuring automatisch op.
Optie 3: Personal Access Token (geavanceerd)
- Maak op GitHub een classic token aan met de scopes
repo,workflowenread:user. - Kies Geavanceerd: plak een Personal Access Token, plak het token, vul eventueel je GitHub-gebruikersnaam in en klik op Token opslaan.
Pull Requests verschijnen dan onder het account dat eigenaar is van het token. Vertrekt die persoon of verloopt het token, dan stopt de levering tot iemand opnieuw koppelt.
Een repository aan een project koppelen
Een verbinding alleen vertelt FixControl niet waar de code van een project staat. Voeg de repository toe als codebase van het project (zie Codebases), zodat agents hem kunnen lezen en patches weten waar ze heen moeten.
Hoe levering werkt
- Een Pull Request gaat pas open nadat de patch is goedgekeurd. Standaard is het toepassen van een goedgekeurde patch een aparte, bewuste klik.
- Automatische levering is een keuze per project en staat standaard uit. Open in het project Verbindingen, bewerk de GitHub-verbinding, open Meer opties en zet Code automatisch leveren — open een PR op deze repo na patch-goedkeuring aan. Daarvoor moet de repository als GitHub-codebase zijn gekoppeld.
- FixControl merget nooit. Het opent de Pull Request op een nieuwe branch; mergen is de beslissing van je team.
- De status gemerged of gesloten komt terug in FixControl via de Pull Request-events van GitHub, die de GitHub App van FixControl ontvangt. Lijkt die status verouderd, open dan de patch en klik op Controleren: FixControl vraagt GitHub wat de echte status van de Pull Request is.
Als er iets misgaat
| Wat je ziet | Wat je doet |
|---|---|
| De verbinding toont Herverbinden vereist | De installatie is verwijderd of een token is ingetrokken. Koppel opnieuw via Instellingen → Kanalen → Code- & patch-levering → GitHub. |
| Een patch kan voor één repository geen Pull Request openen | Die repository is waarschijnlijk niet geselecteerd in de installatie van de GitHub App. Voeg hem op GitHub toe bij de repository-toegang van de app en probeer opnieuw. |
| Een Pull Request is gemerged maar FixControl toont hem nog als open | Klik op Controleren bij de patch. |
FAQ
Kan ik meer dan één optie tegelijk gebruiken? Ja. FixControl gebruikt eerst de App-installatie, dan een device-code-verbinding, dan een Personal Access Token. Sommige acties, zoals het beantwoorden van een GitHub-environment-review voor een deploymentgate, hebben een credential van een persoon nodig; een bot-installatie kan niet als reviewer optreden.
Welke repositories kan FixControl raken? Met de App: alleen de repositories die je tijdens de installatie hebt geselecteerd. Met een device-code of token: alles wat die GitHub-gebruiker of dat token kan bereiken. FixControl schrijft alleen naar repositories die als codebase zijn gekoppeld.
Kan ik het webhook-geheim roteren? Nee. Het webhook-geheim hoort bij de GitHub App van FixControl en wordt door FixControl beheerd. Er is voor jou niets te roteren.
Worden tokens gelogd? Nee. Credentials worden versleuteld opgeslagen. Audit-events leggen de installatie en de GitHub-gebruikersnaam vast, nooit tokens.
Gerelateerd: Git-providers (GitLab, Bitbucket) · Codebases · Levering