azure-upgrade

Überblick

Was ist azure-upgrade?

azure-upgrade ist ein geführtes Upgrade-Skill für bestehende Azure-Workloads. Der Fokus liegt auf In-Place- und Near-In-Place-Änderungen, etwa dem Aktualisieren von Plänen, Tiers und SKUs oder dem Wechsel zwischen eng verwandten Azure-Diensten, während Sie vollständig in Azure bleiben.

Typische Anwendungsfälle sind:

• Upgrade von Azure Functions von Consumption auf Flex Consumption
• Verschieben einer Function App auf einen anderen hosting plan oder ein anderes service tier
• Änderung der SKU eines bestehenden Azure-Dienstes
• Migration von App Service zu Azure Container Apps für Backend-Workloads

Das Skill kombiniert einen strukturierten Workflow (Identify → Assess → Pre-migrate → Upgrade → Validate) mit Sicherheitsregeln und Best-Practice-Empfehlungen, sodass Sie produktive Anwendungen weiterentwickeln können, ohne auf Bauchgefühl angewiesen zu sein.

Für wen ist azure-upgrade gedacht?

azure-upgrade richtet sich an:

• Developer und DevOps Engineers, die für Azure-basierte Backend-Services verantwortlich sind
• Platform- und Cloud-Operations-Teams, die Plan-, Tier- oder SKU-Änderungen verwalten
• Teams, die auf Flex Consumption standardisieren oder von App Service zu Container Apps modernisieren

Wenn Sie Pläne anpassen oder auf neuere Azure-Angebote umsteigen möchten, ohne die Produktion zu gefährden, bietet dieses Skill einen wiederholbaren, dokumentierten Pfad.

Welche Probleme löst azure-upgrade?

azure-upgrade hilft Ihnen dabei:

• Upgrade-Bereitschaft zu bewerten, bevor produktive Ressourcen geändert werden
• Ziel-Pläne/Tiers/SKUs zu planen – basierend auf Ihrem aktuellen Setup
• Wiederkehrende Upgrade-Schritte zu automatisieren – gemäß definierten Regeln
• Fortschritt zu verfolgen – über eine upgrade-status.md-Datei in Ihrem Repo
• Unsichere Aktionen zu vermeiden – mit strikten Regeln für destructive actions und Nutzerbestätigung

Dieses Skill konzentriert sich explizit auf Änderungen innerhalb von Azure. Es übernimmt keine Cloud-übergreifenden Migrationen; dafür würden Sie ein separates Migrations-Skill wie azure-cloud-migrate verwenden.

Wann ist azure-upgrade passend?

Verwenden Sie azure-upgrade, wenn:

• Sie eine laufende Azure Functions App auf Flex Consumption upgraden
• Sie das Hosting-Tier oder die SKU einer bestehenden Workload ändern möchten
• Sie eine App von App Service zu Azure Container Apps migrieren
• Sie einen nachvollziehbaren, phasenbasierten Prozess für betriebliche Azure-Upgrades benötigen

Es ist möglicherweise nicht die richtige Wahl, wenn:

• Sie Workloads aus Azure heraus verschieben (Cloud-übergreifende Migration)
• Sie eine komplett neue App ohne bestehende Ressourcen aufsetzen
• Sie ausschließlich CI/CD-Pipeline-Automatisierung benötigen (dafür eignen sich Skills wie azure-deploy besser)

Wenn Ihr Hauptfokus auf sicherem Rollout, Rollback-Optionen und Konfigurationsparität während Azure-Upgrades liegt, ist azure-upgrade genau auf diese Aufgabe zugeschnitten.

Verwendung

1. Installation und Einrichtung

Um das azure-upgrade Skill aus dem microsoft/azure-skills Repository hinzuzufügen, verwenden Sie die skills CLI in Ihrer Agent-Umgebung:

npx skills add https://github.com/microsoft/azure-skills --skill azure-upgrade

Nach der Installation sollten Sie sich die wichtigsten Dateien ansehen, in denen das Verhalten des Skills definiert ist:

• SKILL.md – Überblick, Trigger und Regeln
• references/global-rules.md – Sicherheitsregeln und Best Practices
• references/workflow-details.md – detaillierte Workflow-Phasen und Hinweise zum Status-Tracking

Stellen Sie sicher, dass Ihr Agent mit den relevanten Azure MCP Tools wie mcp_azure_mcp_get_bestpractices und mcp_azure_mcp_documentation konfiguriert ist, wie in den Skill-Regeln referenziert.

2. Den Upgrade-Workflow verstehen

