GitLab → Microsoft Teams Benachrichtigungen einrichten

GitLab → Microsoft Teams Benachrichtigungen einrichten
Übersicht
GitLab kann bei Pipeline-Fehlern, Pushes, Merge Requests usw. automatisch Nachrichten
in einen Microsoft Teams-Kanal senden. Dafür wird ein Incoming Webhook in Teams
erstellt und dessen URL in GitLab hinterlegt.
Schritt 1: Incoming Webhook in Microsoft Teams erstellen
Hinweis: Seit dem Teams-Update 2024/2025 hat Microsoft die klassischen
„Connectors" abgekündigt. Webhooks werden jetzt über Workflows eingerichtet.
1.1 Workflow-Webhook anlegen (aktuelle Methode)
Den gewünschten Teams-Kanal öffnen.
Oben rechts auf „..." (Weitere Optionen) klicken → „Workflows" auswählen.
Im Workflows-Dialog auf „Vorlagen anzeigen" klicken.
Die Vorlage „Webhookwarnungen an GitLab senden" suchen und auswählen.
Tipp: Falls die Vorlage im Teams-Dialog nicht erscheint, unten rechts auf
„Startseite für Workflows" klicken – das öffnet Power Automate im Browser.
Dort unter „Vorlagen" nach „webhook" suchen und dieselbe Vorlage auswählen.
Einen aussagekräftigen Namen vergeben, z. B.:
GitLab obility_standard Pipeline-Benachrichtigungen
Das Ziel-Team und den Ziel-Kanal in den Parametern auswählen.
Auf „Speichern" klicken.
Die generierte Webhook-URL kopieren und sicher ablegen –
sie wird in Schritt 2 benötigt.
Schritt 2: Webhook-URL in GitLab hinterlegen
Im GitLab-Projekt navigieren:
Einstellungen → Integrationen → Microsoft Teams notifications
Checkbox „Integration aktivieren" aktivieren.
Die kopierte Webhook-URL aus Schritt 1.8 in das Feld „Webhook" einfügen.
Unter „Trigger" ausschließlich folgenden Eintrag aktivieren, alle anderen deaktiviert lassen:
Trigger
Aktivieren?
Ein Push wird an das Repository durchgeführt
☐ Nein
Ein Ticket wird erstellt, geschlossen oder erneut geöffnet
☐ Nein
Ein Merge Request wird erstellt / zusammengeführt
☐ Nein
Ein Kommentar wird hinzugefügt
☐ Nein
Ein Tag wird in das Repository gepusht
☐ Nein
Ein Pipeline-Status ändert sich
✅ Ja
Eine Wiki-Seite wird erstellt oder aktualisiert
☐ Nein
Unter „Benachrichtigungseinstellungen" die Option
„Notify only broken pipelines" aktivieren.
→ Damit werden ausschließlich fehlgeschlagene Pipelines gemeldet,
erfolgreiche Durchläufe erzeugen keine Benachrichtigung.
Auf „Änderungen speichern" klicken.
Über „Testeinstellungen" eine Testnachricht auslösen und prüfen,
ob sie im Teams-Kanal erscheint.
Schritt 3: Verhalten bei Pipeline-Fehlern prüfen
Nach der Einrichtung sendet GitLab bei jedem Trigger automatisch eine Karte
in den konfigurierten Teams-Kanal, u. a. mit:
Projekt- und Branch-Name
Pipeline-Status (erfolgreich / fehlgeschlagen)
Direktlink zur Pipeline in GitLab
Für den täglichen Schedule (
Tägliche Aktualisierung der Docker-Basis-Images)
ist besonders der Trigger „Ein Pipeline-Status ändert sich" relevant –
er meldet sowohl Fehler als auch erfolgreiche Durchläufe.
Hinweise
Die Webhook-URL gewährt Schreibzugriff auf den Kanal. Sie gehört nicht in
die 
.gitlab-ci.yml oder das Repository, sondern ausschließlich in die
GitLab-Integrationseinstellungen.
Wenn der Kanal oder das Team umbenannt wird, bleibt die Webhook-URL gültig.
Wird der Workflow in Teams gelöscht, muss ein neuer Webhook erstellt und
in GitLab aktualisiert werden.