Updates & Upgrades
Diese Seite beschreibt das Vorgehen bei einem Update. Die vollständigen Änderungen und Installationshinweise je Release stehen in der Versionshistorie.
Vorgehen bei einem Update
Die Konfiguration in Table Storage bleibt bei einem Update unverändert — es sei denn, ein Breaking Change erfordert Anpassungen.
Schritte
- Release Notes prüfen — Breaking Changes und Installationshinweise des Zielrelease und aller dazwischenliegenden Versionen lesen (Versionshistorie)
- Wartungsfenster einplanen —
GetChangesüber ein App-Setting deaktivieren:
Bei Bedarf lassen sich die Verarbeiter analog abschalten (AzureWebJobs.GetChanges.Disabled = trueAzureWebJobs.ProcessStandardQueueItems.Disabledusw.) - Warten, bis alle Queue-Nachrichten verarbeitet wurden (Queue-Länge im Azure Portal prüfen)
- 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
- Konfigurationsanpassungen aus den Installationshinweisen vornehmen
- GetChanges wieder aktivieren:
AzureWebJobs.GetChanges.Disabled = false (oder Eintrag löschen) - Ersten Lauf beobachten — z. B. über die Custom Metric
ChangesDetectedje Job oder die Fehlerquoten-Abfrage unter Performance & Laufzeiten
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.2 (aktuell) | ✅ | Release Notes v2.2 |
| → v2.1 | ✅ | Release Notes v2.1 |
| → v2.0 | ❗ .NET 10 Runtime | Release Notes v2.0 |
| 1.0 → 1.1, 1.1 → 2.0 | ❗ je Übergang | Ältere Releases |
Beim Überspringen von Versionen sind die Release Notes aller dazwischenliegenden Versionen zu beachten, nicht nur die des Zielrelease.