====== Eigen gitlab runners maken ======

Om GitLab CI/CD pipelines te kunnen gebruiken heb je "Runners" nodig.

Je zou gebruik kunnen maken van shared runners die je op het internet kan vinden maar in veel situaties is het over het internet versturen van sourcecode niet een wenselijke situatie. 

In dat geval is een lokale "eigen" runner de oplossing.

===== repository koppelen =====
Om makkelijk te kunnen updaten is het verstandig de software vanuit een officele repository te installeren. Koppel de repository van gitlab:

''%%curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.rpm.sh" | sudo bash%%''

===== runner software installeren =====

en installeer de runner:

''sudo yum install gitlab-runner''
===== runner registreren bij de GitLab server =====

==== registration token achterhalen ====

Log in op de GitLab server en in het grijze zij-menu kies **Settings → CI/CD**.
Bij **Runners** druk rechts op de knop **Expand**
{{:werkinstructies:gitlab-runners1.png?700|}}

Daar vindt je de URL en de token waarmee je de net geïnstalleerde runner aan je GitLab server kunt koppelen.
{{:werkinstructies:gitlab-runners2.png?300|}}

de URL kan je wel onthouden, druk op het "copy" logotje naast het token.

registreer de runner vervolgens op de server waar je deze hebt geregistreerd door:

''sudo gitlab-runner register''

en vul de gegevens in wanneer gevraagd:
<code>
Runtime platform                                    arch=amd64 os=linux pid=598553 revision=5316d4ac version=14.6.0
Running in system-mode.

Enter the GitLab instance URL (for example, https://gitlab.com/):
http://git.auriel.nl
Enter the registration token:
wr5j_9y23dCPUDoKTvQ4
Enter a description for the runner:
[test-hwnode1.auriel.local]: test-hwnode1
Enter tags for the runner (comma-separated):
packer-build
Registering runner... succeeded                     runner=wr5j_9y2
Enter an executor: virtualbox, docker+machine, docker-ssh+machine, kubernetes, custom, docker, parallels, docker-ssh, shell, ssh:
docker
Enter the default Docker image (for example, ruby:2.6):
ruby:2.6
Runner registered successfully. Feel free to start it, but if it's running already the config should be automatically reloaded!
</code>

en start de runner:

''
AI dat werkt niet


===== Bronnen =====

https://docs.gitlab.com/runner/install/linux-repository.html

https://docs.gitlab.com/runner/register/