Skip to Content

Deployments en releases

Koppel je bestaande deployment-pipeline, deploy vanuit CodeLynq en deploy automatisch zodra een pull request van CodeLynq is gemerged.

CodeLynq vervangt je deployment-pipeline niet - het start de pipeline die je al hebt. Je legt vast waar en hoe een project wordt gedeployd (een deploy-doel), en daarna kan CodeLynq een deployment starten op verzoek of automatisch na een merge. Elke deployment wordt vastgelegd als release, zodat je ziet wat waar is uitgerold.

Deploy-doelen instellen en deployen is voor beheerders van de organisatie en de eigenaar van het project. Iedereen in de organisatie kan de releases zien.

Een deploy-doel toevoegen

  1. Open het project, ga naar Instellingen en kies Deployments (onder Beheer).
  2. Klik onder Deploy-doelen op Doel toevoegen.
  3. Vul in:
    • Omgeving: een naam als production of staging.
    • Methode: hoe CodeLynq de deployment start (zie hieronder).
    • Repository: Elke repository, of de ene repository die dit doel uitrolt.
    • Automatisch deployen wanneer een PR van CodeLynq is gemerged: vink dit aan voor automatische deployments.
  4. Klik op Doel toevoegen.

Elk doel verschijnt als kaart, met labels als Automatisch deployen en Secret ingesteld, en de knoppen Bewerken en Verwijderen.

Methode: GitHub Actions-workflow

CodeLynq start een workflow in je GitHub-repository.

  • Workflowbestand: de bestandsnaam van de workflow in .github/workflows, bijvoorbeeld deploy.yml.
  • Ref (optioneel): de branch of tag waarop de workflow draait. Zonder ref wordt de standaardbranch van de repository gebruikt.

De workflow moet handmatig te starten zijn, dus hij heeft een workflow_dispatch-trigger nodig. CodeLynq geeft de te deployen commit mee als input commit_sha (leeg betekent de laatste commit), dus neem die input op in de trigger:

on:
  workflow_dispatch:
    inputs:
      commit_sha:
        required: false

Methode: Deploy-webhook

CodeLynq stuurt een POST-verzoek met een JSON-body naar een URL van je eigen deploymenttool.

  • Webhook-URL: het adres dat wordt aangeroepen.
  • Secret (optioneel): hiermee controleert je tool dat een verzoek van CodeLynq komt. Na het opslaan wordt het nooit meer getoond. Elk verzoek bevat dan:
    • X-CodeLynq-Signature: sha256=: een HMAC-SHA256 met het secret als sleutel, over de waarde van X-CodeLynq-Timestamp, een punt en de ruwe body van het verzoek. Bereken hem na en vergelijk; weiger verzoeken met een tijdstempel van meer dan een paar minuten oud.
    • Authorization: Bearer , voor tools die alleen een token kunnen vergelijken.

De body bevat het project, de omgeving, de te deployen commit en de ref.

Nu deployen

  1. Klik onder Releases op Nu deployen (beschikbaar zodra er een doel is).
  2. Kies het Doel.
  3. Vul eventueel een Commit-SHA in (leeg betekent de laatste commit) en een Ref.
  4. Klik op Deployen.

Automatisch deployen na een merge

Staat Automatisch deployen wanneer een PR van CodeLynq is gemerged aan, dan deployt een doel elke keer dat een pull request die CodeLynq heeft geopend wordt gemerged. Pull requests van anderen starten nooit een deployment.

  • Een doel dat op één repository is ingesteld, deployt alleen merges in die repository.
  • Bij een merge in een andere branch dan de standaardbranch - een versie- of releasebranch - deployen alleen doelen waarvan de Ref die branch is, of die geen ref hebben. Zie Op meerdere branches tegelijk werken.
  • CodeLynq hoort van merges via de CI-webhook van de repository (GitHub, GitLab of Bitbucket). Stel die in op de repository met de events die daar staan - zie Repositories.

Releases volgen

De lijst Releases bij het project toont elke deployment met de omgeving, status (In afwachting, Bezig, Geslaagd, Mislukt of Onbekend), commit en datum, met een link Bekijken. De pagina Deployments in de zijbalk toont de releases van alle projecten, elk met een link Log.

Bij de methode GitHub Actions volgt de status je workflow: is de workflow-run klaar, dan wordt de release geslaagd of mislukt. Ook dat komt binnen via de CI-webhook van de repository.

Een mislukte deployment verschijnt in de inbox als Deployment mislukt.

Zie ook

  • Hosting: laat CodeLynq de applicatie voor je draaien. Een gehoste omgeving krijgt een eigen deploy-doel.
  • Externe AI-assistenten kunnen ook releases opvragen en een deployment starten.

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.