Sommige repositories houden meerdere lijnen van dezelfde code naast elkaar bij: één branch per ondersteunde productversie, releasebranches of een langlopende fork. Een taak kan de branches noemen waarop hij van toepassing is. Eén run werkt dan op allemaal en opent één pull request per branch, elk naar zijn eigen branch.
Zonder branches werkt een taak op de standaardbranch van de repository, zoals voorheen.
Twee veelvoorkomende toepassingen
Dezelfde fix op meerdere versies. Kies de branches waarop de fix hoort, bijvoorbeeld 16.0, 17.0 en 18.0. De branches worden naast elkaar uitgecheckt en de wijziging wordt op elk ervan doorgevoerd, aangepast aan wat die branch bevat - versies verschillen vaak in API's, afhankelijkheden of bestandsindeling. Een branch die uiteindelijk geen wijziging nodig heeft, krijgt geen pull request.
Een upgrade naar een nieuwe versie. Voeg een nieuwe branch toe, bijvoorbeeld 20.0 aangemaakt vanaf 19.0. CodeLynq maakt 20.0 eerst aan als exacte kopie van 19.0. De upgrade zelf - versienummers, afhankelijkheden, codewijzigingen, migratiestappen - komt daarna als pull request naar 20.0, zodat je hem beoordeelt voordat hij erin gaat. Bestaat 20.0 al, dan wordt die gebruikt zoals hij is en nooit overschreven.
Branches kiezen bij het aanmaken van een taak
In het taakformulier (Taken → Nieuwe taak, of Meer opties in het snelle taakformulier van een project): kies het project. Klik onder Branches op Branches kiezen naast een repository.
- Klik op branches om ze te selecteren. Maintained branches staan bovenaan; Alle maintained selecteert ze allemaal. Overige branches toont de rest.
- Om een nieuwe lijn te starten typ je de naam bij Nieuwe branch, kies je bij van welke branch gekopieerd wordt en klik je op Toevoegen.
- Standaardbranch gebruiken maakt de selectie leeg.
In de nieuwe-taak-chat: zeg het gewoon - "los de afrondingsfout op in 16.0 en 17.0", "upgrade de module en maak de branch 20.0 aan". De chat kent de branches van de repository, vraagt het als niet duidelijk is welke je bedoelt, en toont ze in het voorstel voordat je de taak aanmaakt.
Branches van een bestaande taak wijzigen
Open de taak. Klik naast Branches op Bewerken, pas de selectie aan en klik op Opslaan. De wijziging geldt voor de volgende run. Zolang er een run met de taak bezig is, kun je niet bewerken.
De resultaten volgen
De runpagina toont elke pull request met de branch waar hij naartoe gaat (bijvoorbeeld → 17.0). Beoordeel en merge ze zoals gewoonlijk in je git-host. Gebruik je de CI-feedbacklus, dan wordt elke pull request op zijn eigen branch opgevolgd.
Goed om te weten
- Aparte taken voor "dezelfde fix op meerdere versies" en "upgrade naar een nieuwe versie" zijn makkelijker te beoordelen dan één taak die beide doet.
- Zet wat specifiek is voor jullie opzet in de taak of in de projectcontext, bijvoorbeeld waar het versienummer staat. Dat maakt het resultaat betrouwbaarder.
- Bij een merge naar een andere branch dan de standaardbranch draaien automatische deployments alleen voor deploy targets die op die branch staan, of op geen enkele branch.
- Self-hosted runners hebben versie 1.4.0 of nieuwer nodig voor taken met meerdere branches.