Plugin: hook-teams

Sendet Release-Benachrichtigungen an Microsoft Teams über Incoming Webhooks. Nutze ihn, um neue Versionen und Changelog-Highlights mit deinem Team in einem Teams-Channel zu teilen.

Installation

semrel plugin install @semrel/hook-teams

semrel plugin install lädt die Binärdatei nach .semrel/plugins/ herunter und aktualisiert .semrel.lock. Committe .semrel.lock, um die Version für dein Team festzuschreiben.

Konfiguration

plugins:
  - uses: @semrel/hook-teams
    args:
      webhook_url: "https://your-tenant.webhook.office.com/webhookb2/..."
      title: "ðŸš€ New Release"      # optional
      theme_color: "0078D7"         # optional, hex without #
      mention: "user@example.com"   # optional, Teams user to @mention

Umgebungsvariablen

Name	Erforderlich	Standard	Beschreibung
`SEMREL_PLUGIN_WEBHOOK_URL`	ja	`—`	Microsoft-Teams-URL für Incoming Webhooks.
`SEMREL_PLUGIN_TITLE`	nein	`ðŸš€ New Release`	Kartentitel, der in der Teams-Nachricht angezeigt wird.
`SEMREL_PLUGIN_THEME_COLOR`	nein	`0078D7`	Hex-Farbe (ohne `#`) für die Kartenakzentfarbe.
`SEMREL_PLUGIN_MENTION`	nein	`—`	E-Mail-Adresse eines Teams-Benutzers für eine @mention.

Einen Webhook-URL erhalten

Öffne in Teams den Ziel-Channel → ··· → Connectors
Suche nach Incoming Webhook → Configure
Gib ihm einen Namen (z. B. semrel) und lade optional ein Symbol hoch
Kopiere die erzeugte Webhook-URL und speichere sie als Geheimnis

Release-Kontextvariablen

SEMREL_VERSION
SEMREL_TAG_NAME
SEMREL_NEXT_VERSION
SEMREL_CHANGELOG
SEMREL_DRY_RUN

Dry-Run-Verhalten

Wenn SEMREL_DRY_RUN=true, gibt das Plugin aus, was es senden würde, und beendet sich mit 0, ohne HTTP-Aufrufe auszuführen:

hook-teams: [dry-run] would send Teams notification for v1.4.0

Beispielausgabe

Eine erfolgreiche Release sendet eine adaptive Karte in deinen Teams-Channel, die Versionsnummer, Release-Branch und den erzeugten Changelog anzeigt.

Quelle

SemRels/hook-teams