Een run is CodeLynq dat het werk van een taak uitvoert: hij haalt de repository op, voert de wijziging uit de goedgekeurde specificatie door, draait je controles, beoordeelt zijn eigen werk en opent een pull request. Een taak kan meerdere runs hebben - bijvoorbeeld een nieuwe poging na een mislukking, of een nieuwe run met jouw feedback.
Een run starten
Een run kan starten zodra de specificatie van de taak is goedgekeurd. Open de taak, ga naar het tabblad Runs en klik op Nieuwe run starten. Naast de knop zie je soms een schatting van wat een run kost, op basis van eerdere runs in dit project.
Je kunt ook:
- Run starten bij goedkeuring aanvinken als je de specificatie goedkeurt (zie De specificatie (TSD) en goedkeuring),
- een run starten met je feedback (zie hieronder),
- een run starten vanuit de mobiele app of een externe AI-client.
Elk lid van het project kan een run starten. Een run start niet als de organisatie geen actief abonnement heeft, aan de limieten van het abonnement zit of door haar modeltegoed heen is; je ziet dan direct waarom. Zie Abonnement en tegoed. Heeft je organisatie uitgavenlimieten ingesteld, dan kan een dure run eerst op goedkeuring wachten - zie Dure runs goedkeuren.
Statussen
| Status | Betekenis |
|---|---|
| Wacht op goedkeuring | Tegengehouden vanwege de geschatte kosten, tot iemand hem goedkeurt. Zie Dure runs goedkeuren. |
| In de wachtrij | Wacht om te starten. |
| Loopt | Is bezig. |
| Voltooid | Klaar; bekijk de pull requests. |
| Mislukt | Gestopt met een fout; zie hieronder waarom. |
| Geannuleerd | Door iemand gestopt, of niet goedgekeurd. |
Runs die op je eigen machines draaien, krijgen het label Self-hosted runner. Zie Self-hosted runners.
Een run volgen
Kies een run op het tabblad Runs om te zien:
- Uitvoeringslogs - wat de run aan het doen is, live zolang hij loopt (Live...).
- Gewijzigde bestanden - elk aangemaakt (+) of gewijzigd (~) bestand.
- Details: Branch, Commit, Gestart, Afgerond en het gebruikte Model.
Runs in de zijbalk toont de runs van alle projecten, met taak, project, status, tijd, kosten en een link naar de pull request.
Resultaten en pull requests
Als een run voltooid is, heeft hij een pull request geopend in je git-host:
- Bij één repository: klik op Pull request #… bekijken.
- Bij meerdere repositories of branches: de lijst Repositories toont elke repository en branch, gemarkeerd als Gewijzigd of Geen wijzigingen, met een link naar elke pull request. Een repository of branch zonder wijzigingen krijgt geen pull request.
Wat is gecontroleerd toont per repository elke kwaliteitscontrole van de run: je verify-commando, de self-review, de beveiligingsscan, de architectuurregels, de documentatiestap en CI op de pull request, elk als Geslaagd, Mislukt, Niet uitgevoerd, Uitgeschakeld, Na de PR of Wacht, met het commando en de reden als iets niet draaide. Een afgeronde run betekent dat het werk klaar is en er een pull request open staat; alleen wat Geslaagd heet, is gecontroleerd. De volledige uitvoer staat onder Technische logs.
Voordat je een run start, zegt het tabblad Runs of hij kan starten: een goedgekeurde spec, een repository, je abonnement en modeltegoed, vrije capaciteit, een runner (self-hosted) en je uitgavenlimieten, met de verwachte kosten en een link om op te lossen wat ontbreekt.
Onder Feedback op de pull request zie je of de pull request Klaar om te mergen is of Conflicten heeft, de CI-checks en de Reviewopmerkingen. Klik op Vernieuwen om ze bij te werken. Beoordeel en merge zoals gewoonlijk in je git-host. Faalt CI of vraagt een reviewer om wijzigingen, zie dan De CI-feedbacklus.
Als een run mislukt
Een mislukte run legt in gewone taal uit wat er misging en wat je nu kunt doen. Staat er Het loont om deze gewoon opnieuw te proberen., dan slaagt een nieuwe poging waarschijnlijk. Technische details toont de oorspronkelijke foutmelding.
Veelvoorkomende oorzaken zijn een verificatiecommando dat blijft falen (zie Kwaliteitscontroles) en toegang tot de repository (zie Een repository koppelen).
Stoppen, opnieuw in de wachtrij, opnieuw proberen
- Run stoppen - stopt een run die in de wachtrij staat of loopt. Hij eindigt als Geannuleerd.
- Opnieuw in wachtrij - zet een run die in de wachtrij staat opnieuw in de wachtrij.
- Run opnieuw proberen - start een mislukte run opnieuw. Een nieuwe poging kan een sterker model gebruiken; bij Model zie je dan vanaf welk model er is opgeschaald.
Feedback voor de volgende run
Op het subtabblad Feedback van Runs verzamel je opmerkingen over het werk:
- Typ bij Feedback toevoegen je feedback, kies Algemene opmerking of Ontwikkelfeedback en klik op Toevoegen.
- Vink de ontwikkelfeedback aan die verwerkt moet worden.
- Klik op Run starten met feedback. De nieuwe run krijgt je feedback mee naast de specificatie.
Heeft de taak al een open pull request, dan heet de knop Verwerken als wijziging in de TSD. Zie Een wijziging aanvragen: de wijziging wordt op dezelfde branch gebouwd en er komt geen tweede pull request.
Wil je CodeLynq juist de CI-resultaten en reviewopmerkingen op een bestaande pull request laten oppakken, gebruik dan Feedback verwerken - zie De CI-feedbacklus.
Meldingen
Wil je een pushmelding als een run voltooid of mislukt is, zet dan Run voltooid of Run mislukt aan onder Beveiligingsinstellingen → Meldingen, en installeer de mobiele app. Je organisatie kan runmeldingen ook naar Slack of een webhook sturen - zie Integraties.