# Updates & Upgrades

> Wie die DataBridge aktualisiert wird und welche Breaking Changes bei Versionssprüngen zu beachten sind.

---

Site [llms.txt](/llms.txt)

---

Diese Seite beschreibt das **Vorgehen** bei einem Update. Die vollständigen Änderungen und
Installationshinweise je Release stehen in der [Versionshistorie](../../versionen/).

## Vorgehen bei einem Update

Die Konfiguration in Table Storage bleibt bei einem Update unverändert — es sei denn, ein
Breaking Change erfordert Anpassungen.

### Schritte

1. **Release Notes prüfen** — Breaking Changes und Installationshinweise des Zielrelease
   und **aller dazwischenliegenden** Versionen lesen ([Versionshistorie](../../versionen/))
2. **Wartungsfenster einplanen** — `GetChanges` über ein App-Setting deaktivieren:
   ```
   AzureWebJobs.GetChanges.Disabled = true
   ```
   Bei Bedarf lassen sich die Verarbeiter analog abschalten
   (`AzureWebJobs.ProcessStandardQueueItems.Disabled` usw.)
3. **Warten**, bis alle Queue-Nachrichten verarbeitet wurden (Queue-Länge im Azure Portal
   prüfen)
4. **Neue Version einspielen** — je nach Betriebsart:
   - **Container:** Image-Tag auf die neue Version setzen
   - **Marketplace:** Assistenten erneut durchlaufen (bei unveränderten Standardwerten
     ergibt sich keine Änderung an bestehenden Einstellungen)
   - **Bicep / Pipeline:** Deployment erneut ausführen
   - **Zip-Upload:** Paket über die Pipeline oder manuell einspielen
5. **Konfigurationsanpassungen** aus den Installationshinweisen vornehmen
6. **GetChanges wieder aktivieren:**
   ```
   AzureWebJobs.GetChanges.Disabled = false (oder Eintrag löschen)
   ```
7. **Ersten Lauf beobachten** — z. B. über die Custom Metric `ChangesDetected` je Job oder
   die Fehlerquoten-Abfrage unter
   [Performance & Laufzeiten](../logging/performance/)

> **App-Settings lösen einen Neustart aus**
>
> Jede Änderung an den App-Settings startet die Function App neu. Das ist beim Ein- und
> Ausschalten der Funktionen in Schritt 2 und 6 eingeplant.



---

## Breaking Changes je Version

Die vollständigen Breaking Changes und Installationshinweise stehen **ausschließlich** in
den Release Notes der jeweiligen Version — hier nur der Überblick, ob ein Übergang
überhaupt einen Breaking Change enthält:

| Übergang | Breaking Change | Details |
|---|---|---|
| → v2.3 (aktuell) | ✅ | [Release Notes v2.3](../../versionen/v2.3/) |
| → v2.2 | ✅ | [Release Notes v2.2](../../versionen/v2.2/) |
| → v2.1 | ✅ | [Release Notes v2.1](../../versionen/v2.1/) |
| → v2.0 | ❗ .NET 10 Runtime | [Release Notes v2.0](../../versionen/v2.0/) |
| 1.0 → 1.1, 1.1 → 2.0 | ❗ je Übergang | [Ältere Releases](../../versionen/aeltere-releases/) |

Beim Überspringen von Versionen sind die Release Notes **aller** dazwischenliegenden
Versionen zu beachten, nicht nur die des Zielrelease.