Self-hosted runners voor on-premises

Welkom in de wereld van zelfgehoste runners. Dit zijn krachtige tools waarmee je GitHub Actions-workflows op je eigen machines kunt uitvoeren.

In plaats van de cloudgebaseerde runners van GitHub te gebruiken, kun je je eigen hardware, besturingssysteem en netwerkomgeving inzetten om je CI/CD-taken uit te voeren.

Hoewel door GitHub gehoste runners handig zijn, bieden zelfgehoste runners unieke voordelen:

• Specifieke hardware: Gebruik aangepaste hardware, zoals GPU's of specifieke CPU-architecturen.
• Netwerktoegang: Maak rechtstreeks verbinding met privénetwerken en bronnen (databases, interne diensten).
• Beveiliging: Houd gevoelige buildomgevingen binnen je eigen beheerde infrastructuur.
• Optimalisatie van kosten: Verlaag mogelijk de kosten bij intensief gebruik door bestaande infrastructuur te benutten.

Om een zelfgehoste runner in te stellen, moet je machine aan een aantal basisvereisten voldoen:

• Besturingssysteem: Linux, Windows of macOS wordt ondersteund.
• Netwerktoegang: De runnermachine moet kunnen communiceren met GitHub.com (of GitHub Enterprise Server).
• Hulpbronnen: Voldoende CPU, RAM en schijfruimte om je workflow-taken uit te voeren.
• Software: Alle hulpprogramma's of SDK's die je workflows nodig hebben, moeten op de runner zijn geïnstalleerd.

Het instellen van een zelfgehoste runner bestaat uit een aantal belangrijke stappen. Je maakt je machine hiermee klaar om een speciale werker voor je GitHub Actions te worden:

1. Genereer een uniek registratietoken vanuit GitHub.
2. Download en pak de runner-toepassing uit op je machine.
3. Configureer de runner met de URL van je GitHub-opslagplaats of organisatie en het token.
4. Start de runner-toepassing zodat deze op taken kan wachten.

Allereerst moet je GitHub laten weten dat je een nieuwe runner instelt. Hiervoor heb je een uniek token nodig.

Ga naar de instellingen van je opslagplaats of organisatie op GitHub.com:

• Voor een opslagplaats: Settings > Actions > Runners > New self-hosted runner
• Voor een organisatie: Settings > Actions > Runners > New self-hosted runner

Volg de aanwijzingen om een token te genereren. Dit token wordt alleen voor de registratie gebruikt.

Download vervolgens de runner-toepassing naar de gekozen machine. De GitHub-interface geeft specifieke opdrachten voor je besturingssysteem.

Op een Linux-machine kun je bijvoorbeeld het volgende gebruiken:

Na het uitpakken configureer je de runner. Hiermee koppel je deze aan je GitHub-opslagplaats of organisatie en kun je labels instellen.

Voer het script config.sh (Linux/macOS) of config.cmd (Windows) uit. Je geeft de GitHub-URL en het eerder gegenereerde token op.

Nadat de runner is geconfigureerd, kun je de runner-toepassing starten. Deze maakt vervolgens verbinding met GitHub en wacht op taken.

Voer eenvoudig ./run.sh (Linux/macOS) of run.cmd (Windows) uit. Voor productieomgevingen wordt aangeraden de runner als service te installeren, zodat deze automatisch wordt gestart.

Als je je zelfgehoste runner wilt gebruiken, geef je deze op in je workflow-YAML-bestand met het trefwoord runs-on. Je kunt self-hosted gebruiken of specifieke labels die je tijdens de configuratie hebt toegewezen.

Je hebt geleerd wat zelfgehoste runners zijn! Hiermee kun je GitHub Actions-workflows uitvoeren op je eigen infrastructuur, met controle over hardware, netwerktoegang en beveiliging.

We hebben het instelproces behandeld: een token genereren, de app downloaden, de runner configureren en starten. Je hebt ook gezien hoe je in je workflow-YAML-bestanden aangepaste runners selecteert met runs-on.