azure-upgrade folgt einer vordefinierten Abfolge:

1. Identify – Quelle (z. B. aktueller Functions Plan) und Ziel-Plan, -Tier oder -SKU klären.
2. Assess – Ein Assessment zur Upgrade-Bereitschaft und Kompatibilität erstellen.
3. Pre-migrate – App Settings, Konfiguration, Abhängigkeiten und Konnektivitätsdetails erfassen.
4. Upgrade – Die automatisierten Schritte ausführen, um den neuen Plan/Tier/SKU anzuwenden oder die neue Zielressource zu erstellen.
5. Validate – Prüfen, ob die aktualisierte App funktionsfähig ist und Traffic übernehmen kann.

Die durch das Skill erzwungenen Regeln verlangen, dass die Phasen in der richtigen Reihenfolge durchlaufen werden. Das Überspringen von Assessments oder Pre-Migration-Schritten ist ausdrücklich nicht vorgesehen und trägt dazu bei, produktive Änderungen sicher und vorhersehbar zu halten.

3. Fortschritt mit upgrade-status.md nachverfolgen

Der Workflow verwendet eine einfache, repo-lokale Tracking-Datei, um Upgrades auditierbar und im Team gemeinsam nutzbar zu machen.

Erstellen Sie upgrade-status.md im Root Ihres Workspaces entsprechend der Struktur in references/workflow-details.md. Mindestens sollten enthalten sein:

• Name der Quell-App und aktueller Plan
• Ziel-Plan oder -Service
• Resource Group und Region
• Startdatum
• Checkliste der Workflow-Phasen (Identify, Assess, Pre-migrate, Upgrade, Validate)
• Notizen zu Problemen, Entscheidungen und Fehlern

Aktualisieren Sie diese Datei, während der Agent jede Phase durchläuft. Wenn eine Phase fehlschlägt, protokollieren Sie den Fehler und beheben Sie ihn, bevor Sie fortfahren.

4. Globale Sicherheitsregeln einhalten

Die Datei references/global-rules.md definiert nicht verhandelbare Leitplanken für azure-upgrade, darunter:

• Destructive Action Policy – Der Agent darf keine Apps, Services, Resource Groups löschen oder DNS/Custom Domains ändern, ohne explizite Bestätigung via ask_user.
• User confirmation checks – Die Auswahl von Subscriptions oder Regionen, das Erstellen neuer Ressourcen und das Ändern von Netzwerkrestriktionen müssen explizit vom Nutzer freigegeben werden.
• Best Practices – Das Skill bevorzugt Managed Identities, moderne Runtimes und das Weiterbetreiben der ursprünglichen Ressource, bis die aktualisierte Ressource vollständig validiert ist.

Wenn Sie Workflows anpassen oder erweitern, sollten diese Regeln bestehen bleiben, damit Ihre Automatisierung auch in produktiven Umgebungen sicher bleibt.

5. Häufige Upgrade-Szenarien ausführen

Nach der Installation interagieren Sie über natürliche Sprache mit azure-upgrade – anhand von Intents, die den in SKILL.md definierten Triggern entsprechen. Mögliche Prompts an Ihren Agent sind zum Beispiel:

• "Assess if my function app is ready to move from Consumption to Flex Consumption."
• "Automate the upgrade of my Functions plan to Flex Consumption in the same resource group."
• "Help me migrate this App Service API to Azure Container Apps and validate it before cutover."
• "Change the hosting plan for this function app and document each step in upgrade-status.md."

Das Skill wird dann:

1. Ihre Absicht als Upgrade-Szenario interpretieren.
2. Die relevanten Szenario-Referenzen und global rules laden.
3. Azure MCP Tools für Dokumentation und Best-Practice-Checks nutzen.
4. Upgrade-Schritte vorschlagen oder generieren und vor jeder eingreifenden Änderung um Bestätigung bitten.

6. Übergabe an verwandte Skills

Nach einem erfolgreichen Upgrade und der Validierung unterstützt azure-upgrade eine saubere Übergabe an andere Azure-zentrierte Skills:

• azure-validate – für tiefere Validierung und Tests nach dem Upgrade.
• azure-deploy – um CI/CD-Pipelines rund um Ihre aktualisierten Ressourcen aufzubauen oder zu verbessern.

So bleibt azure-upgrade auf den Change-Management-Workflow fokussiert und fügt sich gleichzeitig in ein umfassenderes Automatisierungs-Ökosystem ein.

FAQ

Ist azure-upgrade für produktive Workloads geeignet?

Ja, azure-upgrade ist für den produktiven Einsatz konzipiert. Die global rules verlangen ausdrücklich:

