Cloudcomputing Kurzanleitung - GitLab Runner: Unterschied zwischen den Versionen

ZIM HilfeWiki - das Wiki

Aktuelle Version vom 17. Mai 2024, 13:38 Uhr

Cloudcomputing

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.

Dieser Artikel erfordert grundlegende Erfahrung im Umgang mit Linux.

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 bash

Danach starten Sie die Installation mit:

export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E apt-get install gitlab-runner

Registrierung eines GitLab Runners[Bearbeiten | Quelltext bearbeiten]

Nach der Installation muss der GitLab Runner noch registriert werden - dieser Prozess wird im GitLab Wiki beschrieben.

Bei Fragen oder Problemen wenden Sie sich bitte telefonisch oder per E-Mail an uns:

Tel. IT: +49 (5251) 60-5544 • Tel. Medien: +49 (5251) 60-2821 • E-Mail: zim@uni-paderborn.de

Das Notebook-Café ist die Benutzerberatung des ZIM - Sie finden uns in Raum I0.401

Wir sind zu folgenden Zeiten erreichbar:

	Mo-Do	Fr
Vor-Ort-Support	08:30 - 16:00	08:30 - 14:00
Telefonsupport	08:30 - 16:00	08:30 - 14:00

Das ZIM:Servicecenter Medien auf H1 hat aktuell zu folgenden Zeiten geöffnet:

Mo-Do	Fr
08:00 - 16:00	08:00 - 14:30

Abgerufen von „https://hilfe.uni-paderborn.de/index.php?title=Cloudcomputing_Kurzanleitung_-_GitLab_Runner&oldid=34657“

@@ Zeile 8: / Zeile 8: @@
 |marker=Stub
 }}
-Kurzer Einleitungstext
+In dieser Anleitung erfahren Sie, wie Sie einen GitLab Runner auf einer Instanz des Cloudcomputing-Dienstes der Universität erstellen.
+<bootstrap_alert color=info>Dieser Artikel erfordert grundlegende Erfahrung im Umgang mit Linux.
+</bootstrap_alert>
+== Ist ein eigener Runner notwendig? ==
+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? ==
-* Stichpunktartige Auflistung
+* eine Ubuntu Instanz erstellen
-* aller Arbeitsschritte
+* GitLab Runner installieren
+* GitLab Runner registrieren
+== Erstellen einer Ubuntu Instanz ==
+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 [https://hilfe.uni-paderborn.de/Cloudcomputing_Quick-Start QuickStartGuide].
+'''Vorraussetzung ist ein vorhandnes Schlüsselpaar!''' Falls Sie noch kein Schlüsselpaar angelegt haben, finden Sie [https://hilfe.uni-paderborn.de/Cloudcomputing_Quick-Start#Schl.C3.BCsselpaare hier] eine Anleitung, wie Sie ein Schlüsselpaar erstellen.
+. Erstellen Sie einen Datenträger unter ''Datenträger/Datenträger'' mit den folgenden Einstellungen:
+[[Datei:Screenshot_OpenStack_Datentraeger_GitLab_Runner.png |mini|200px|none| Datenträger erstellen]]
+. 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 <code>::/0</code> 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.
-== Schritt-für-Schritt Anleitung ==
+. Erstellen Sie eine neue Instanz unter ''Compute/Instanzen'' über den Button ''Instanz starten''. Vergeben Sie den Namen <code>Ubuntu-20.04-GitLab-Runner</code>. Als Quelle wählen Sie den zuvor erstellen Datenträger aus.
-Jeder Arbeitschritt wird hier genau erklärt und ggf. mit Screenshots hinterlegt.
-=== Dabei sollten ===
+Die Wahl der ''Variante'' hängt von Ihren Anforderungen ab - für dieses Tutorial wählen wir <code>small</code> aus.
-Unterschritte
+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''.
-=== in sinnvolle Abschnitte ===
+. Im Kontextmenü der Instanz können Sie dieser eine Floating IP zuweisen, damit diese von Aussen erreichbar ist.
-unterteilt werden
-=== dazu nutzt man dann ===
+== Installieren eines GitLab Runners ==
-Überschriften dritter Ordnung
+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:
+<source>curl -L "https://packages.gitlab.com/install/repositories/runner/gitlab-runner/script.deb.sh" | sudo bash</source>
-=== Nebenbei ===
+Danach starten Sie die Installation mit:
-* Hier nochmal der Hinweis auf den Menüpunkt "Mitmachen" links im Hauptmenü, hinter dem sich wertvolle Anleitungen und Hinweise verstecken.
+<source>export GITLAB_RUNNER_DISABLE_SKEL=true; sudo -E apt-get install gitlab-runner</source>
-* Erfahrene Redakteure finden unterhalb der "Kategorie:Utility templates" interessantes Handwerkszeug für fortgeschrittene Textmanipulationen.
-== Siehe auch ==
+== Registrierung eines GitLab Runners ==
-Weitere interessante Artikel zum gleichen Themenfeld verlinken
+Nach der Installation muss der GitLab Runner noch registriert werden - dieser Prozess wird im [https://hilfe.uni-paderborn.de/GitLab#Runner GitLab Wiki] beschrieben.