Allgemeine Informationen
| Anleitung | |
|---|---|
| Informationen | |
| Betriebssystem | Alle |
| Service | Cloudcomputing |
| Interessant für | Angestellte, Studierende und Gäste |
| HilfeWiki des ZIM der Uni Paderborn | |
 | This article is a stub. You can help us by expanding it. |
In dieser Anleitung erfahren Sie, wie Sie einen GitLab Runner auf einer Instanz des Cloudcomputing-Dienstes der Universität erstellen.
Ist ein eigener Runner notwendig?[Bearbeiten | Quelltext bearbeiten]
Das ZIM stellt im GitLab einen eigenen instanzweiten Runner zur Verfügung. Diesen können Sie einfach nutzen, wenn auch ohne Garantie, dass dieser immer zur Verfügung steht. Nur wenn Sie erhöhte Anforderungen haben sollten Sie sich selber einen GitLab Runner aufsetzen.
Was ist zu tun?[Bearbeiten | Quelltext bearbeiten]
- eine Ubuntu Instanz erstellen
- GitLab Runner installieren
- GitLab Runner registrieren
Erstellen einer Ubuntu Instanz[Bearbeiten | Quelltext bearbeiten]
Zunächst benötigen Sie eine Instanz, auf welcher Sie den GitLab Runner bereitstellen können - für dieses Tutorial verwenden wir Ubuntu 20.04. An dieser Stelle werden wir nur eine sehr kurze Anleitung zur Erstellung einer Instanz geben - eine ausführlichere Anleitung finden Sie im Bereich QuickStartGuide.
Vorraussetzung ist ein vorhandnes Schlüsselpaar! Falls Sie noch kein Schlüsselpaar angelegt haben, finden Sie hier eine Anleitung, wie Sie ein Schlüsselpaar erstellen.
1. Erstellen Sie einen Datenträger unter Datenträger/Datenträger mit den folgenden Einstellungen:
2. Legen Sie unter Netzwerk/Sicherheitsgruppen eine neue Sicherheitsgruppe an mit dem Namen GitLab Runner an. Erstellen Sie zunächst eine neue Sicherheitsregel für den Port des SSH-Dienstes - hier bietet OpenStack bereits eine Standardregel. GitLab Runner kommunizieren über HTTPS mit dem GitLab Server - auch hier bietet OpenStack bereits eine Standardregel.
Soll der Dienst auch über IPv6 erreichbar sein, erstellen Sie eine weitere Regel mit den selben Parameter - ausser CIDR, dort geben Sie ::/0 an.
Beachten Sie bitte, falls Sie über den GitLab Runner einen Dienst bereitstellen wollen, dass Sie auch die Ports für diesen Dienst freigeben, um ihn später zu erreichen.
3. Erstellen Sie eine neue Instanz unter Compute/Instanzen über den Button Instanz starten. Vergeben Sie den Namen Ubuntu-20.04-GitLab-Runner. Als Quelle wählen Sie den zuvor erstellen Datenträger aus.
Die Wahl der Variante hängt von Ihren Anforderungen ab - für dieses Tutorial wählen wir small aus.
Falls Sie bereits ein Netzwerk angelegt haben, können Sie die Instanz diesem zuordnen. Unter Sicherheitsgruppen ordnen Sie die zuvor erstellte Sicherheitsgruppe der Instanz zu. Ihr Schlüsselpaar sollte automatisch zur Instanz hinzugefügt worden sein. Klicken Sie anschließend auf Instanz starten.
4. Im Kontextmenü der Instanz können Sie dieser eine Floating IP zuweisen, damit diese von Aussen erreichbar ist.
Installieren eines GitLab Runners[Bearbeiten | Quelltext bearbeiten]
Loggen Sie sich auf der erstellten Instanz per SSH ein. Um den GitLab Runner installieren zu können, müssen Sie zunächst die Packetquelle zu ihrem System hinzufügen:
curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bashDanach starten Sie die Installation mit:
export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E apt-get install gitlab-runnerRegistrierung eines GitLab Runners[Bearbeiten | Quelltext bearbeiten]
Nach der Installation muss der GitLab Runner noch registriert werden - dieser Prozess wird im GitLab Wiki beschrieben.
