Anleitung
GitLab und CI selbst betreiben: ein Entwicklungsprozess für Teams, die Hardware und Software zusammen testen
Ein Hardware-Team, das Firmware, Schaltpläne und Modelle gemeinsam versioniert und testet, braucht vier Dinge auf eigenen Servern: GitLab für Code und Reviews, GitLab CI mit Runnern an der Hardware für die Tests, OpenProject für Planung und Rückverfolgbarkeit und paperless-ngx für die Dokumente, die kein Repository sind. Dieser Artikel zeigt, wie die vier zusammenpassen und was LDAP, SAML und SMTP leisten.
Er richtet sich an mittelständische Hersteller, deren Entwicklungsprozess bisher aus E-Mails, Netzlaufwerken und einem Kanban-Board besteht.
1. Ausgangslage: Kanban reicht nicht mehr
Viele Hardware-Teams haben mit Kanban angefangen: ein Board, Karten, Spalten. Das funktioniert, solange der Prozess im Kopf der Beteiligten vollständig ist. Es hört auf zu funktionieren, wenn Kunden oder Normen fragen, welche Firmware-Version mit welchem Schaltplan-Stand getestet wurde, wer die Freigabe erteilt hat und wo der Testbericht liegt. Dann braucht der Prozess eine Form, die Werkzeuge abbilden.
Für einen mittelständischen Hersteller von Sicherheitstechnik haben wir genau diesen Übergang begleitet: Beratung zum neuen Entwicklungsprozess mit komplexen Hardware-Tests für Code wie für Entwürfe und Modelle, danach der Aufbau der Werkzeuge auf virtuellen Maschinen und ihre Verbindung über SMTP und LDAP/SAML2, in rund sechs Monaten. Die Entscheidungen von damals sind die Abschnitte dieses Artikels.
2. Warum selbst betreiben
Drei Gründe, die bei Hardware-Herstellern regelmäßig den Ausschlag geben:
- Die Testhardware steht im Haus. CI-Jobs, die Firmware auf ein Gerät flashen und einen Prüfstand ansteuern, laufen auf Runnern, die physisch neben dem Gerät stehen. Ein Cloud-Dienst erreicht diesen Prüfstand nur über Umwege.
- Schaltpläne, Modelle und Testdaten sind Betriebsgeheimnisse. Ein Repository mit dem Layout eines Produkts verlässt das Haus nicht.
- Lizenzkosten pro Nutzer. Bei Teams, in denen auch Prüffeld, Fertigung und Dokumentation lesen sollen, wird ein Sitzpreis schnell teuer. Selbst betriebene Open-Source-Werkzeuge haben diesen Posten nicht; sie haben stattdessen Betriebsaufwand, der sich planen lässt.
Was dagegen spricht: Jemand muss Updates einspielen, Backups prüfen und bei Ausfällen erreichbar sein. Wer das nicht intern hat, kauft es als Dienstleistung ein oder nimmt die Cloud-Variante und löst das Prüfstand-Problem mit einem einzelnen lokalen Runner.
3. Die vier Werkzeuge und ihre Rollen
| Werkzeug | Rolle | Was hinein gehört |
|---|---|---|
| GitLab | Versionierung, Merge-Requests, Reviews, Releases | Firmware, Software, Testskripte, Schaltplan- und Modell-Exporte, CI-Definitionen |
| GitLab CI mit Runnern | Build, Unit-Tests, Hardware-in-the-Loop-Tests, Artefakte | Pipelines je Repository; Runner mit Tags je Prüfstand |
| OpenProject | Anforderungen, Arbeitspakete, Releases, Rückverfolgbarkeit | Was gebaut wird und warum; Verknüpfung zu Merge-Requests |
| paperless-ngx | Dokumente, die nicht ins Repository gehören | Prüfberichte als PDF, Zertifikate, Lieferantendokumente, unterschriebene Freigaben |
Die Trennung ist wichtig: Alles, was sich textuell versionieren lässt, gehört in GitLab. Alles, was ein Dokument mit Datum und Unterschrift ist, gehört in paperless-ngx. OpenProject hält die Klammer: Ein Arbeitspaket verweist auf den Merge-Request, der es umgesetzt hat, und auf den Prüfbericht, der es abgenommen hat.
4. Die Plattform: virtuelle Maschinen, bewusst einfach
Für ein Team dieser Größe sind virtuelle Maschinen die richtige Wahl, kein Kubernetes. Eine VM je Dienst, dazu eine für die GitLab-Runner, eine für den Reverse-Proxy mit TLS. Das lässt sich mit Bordmitteln sichern und wiederherstellen und braucht keine Plattform-Kenntnisse im Haus.
Empfehlungen, die sich bewährt haben:
- Eine VM je Dienst, nicht alles auf einer. Ein GitLab-Update, das schiefgeht, darf OpenProject nicht mitreißen.
- Snapshots vor jedem Update, und ein Test der Wiederherstellung einmal im Quartal. Ein Backup, das nie zurückgespielt wurde, ist eine Vermutung.
- Reverse-Proxy mit internen Zertifikaten oder einem internen ACME-Dienst, damit Browser und Runner ohne Warnungen arbeiten.
- Feste interne Hostnamen für alle vier Dienste, in DNS gepflegt, nicht in
/etc/hosts.
5. Identität: LDAP für alle, SAML wo es geht
Vier Werkzeuge mit vier Passwörtern je Person sind der Grund, warum Teams Werkzeuge nicht benutzen. Die Lösung hat zwei Stufen:
LDAP (meist Active Directory) ist die Quelle für Nutzer und Gruppen. GitLab und OpenProject können direkt dagegen authentifizieren. paperless-ngx bringt kein eigenes LDAP mit; es meldet über OpenID Connect am Identity Provider an (der seinerseits am Verzeichnis hängt) oder übernimmt den Nutzer von einem vorgeschalteten Authentifizierungs-Proxy. Gruppen aus dem Verzeichnis werden auf Rollen abgebildet: entwicklung darf schreiben, prueffeld darf lesen und Prüfberichte ablegen, leitung darf freigeben.
SAML 2.0 über einen Identity Provider (Entra ID, Keycloak oder der vorhandene) ergänzt LDAP um Single Sign-on: Wer im Firmennetz angemeldet ist, ist auch in GitLab angemeldet. GitLab und OpenProject unterstützen SAML direkt; paperless-ngx geht über OpenID Connect, das derselbe Identity Provider anbietet.
Die Reihenfolge beim Aufbau: erst LDAP in GitLab und OpenProject, Gruppen und Rollen testen, dann SAML als zweite Anmeldeart hinzufügen, dann LDAP-Passwortanmeldung abschalten. Wer mit SAML beginnt, hat beim ersten Ausfall des Identity Providers keinen Zugang mehr zu den Werkzeugen; ein lokaler Break-Glass-Administrator je Dienst bleibt immer bestehen.
6. E-Mail: SMTP ist nicht optional
Jedes der vier Werkzeuge verschickt E-Mails: Merge-Request-Benachrichtigungen, Pipeline-Ergebnisse, Erinnerungen, Dokument-Eingänge. Ohne funktionierenden Versand merken Reviewer nicht, dass sie dran sind, und der Prozess steht.
Ein internes SMTP-Relay, das an den Firmen-Mailserver weiterreicht, ist der saubere Weg: ein Absender je Dienst (gitlab@, openproject@, paperless@), SPF-Eintrag für das Relay, Authentifizierung mit Dienstkonten statt persönlichen Zugangsdaten. paperless-ngx kann umgekehrt ein Postfach abrufen und eingehende Prüfberichte oder Lieferantendokumente automatisch ablegen.
7. CI an der Hardware
Der eigentliche Grund, GitLab CI selbst zu betreiben, sind die Tests am Gerät. Das Muster:
stages: [build, unit, hil, release]
build-firmware:
stage: build
image: registry.example.test/toolchain/arm-gcc
script:
- make -j firmware
artifacts:
paths: [build/firmware.bin]
unit-tests:
stage: unit
script:
- make test
hil-pruefstand-a:
stage: hil
tags: [pruefstand-a] # Runner steht physisch am Prüfstand A
resource_group: pruefstand-a # nie zwei Jobs gleichzeitig am selben Gerät
script:
- ./tools/flash.sh build/firmware.bin
- ./tools/run-hil.sh --suite smoke --report report.xml
artifacts:
reports:
junit: report.xml
paths: [report.xml, logs/]
rules:
- if: $CI_MERGE_REQUEST_IID
Drei Details tragen das Muster:
- Runner-Tags je Prüfstand, damit ein Job genau dort läuft, wo das Gerät hängt.
resource_group, damit nie zwei Pipelines gleichzeitig dasselbe Gerät flashen.- JUnit-Reports als Artefakt, damit das Ergebnis im Merge-Request erscheint und OpenProject es verlinken kann.
Für Entwürfe und Modelle, die nicht kompiliert werden (Schaltpläne, mechanische Modelle, Simulationsmodelle), gilt dasselbe Prinzip mit anderen Schritten: Export in ein textuelles oder vergleichbares Format, Prüfregeln als Skript (Design Rule Checks, Stücklisten-Abgleich), Ergebnis als Artefakt. Nicht alles lässt sich automatisieren; aber alles, was automatisiert ist, läuft bei jedem Merge-Request und nicht nur vor der Messe.
8. Der Prozess, den die Werkzeuge abbilden
Werkzeuge ersetzen keinen Prozess; sie machen ihn sichtbar. Der Entwicklungsprozess, den wir mit dem Hersteller aufgesetzt haben, folgt einem einfachen Durchlauf:
- Anforderung als Arbeitspaket in OpenProject, mit Akzeptanzkriterien.
- Umsetzung in einem Branch, Merge-Request verweist auf das Arbeitspaket.
- Automatische Tests in der Pipeline, einschließlich Hardware-Test am Prüfstand, Ergebnis im Merge-Request.
- Review durch eine zweite Person; bei sicherheitsrelevanten Änderungen durch zwei.
- Freigabe als Release-Tag in GitLab; der Prüfbericht wird als PDF in paperless-ngx abgelegt und mit Release und Arbeitspaket verknüpft.
- Rückverfolgung: Von jeder ausgelieferten Firmware-Version führt ein Weg zurück zum Arbeitspaket, zum Review und zum Prüfbericht.
Kanban bleibt dabei erhalten, als Sicht auf die Arbeitspakete in OpenProject. Was dazukommt, ist die Kette von der Anforderung bis zum Dokument.
9. Checkliste
Plattform:
- Eine VM je Dienst plus Runner-VM plus Reverse-Proxy; Snapshots vor Updates; Wiederherstellung geprobt.
- Interne Hostnamen in DNS; TLS über interne CA oder ACME.
Identität und E-Mail:
- LDAP in GitLab und OpenProject, paperless-ngx über OIDC am Identity Provider; Gruppen auf Rollen abgebildet.
- SAML (GitLab, OpenProject) und OIDC (paperless-ngx) über den Identity Provider; Break-Glass-Admin je Dienst.
- SMTP-Relay mit einem Absender je Dienst; SPF gesetzt; Testmail aus jedem Dienst.
CI:
- Runner je Prüfstand mit Tag und
resource_group. - Pipelines mit Build, Unit-Tests, HIL-Test, Release; JUnit-Artefakte.
- Prüfregeln für Entwürfe und Modelle als Pipeline-Schritte.
Prozess:
- Arbeitspaket → Merge-Request → Pipeline → Review → Release → Prüfbericht als Kette dokumentiert.
- Rollen: wer darf schreiben, prüfen, freigeben.
- Rückverfolgung von einer Firmware-Version bis zur Anforderung einmal durchgespielt.
10. Häufige Fragen
GitLab oder Gitea/Forgejo? Gitea und Forgejo sind leichter zu betreiben und reichen für Versionierung und Reviews. GitLab bringt die CI, Registry, Merge-Request-Workflows und die SAML-Anbindung in einem Produkt; für ein Team mit Prüfständen und Freigabeprozess ist das die geringere Gesamtkomplexität.
Brauche ich OpenProject, wenn GitLab Issues hat? GitLab-Issues reichen für Entwicklungsteams. OpenProject bringt Anforderungsverwaltung, Gantt, Rollen für Nicht-Entwickler und eine Rückverfolgbarkeit, die Normen und Kunden-Audits verlangen. Wer beides hat, führt Arbeitspakete in OpenProject und verlinkt Merge-Requests.
Wie lange dauert der Aufbau? Die Werkzeuge stehen in Tagen. Der Prozess, die Rollen und die Anbindung der Prüfstände brauchen Wochen, weil sie mit dem Team entstehen. Planen Sie Monate, nicht Tage, und starten Sie mit einem Produkt, nicht mit allen.
Was ist mit Backups?
Jeder Dienst hat ein eigenes Backup-Verfahren (GitLab: gitlab-backup; OpenProject und paperless-ngx: Datenbank-Dump plus Dateiverzeichnis). gitlab-backup sichert /etc/gitlab/gitlab.rb und /etc/gitlab/gitlab-secrets.json nicht mit; beide gehören getrennt und geschützt gesichert, sonst ist ein Teil der Daten nach der Wiederherstellung nicht mehr lesbar. Dazu VM-Snapshots. Entscheidend ist die geprobte Wiederherstellung, nicht das Vorhandensein der Dateien.
Wo das hinführt
Wir betreiben eigene Hardware in einem Rechenzentrum in München, und GitLab mit CI betreiben wir auch für uns selbst. Wie wir Entwicklungsprozesse und die Werkzeuge dafür mit Ihrem Team aufbauen, beschreibt Softwareentwicklung & Architektur.
Praxisbeispiel: Entwicklungsprozess für einen Hersteller von Sicherheitstechnik.
Wie aus einzelnen CI-Jobs automatisierte Release-Tests in eigenen Umgebungen werden: Release-Umgebungen auf Kubernetes mit Crossplane und Argo Workflows.
Englische Fassung: Self-hosted GitLab and CI: a development process for teams that test hardware and software together.
Quellen
Alle abgerufen am 20.10.2026.
- GitLab-Dokumentation: Self-managed installation, runners, LDAP, SAML SSO (Englisch).
- OpenProject-Dokumentation: GitLab integration, LDAP, SAML (Englisch).
- paperless-ngx-Dokumentation: Configuration, SSO, mail consumption (Englisch).
Die passende LeistungSoftwareentwicklung & Architektur