Seminar openCode – CI/CD und Runner in der Praxis

Automatisierte Prüfungen und reproduzierbare Arbeitsabläufe reduzieren den Aufwand für die gemeinsame Pflege von Software. Das Seminar führt von einer ersten Pipeline bis zu einer kontrollierten Veröffentlichung eines kleinen Projekts auf openCode. Die Konfiguration wird schrittweise aufgebaut und nach jedem Schritt auf ihr tatsächliches Verhalten geprüft. Dabei stehen verständliche Jobs, klare Abhängigkeiten und eine nachvollziehbare Verbindung zwischen Quellstand, Testergebnis und ausgeliefertem Artefakt im Mittelpunkt.

Die openCode-spezifischen Betriebsbedingungen werden in die Übungen einbezogen: bereitgestellte Runner, eigene Runner, begrenzte Rechte und der verantwortungsvolle Umgang mit Ressourcen. Ergänzende Tests und Prüfwerkzeuge werden als ausdrücklich eingebundene Werkzeuge behandelt. Eine absichtlich fehlerhafte Pipeline liefert Beispiele für Syntaxfehler, unpassende Runner-Zuordnung, fehlende Artefakte und falsch gesetzte Variablen. Veröffentlichungen erfolgen ausschließlich in eine vorbereitete Übungsablage. Dadurch kann auch ein fehlerhafter Lauf untersucht und anschließend mit einer kontrollierten Korrektur wiederholt werden.

Inhaltsübersicht

1. Pipeline-Grundlagen aufbauen
2. Tests, Artefakte und Wiederverwendung
3. Runner auswählen und anbinden
4. Variablen und Freigaben schützen
5. Releaseprozess und Fehlerdiagnose
6. Integrierte Pipeline-Werkstatt

1. Pipeline-Grundlagen aufbauen

• Aufbau der .gitlab-ci.yml mit Jobs, Stages und Scripts nachvollziehen; Änderungen versionieren und Konfiguration vor dem Start prüfen.
• Auslöser und rules für Branches, Merge Requests und Tags einsetzen; unnötige doppelte Pipeline-Läufe vermeiden.
• Job-Abhängigkeiten, Rückgabecodes und nachvollziehbare Laufprotokolle als Grundlage einer wartbaren Pipeline nutzen.

Praxisübung: Eine minimale Pipeline ergänzen, einen absichtlich fehlerhaften Job untersuchen und die Ausführung für einen Merge Request gezielt steuern.

2. Tests, Artefakte und Wiederverwendung

• Format-, Funktions- und Dokumentationsprüfungen für ein kleines Beispielprojekt kombinieren und Fehler als überprüfbare Signale ausgeben.
• Artefakte und Cache nach Zweck unterscheiden; Dateipfade, Aufbewahrung und nachfolgende Jobs bewusst konfigurieren.
• Wiederverwendbare Konfigurationsbausteine einsetzen und deren Versionen sowie externe Abhängigkeiten nachvollziehbar festlegen.

Praxisübung: Testergebnisse und ein Build-Artefakt erzeugen, an einen Folgejob übergeben und einen Fehler durch falsche Pfadangaben beheben.

3. Runner auswählen und anbinden

• Bereitgestellte Standard-Runner, kapazitätsstärkere Runner und eigene Runner anhand des Arbeitslastprofils vergleichen.
• Einen Projekt-Runner über den verfügbaren Erstellungsablauf und Runner-Authentifizierungstoken registrieren; Zuordnung und Tags prüfen.
• Ausführungsumgebung, Container-Images, Netzwerkzugriff und Ressourcengrenzen kundenseitiger Runner betrachten; erhöhte Rechte begrenzen.

Praxisübung: Einen eigenen Runner an der vorbereiteten VM anbinden, einen getaggten Job ausführen und eine absichtlich unpassende Zuordnung diagnostizieren.

4. Variablen und Freigaben schützen

• Öffentliche Konfiguration von vertraulichen CI-Variablen trennen; Schutz, Maskierung und Verfügbarkeit passend zum Job prüfen.
• Den Zugriff nicht vertrauenswürdiger Änderungen auf Zugangsmittel und Veröffentlichungsjobs untersuchen.
• Manuelle Freigaben, Branch-Schutz und getrennte Ziele für Test und Veröffentlichung zu einem kontrollierten Ablauf verbinden.

Praxisübung: Ein Übungsgeheimnis geschützt hinterlegen, seine Verfügbarkeit in unterschiedlichen Pipeline-Situationen prüfen und einen Freigabeschritt einbauen.

5. Releaseprozess und Fehlerdiagnose

• Versionskennzeichnung, Tags, Releaseinformationen und Artefakte konsistent zuordnen und eine definierte Übungsablage befüllen.
• Fehler in Konfiguration, Runner, Berechtigung und Anwendung unterscheiden; Logs, Jobstatus und Artefaktbestand gezielt auswerten.
• Wiederholbarkeit, Laufzeiten und Wartungsbedarf beurteilen; einen früheren freigegebenen Stand kontrolliert erneut bereitstellen.

Praxisübung: Eine vollständige Pipeline mit Test, Build und Freigabe ausführen, einen Fehlerfall beheben und die korrekte Artefaktversion nachweisen.

6. Integrierte Pipeline-Werkstatt

• Ein Anforderungsblatt in eine eigenständig erstellte Pipeline mit nachvollziehbaren Jobs und überprüfbaren Erfolgskriterien übertragen.
• Zugangsschutz, Artefakte, Releaselogik und Runner-Auswahl durch ein zweites Team gegenprüfen lassen.
• Betriebszuständigkeit und Pflege der Pipeline-Konfiguration im Projekt dokumentieren.

Praxisübung: Die vorbereitete Lieferstrecke eigenständig vervollständigen und anhand eines erfolgreichen sowie eines kontrolliert fehlschlagenden Laufs demonstrieren.

Schulungsumgebung

Der Kunde stellt ein berechtigtes openCode-Projekt mit Maintainer-Zugriff, ein kleines Build-Projekt sowie eine Linux-VM mit administrierbarer Runner-Laufzeit bereit. Netzwerkzugriffe und benötigte Container-Images sind vorab freizugeben. Zielsysteme und Zugangsmittel dienen ausschließlich dem Übungsbetrieb.