• Phasenbasierte Ausführung (kein Überspringen des Assessments)
• Bestätigung für destructive oder irreversible Aktionen
• Weiterbetrieb der ursprünglichen App/des ursprünglichen Dienstes, bis die neue Version vollständig validiert ist

In Kombination mit Ihren eigenen Change-Management-Prozessen unterstützt das Skill sichere Upgrades in produktiven Umgebungen.

Unterstützt azure-upgrade Cloud-übergreifende Migrationen?

Nein. azure-upgrade konzentriert sich auf in-Azure Upgrades wie Plan-, Tier- und SKU-Änderungen oder Migrationen zwischen Azure-Diensten wie App Service und Container Apps. Für das Verschieben von Workloads zwischen Clouds sollten Sie ein dediziertes Migrations-Skill wie azure-cloud-migrate einsetzen.

Welche Azure-Dienste kann ich mit azure-upgrade upgraden?

Das Skill ist auf bestehende Workloads ausgerichtet, zum Beispiel:

• Azure Functions Apps (z. B. Consumption → Flex Consumption)
• Apps, die auf Azure App Service laufen
• Workloads, die Sie zu Azure Container Apps verschieben möchten

Da die zugrunde liegenden Regeln auf Pläne, Tiers und SKUs fokussieren, ist es besonders hilfreich, wenn Sie Hosting modernisieren oder die Kapazität für Backend-Services anpassen möchten.

Wie behält azure-upgrade den Überblick über erledigte Schritte?

Das Skill stützt sich auf eine upgrade-status.md-Datei in Ihrem Repository, wie in references/workflow-details.md beschrieben. Diese Datei hält fest:

• Zentrale Ressourcendetails
• Status der Phasenabschlüsse
• Fehler und Hinweise zur Behebung

Dieser einfache Mechanismus macht Upgrades auditierbar und leicht überprüfbar – auch dann, wenn mehrere Teammitglieder oder Agents beteiligt sind.

Löscht azure-upgrade meine ursprünglichen Ressourcen?

Nicht ohne explizite Zustimmung. references/global-rules.md definiert eine strikte Destructive Action Policy für:

• Löschen von Apps, Services oder Resource Groups
• Stoppen oder Deaktivieren ursprünglicher Services
• Änderungen an DNS- oder Custom-Domain-Bindings

All dies erfordert eine explizite Bestätigung via ask_user. Sie behalten die Kontrolle darüber, wann (oder ob) ursprüngliche Ressourcen nach einem erfolgreichen Upgrade außer Betrieb genommen werden.

Kann ich den azure-upgrade Workflow anpassen?

Sie können anpassen, wie Sie den Workflow nutzen (zum Beispiel indem Sie die Status-Datei mit eigenen Prozessen integrieren oder mit internen Tools kombinieren), aber die definierten Phasen und Sicherheitsregeln dienen dazu, Upgrades berechenbar und sicher zu halten. Wenn Sie azure-upgrade erweitern oder kapseln, sollten Sie beibehalten:

• Die Abfolge Identify → Assess → Pre-migrate → Upgrade → Validate
• Die global rules für destructive actions und Bestätigungen

So stellen Sie sicher, dass auch Ihre angepasste Automatisierung von den eingebauten Schutzmechanismen profitiert.

Wie passt azure-upgrade zu CI/CD-Pipelines?

azure-upgrade fokussiert sich auf einmalige oder periodische betrieblichen Änderungen an bestehenden Ressourcen. Nach Abschluss eines Upgrades und der Validierung kann es an azure-deploy übergeben, um:

• CI/CD-Pipelines zu konfigurieren oder zu aktualisieren
• Deployment-Workflows an den neuen Plan, das neue Tier oder den neuen Service anzupassen

Nutzen Sie azure-upgrade, um die Infrastrukturkonfiguration sicher zu ändern, und pipeline-orientierte Skills für die laufenden Deployments.

Was brauche ich, bevor ich azure-upgrade nutze?

Bevor Sie azure-upgrade ausführen, stellen Sie sicher, dass Sie verfügen über:

• Zugriff auf die Ziel-Azure-Subscription und Resource Group
• Klarheit über den gewünschten Ziel-Plan/Tier/SKU oder Ziel-Service (z. B. Container Apps)
• Eine Agent-Umgebung, die mit dem azure-upgrade Skill und den Azure MCP Tools konfiguriert ist

Wenn diese Informationen bereitstehen, kann der Agent die Phasen Identify und Assess schneller durchlaufen und Rückfragen minimieren.