Zum Hauptinhalt springen

DevOps Deployment Notification

Template für Teams-Nachrichten im DevOps-Infos PROD Channel nach einem Deployment.

🤖 Generated with Claude Code

✅ Reviewed by [Name], [YYYY-MM-DD]

Co-Authored-By: Claude (noreply@anthropic.com)

Struktur​

Subject (plain text): [Komponente] [Version]

Body:

**[Kategorie]**: [Kurzbeschreibung]

[Version-Link] wurde auf [Umgebung] deployt.

Was wurde geändert:
- Änderung 1
- Änderung 2

Entscheidungen:
- Entscheidung 1 (Begründung)

Dokumentation:
- [Link zur Doku]

Rückstiegsversion im Fehlerfall ist die [Version-Link].

[Mentions]

Felder​

FeldPflichtBeschreibung
KomponentejaName der Anwendung/des Service
VersionjaVersionsnummer (z.B. service-v9.3.1)
KategoriejaFix, Bugfix, Feature, Config, Infrastructure
KurzbeschreibungjaEin Satz, Konzentration auf das Wesentliche
Version-LinkjaBuild-/Release-Nummer mit Link zu Azure DevOps
UmgebungjaFachtest, Prod
AenderungenjaListe der wesentlichen Aenderungen
EntscheidungenoptionalGetroffene Entscheidungen mit Begründung
DokumentationoptionalLinks zu neuer/aktualisierter Doku für Developer
Rückstiegsversionwenn ProdVorherige Version mit Link
MentionsoptionalBetroffene/zuständige Personen

Beispiele​

Feature​

**Feature**: Neue MaklerApiV2 mit Druckdaten und Metadaten

[tis.identity.api service-v9.3.1](build-link) wurde auf Prod deployt.

Was wurde geändert:
- MaklerApiV2 mit neuen Endpoints (GetMaklerV2, FindByBenutzer, Bulk-Lookup)

Dokumentation:
- [MaklerApiV2 API-Doku](wiki-link)

Rückstiegsversion im Fehlerfall ist die [service-v9.2.0](build-link).

Bugfix​

**Bugfix**: GF-Update-Queue bleibt nicht mehr bei fehlschlagenden Jobs stecken.

Nach 3 Fehlversuchen wird der Job übersprungen und ein WARN-Log geschrieben.

@Peter @Michael

Deployment mit Rollback​

[api.servicebytogether.at 1.0.26054.03](release-link) wurde auf Prod deployt.

Was wurde geändert:
- YARP Destination-Keys vereinheitlicht (Fix für 504 Errors)

Rückstiegsversion im Fehlerfall ist die [1.0.26050.01](release-link).

Config/Infrastructure​

Sensible Konfigurationswerte wurden aus den appsettings-Dateien in Azure Key Vault migriert.

Was wurde gemacht:
- Secrets durch AKV-Referenzen ersetzt
- Alte mTLS-Zertifikatsdatei entfernt

Entscheidungen:
- Secret-Handling-Logik entfernt statt beibehalten (AKV übernimmt Rotation)

Migrierte Secrets:
- UNIQA OAuth Client Secrets
- Token Storage Connection String
- mTLS Client-Zertifikat (Prod)

HTML-Format (Teams)​

Teams-Nachrichten verwenden HTML. Konvertierung:

  • **bold** → <strong>
  • Listen → <ul><li> oder - Text<br>
  • Links → <a href="...">
  • Absätze → <p>
  • Abstand zwischen Sections → <p>&nbsp;</p>

Beispiel (HTML)​

<p><strong>Feature</strong>: Neue MaklerApiV2 mit Druckdaten und Metadaten</p>
<p>&nbsp;</p>
<p><a href="https://dev.azure.com/togethercca/tis-cca/_build/results?buildId=105578">tis.identity.api service-v9.3.1</a> wurde auf Prod deployt.</p>
<p>&nbsp;</p>
<p>Was wurde geändert:<br>
- MaklerApiV2 mit neuen Endpoints (GetMaklerV2, FindByBenutzer, Bulk-Lookup)</p>
<p>&nbsp;</p>
<p>Rückstiegsversion im Fehlerfall ist die <a href="https://dev.azure.com/togethercca/tis-cca/_build/results?buildId=104449">service-v9.2.0</a>.</p>