Administration

Ziel

In diesem Projekt geht es um Gitlab Runner. Sie sollen:

• Einen Runner starten
• Den Runner registrieren
• Einen Job auf dem Runner ausführen

Hilfsmittel

• Versuchen Sie zuerst, die unten stehenden Aufgaben mit Hilfe der Folien zu lösen.
• Sollten Sie dabei Probleme haben, finden Sie bei jeder Aufgabe einen ausklappbaren Block, in dem der Lösungsweg beschrieben wird.

Aufgabe 1 - Runner starten

• Gehen Sie auf ihre VSCode Instanz: code-{ZAHL}.labs.corewire.de
• Erstellen Sie einen Ordner gitlab-runner in ihrem Workspace
• Starten Sie einen Runner. Verwenden Sie für die Config den eben erstellten Ordner.

Lösung (Klicken Sie auf den Pfeil, falls sie nicht weiterkommen)

• Links im Menü können Sie den Dateiexplorer (Symbol über der Lupe) öffnen
• Erstellen Sie mit Rechtsklick auf den Dateiexplorer den Ordner gitlab-runner
• Öffnen Sie nun über das Menu (Symbol über dem Dateiexplorer) ⇨ Terminal ⇨ New Terminal ein Terminal
• Führen Sie folgenden Befehl aus:

  docker run -d --name gitlab-runner --restart always  -v /home/coder/workspace/gitlab-runner:/etc/gitlab-runner -v /var/run/docker.sock:/var/run/docker.sock  gitlab/gitlab-runner:latest
  

Aufgabe 2 - Runner registrieren

2.1 Runner registrieren

• Registrieren Sie den Runner als Specific Runner für ihr gitlab-ci-demo Projekt
  • Fügen Sie ein Tag (z.B. user-0-runner) hinzu
  • Wählen Sie als Executor docker

Lösung (Klicken Sie auf den Pfeil, falls sie nicht weiterkommen)

• Führen Sie folgenden Befehl aus:

  docker run --rm -it -v /home/coder/workspace/gitlab-runner:/etc/gitlab-runner gitlab/gitlab-runner register
  

• Geben Sie als Gitlab instance URL https://git.labs.corewire.de an.
• Den Token finden Sie im Gitlab in ihrem Projekt unter Settings ⇨ CI/CD ⇨ Runners
• Geben Sie dem Runner einen Namen
• Geben Sie dem Runner ein Tag
• Die Maintenance Note können Sie überspringen
• Executor: docker
• Docker image: ubuntu:22.04

2.2 Runner überprüfen

• Überprüfen Sie, dass der Runner erfolgreich registriert wurde.

Lösung (Klicken Sie auf den Pfeil, falls sie nicht weiterkommen)

• Auf der Seite, auf der Sie den Token gefunden haben, sollte nun auch der Runner mit dem von ihnen angegebenen Namen angezeigt werden
• Gegebenfalls müssen Sie die Seite neu laden

Aufgabe 3 - Job auf Runner starten

• Starten Sie einen Job auf dem neuen Runner
• Passen Sie dafür einen Job in der .gitlab-ci.yml entsprechend an

Lösung (Klicken Sie auf den Pfeil, falls sie nicht weiterkommen)

• Gehen Sie auf den Pipeline-Editor ihres gitlab-ci-demo Projekts.
• Passen Sie die .gitlab-ci.yml zum Beispiel wie folgt an. Ggfs. müssen Sie den Tag anpassen.

      Demo:
          tags:
              - user-0-runner
          script:
              - echo $CI_PIPELINE_SOURCE
              - echo $CI_PIPELINE_ID
              - echo $CI_PIPELINE_IID
              - sleep 60
  

• Commiten Sie die Änderung und triggern Sie dadurch die Pipeline
• In den Job-Details können Sie oben rechts sehen, auf welchem Runner ihr Job ausgeführt wird.