Skip to Content

Een repository koppelen

Koppel een GitHub-, GitLab- of Bitbucket-repository aan een project, stel de standaardbranch in, controleer de verbinding en stel de CI-webhook in.

Een run heeft een repository nodig om in te werken: hij leest daar de code, pusht een branch en opent een pull request. Een project kan meerdere repositories hebben, bijvoorbeeld een backend en een frontend; een taak kan dan op één, een paar of alle repositories werken.

Om repositories te koppelen, te wijzigen of te verwijderen moet je beheerder van de organisatie of eigenaar van het project zijn.

Een repository koppelen

Open het project, ga naar Instellingen → Repositories en klik op Repository koppelen.

  1. Kies je Git-provider: GitHub, GitLab of Bitbucket.
  2. Koppel op een van twee manieren:
    • Via je account (aanbevolen). Klik op Autoriseren met GitHub (of GitLab, Bitbucket). Je gaat naar je git-host om toegang te geven en komt daarna terug. Kies de repository bij Kies een repository; privérepositories zijn gemarkeerd met Privé.
    • Via een token. Klik op Liever een persoonlijk toegangstoken gebruiken. Vul de Repository-URL in (het HTTPS-adres) en, voor een privérepository, een Persoonlijk toegangstoken. De wizard laat zien hoe je bij jouw provider een token aanmaakt. Het token wordt versleuteld opgeslagen en nooit meer getoond. Een openbare repository heeft geen token nodig.
  3. Branch: vul de Standaardbranch in (meestal main). Staat het project in een map van de repository in plaats van in de root, vul dan Submap (optioneel) in, bijvoorbeeld backend/.
  4. Kijk alles na bij Controleer je instellingen en klik op Repository koppelen.

Het token moet code kunnen lezen en pushen en pull requests kunnen openen: de scope repo op GitHub, de scope api op GitLab, of een app password met lees- en schrijftoegang tot repositories op Bitbucket.

De repositorykaart

Elke gekoppelde repository toont de provider, de URL en de standaardbranch, met deze acties:

  • Standaardbranch - klik op Wijzigen om een andere branch in te stellen. Daarna wordt de verbinding opnieuw gecontroleerd. Taken werken op de standaardbranch, tenzij je andere branches kiest.
  • Verbinding controleren - controleert of CodeLynq de repository kan bereiken, lezen en ernaar kan pushen, en toont de uitkomst van elke controle. Wijkt de standaardbranch van de repository zelf af van wat hier staat, dan wissel je met één klik (de branchnaam gevolgd door gebruiken).
  • Gekoppeld account gebruiken - zet een repository die met een token is gekoppeld over op je geautoriseerde account.
  • Verwijderen - CodeLynq werkt niet meer met deze repository. Er wordt niets verwijderd in je git-host, en er worden geen taken verwijderd.
  • Maintained branches - voor repositories met één branch per versie of release. Zie Maintained branches.
  • CI-webhook - zie hieronder.

De CI-webhook instellen

Via de CI-webhook laat je git-host aan CodeLynq weten wanneer CI faalt, wanneer een reviewer om wijzigingen vraagt en wanneer een pull request gemerged is. Je hebt hem nodig voor Automatisch doorwerken tot alles groen is, voor automatische deployments na een merge, en om taken vanzelf op Klaar te zetten zodra hun pull requests gemerged zijn. Hij werkt voor GitHub, GitLab en Bitbucket.

  1. Kopieer op de repositorykaart, onder CI-webhook, de Webhook-URL. Die hoort bij de git-host van de repository.
  2. Bedenk een lang, willekeurig secret, vul het in bij Webhook-secret en klik op Opslaan. Het label verandert van Niet ingesteld in Ingesteld.
  3. Voeg de webhook toe in je git-host:
    • GitHub: Settings van de repository → Webhooks → webhook toevoegen. Payload URL: de webhook-URL. Content type: application/json. Secret: hetzelfde secret. Events: kies de losse events Check runs, Check suites, Workflow runs, Pull request reviews en Pull requests.
    • GitLab: Settings van het project → Webhooks → webhook toevoegen. URL: de webhook-URL. Secret token: hetzelfde secret. Trigger: Merge request events en Pipeline events.
    • Bitbucket: Repository settings → Webhooks → webhook toevoegen. URL: de webhook-URL. Secret: hetzelfde secret. Triggers: onder Pull request Merged en Changes request created, onder Repository Build status updated.
  4. Sla de webhook op.

Wil je de webhook niet meer gebruiken, klik dan naast het secret op Wissen.

Als iets niet werkt

  • De verbindingscontrole faalt bij pushen. Het token of account kan lezen maar niet schrijven. Maak een token met schrijfrechten en koppel opnieuw, of klik op Gekoppeld account gebruiken.
  • Runs mislukken meteen bij de start. Klik eerst op Verbinding controleren. Je ziet dan welk onderdeel faalt - bijvoorbeeld een verlopen token, of een standaardbranch die niet meer bestaat.
  • Een repository staat na het autoriseren niet in de lijst. Controleer of het account dat je hebt geautoriseerd er toegang toe heeft, of koppel hem met een token.

Zie ook

Test het op een taak uit je eigen backlog

Stuur ons één echte taak. Wij draaien CodeLynq op jouw repository en jij reviewt de pull request. Gratis, binnen 5 werkdagen nadat je de spec hebt goedgekeurd.