Seminar GitLab Runner Betrieb und Executor-Konfiguration

Dieses Seminar behandelt GitLab Runner als zentrale Ausführungsinstanz für CI/CD-Jobs. Behandelt werden Registrierung, Executor-Auswahl, Konfiguration, Sicherheit, Job-Zuordnung und Fehlerdiagnose.

Der Fokus liegt auf selbstverwalteten Runnern in kontrollierten Unternehmensumgebungen, nicht auf schnellen Einmalinstallationen ohne Betriebskonzept.

Inhaltsübersicht

• Runner-Typen, Runner Manager, Executor-Konzept und Registrierungsmodelle
• Shell, Docker und weitere Executor-Varianten im Vergleich
• Tags, protected Runner, locked Runner, Projekt- und Gruppenbezug
• Cache, Artifacts, Build-Verzeichnisse, Helper Images und Netzwerkanforderungen
• Sichere Konfiguration von Docker-in-Docker, Privileged Mode und Secrets
• Troubleshooting von Jobs, Logs, Timeouts, Berechtigungen und Runner-Zuständen

Praxisorientierte Beschreibung

Runner entscheiden darüber, ob Pipelines zuverlässig und sicher laufen. Das Seminar beginnt deshalb mit den Grundlagen der Runner-Architektur und zeigt, wie Jobs einem Runner zugeordnet werden, welche Rolle Tags spielen und wie Fehlkonfigurationen später zu zufälligem Verhalten führen.

Im Praxisteil werden unterschiedliche Executor-Konfigurationen aufgebaut. Dabei werden Vor- und Nachteile von Shell und Docker verglichen, einschließlich Isolation, Performance, Abhängigkeiten und Sicherheitsfolgen. Besonders kritisch werden privilegierte Container, Docker Socket Binding und Build Secrets betrachtet.

Der letzte Teil konzentriert sich auf Betrieb und Diagnose. Job-Logs, Runner-Logs, Statusanzeigen, Berechtigungsfehler, Cache-Probleme und Netzwerkfehler werden systematisch eingeordnet. Ziel ist ein Runner-Betrieb, der nicht bei jedem zweiten Pipeline-Fehler zum Ratespiel wird.

Schrittweiser Seminaraufbau

1. Runner-Rollen und Executor-Varianten für vorhandene Workloads bewerten
2. Runner sicher registrieren und mit Projekt- oder Gruppenbezug versehen
3. Tags, Schutzmechanismen und Concurrency-Regeln einrichten
4. Docker Executor mit Cache, Artifacts und Registry-Zugriff konfigurieren
5. Sicherheitsrisiken durch privilegierte Builds und Secrets begrenzen
6. Fehlerfälle mit Logs, Job-Trace und Runner-Konfiguration analysieren

Praktische Übungen

• Self-Managed Runner registrieren und einem Projekt zuordnen
• Runner Tags für unterschiedliche Build-Typen einsetzen
• Pipeline mit Docker Executor und Cache ausführen
• Fehlkonfiguration eines privilegierten Builds erkennen
• Timeout- und Berechtigungsfehler anhand von Logs beheben

Zielgruppe

Geeignet für Rollen, die GitLab Runner installieren, konfigurieren, standardisieren oder als interne Build-Infrastruktur betreiben.