Erste Schritte mit Azure Fähigkeiten

In dieser Schnellstartanleitung bereiten Sie mithilfe von Azure Fähigkeiten eine Anwendung für Azure vor, überprüfen und bereitstellen.

Voraussetzungen

• Azure Fähigkeiten installiert (Installieren und Konfigurieren Azure Fähigkeiten)
• Azure CLI authentifiziert (az login erfolgreich abgeschlossen)
• GitHub Copilot CLI oder Claude Code einsatzbereit
• Beispielanwendung (oder Erstellen einer Node.js-App)

Szenario

Sie haben eine Node.js Anwendung. Sie möchten sie für Azure bereitstellen mit:

• Webanwendungshosting (Azure App Service)
• Ein Speicherkonto für Anwendungsdaten
• Überwachung mit Application Insights

Vorbereiten der Anwendung

Wechseln Sie in Ihrem KI-Assistenten zu Ihrem Projektverzeichnis, und fragen Sie Folgendes:

Prepare my application for Azure deployment

Die azure-prepare Fähigkeit:

1. Analysiert Ihre Codebasis
2. Identifiziert Technologiestapel (Node.js, npm usw.)
3. Erstellt .azure/plan.md mit einer Bereitstellungsstrategie
4. Generiert Infrastruktur als Code
5. Wartet auf Ihre Genehmigung

Überprüfen des generierten Plans

Öffnen .azure/plan.md und überprüfen:

• Project Information – Anwendungsname und Bereitstellungsmodus
• Anforderungen – Klassifizierung und Skalierung (klein, mittel, groß)
• Komponenten – Technologien erkannt
• Deployment Strategy – Technologie für die Bereitstellung Ihrer Anwendung (Azure Developer CLI, Bicep, Terraform oder Azure CLI).
• Architecture – Azure-Dienste ausgewählt
• Implementierungsplan – Schritt-für-Schritt-Aufgaben

Beispielplaninhalt:

# Azure Deployment Plan

## Project Information
- Application: my-app
- Mode: NEW

## Requirements
- Classification: Web Application
- Scale: Small
- Environment: Production

## Components
- Runtime: Node.js 18+
- Package Manager: NPM
- Application Type: Express web server

## Recipe
- Type: AZD (Azure Developer CLI)

## Azure Services
- Azure App Service (web app hosting)
- Azure Storage Account (data)
- Application Insights (monitoring)

## Status: Awaiting Approval

Genehmigen des Plans

Wenn der Plan richtig aussieht, teilen Sie Ihrem KI-Assistenten mit:

Approve this plan and proceed to validation

Die Funktion aktualisiert den Planstatus auf Approved und wechselt zum nächsten Schritt.

Überprüfen des Bereitstellungsplans

Ihr KI-Assistent führt die azure-validate Fähigkeit aus, folgendes zu überprüfen:

• Azure CLI Zugriff und Berechtigungen
• Bicep- oder Terraform-Vorlagensyntax, falls zutreffend
• Azure-Abonnement und Verfügbarkeit in Regionen
• Dienstkontingentbeschränkungen
• Erforderliche Berechtigungen für Ihr Konto

Die Überprüfung endet und zeichnet den Nachweis aller Prüfungen im Plan auf. Der Planstatus wird aktualisiert auf Validated.

Überprüfen der Validierungsergebnisse

Überprüfen Sie .azure/plan.md den Abschnitt "Überprüfungsnachweis ", in dem Folgendes angezeigt wird:

• Ausgeführte Befehle
• Zeitstempel
• Ergebnisse (bestanden oder fehlgeschlagen)

Beispiel:

## Validation Proof
- Command: azd provision --preview
- Timestamp: 2026-03-16T14:22:00Z
- Result: ✓ All validation checks passed

Wenn die Überprüfung fehlschlägt, überprüfen Sie Fehler, und bitten Sie Ihren KI-Assistenten, Probleme zu beheben:

Fix the validation errors and try again

Bereitstellen auf Azure

Wenn Ihr Plan überprüft wird, teilen Sie Ihrem KI-Assistenten mit:

Deploy my application to Azure

Die azure-deploy Fähigkeit:

1. Bestätigt, dass der Planstatus Validated ist
2. Stellt Azure-Ressourcen (Speicher, App Service, Überwachung) bereit
3. Stellt Ihren Anwendungscode bereit
4. Konfiguriert Anwendungseinstellungen
5. Stellt Ihren Anwendungsendpunkt bereit.

Die Bereitstellung dauert in der Regel 3 bis 5 Minuten.

Sehen Sie sich Ihre bereitgestellte Anwendung an

Nach erfolgreicher Bereitstellung bietet Ihr KI-Assistent Folgendes:

• Anwendungs-URL (für App Service)
• Speicherkontoname und Zugriffstasten
• Application Insights-Instrumentierungsschlüssel

Beispiel:

Deployment complete! 

Your app is live at: https://my-app-abcd1234.azurewebsites.net

Resources deployed:
- App Service: my-app-prod
- Storage Account: mystorageabcd1234
- Application Insights: my-app-insights

Monitor your app: https://portal.azure.com/...

Um zu überprüfen, ob Ihre App ausgeführt wird, besuchen Sie ihre Anwendungs-URL in einem Browser.

Überprüfen Sie Ihre Bereitstellung

Testen Sie Ihre Anwendung:

1. Besuchen Sie Ihre URL – Öffnen Sie die Anwendungs-URL in einem Browser.
2. Überwachung überprüfen – Anzeigen von Protokollen in Application Insights.
3. Testen Sie die Funktionalität– Verwenden Sie die wichtigsten Features Ihrer App.

Bitten Sie Ihren KI-Assistenten um Überwachungsstatus:

Show me the application logs and performance metrics

Ihr KI-Assistent fragt Application Insights ab und zeigt aktuelle Aktivitäts-, Fehler- und Leistungsdaten an.

Aktualisieren und erneutes Bereitstellen

Wenn Sie Codeänderungen vornehmen, können Sie diese einfach erneut bereitstellen.

1. Aktualisieren Sie Ihren Code in Ihrem Editor.

2. Fragen Sie Ihren KI-Assistenten:

   Update the deployment with my latest changes
   

3. Die Fähigkeit wird ausgeführt, um nach Änderungen zu suchen azure-prepare und anschließend Ihre Ressourcen zu aktualisieren azure-deploy.

Aktualisierte Ressourcen verwenden vorhandene Infrastruktur wieder. Nur geänderte Komponenten werden erneut bereitgestellt.

Bereinigen von Ressourcen

Wenn Sie Ihre Anwendung nicht mehr benötigen, löschen Sie Azure Ressourcen, um Gebühren zu vermeiden:

Delete all Azure resources for this application

Ihr KI-Assistent:

1. Listet ressourcen auf, die gelöscht werden sollen (für Ihre Bestätigung)
2. Löscht die Ressourcengruppe und alle Inhalte.
3. Bestätigt, dass die Bereinigung abgeschlossen ist.

Beispiel:

Resources to delete:
- Resource Group: my-app-rg
- All contained resources

Are you sure? (yes/no)

Geben Sie yes ein, um die Löschung zu bestätigen.

Problembehandlung

Bereitstellung wegen Authentifizierungsfehler fehlgeschlagen

Problem: Ihr KI-Assistent kann sich nicht bei Azure authentifizieren.

Lösung: Authentifizieren Sie sich erneut über az login und versuchen Sie es erneut.

Fehler bei der Planüberprüfung

Problem: Azure Fähigkeiten meldet Validierungsfehler.

Lösung: Bitten Sie Ihren KI-Assistenten, Probleme zu überprüfen und zu beheben:

Why did validation fail? Fix the errors.

Anwendung nach der Bereitstellung nicht zugänglich

Problem: Die bereitgestellte URL gibt einen Fehler oder ein Zeitüberschreitung zurück.

Lösung:

1. Überprüfen Sie, ob die URL korrekt ist.

2. Warten Sie 1 bis 2 Minuten auf die DNS-Verteilung.

3. Überprüfen Sie Application Insights-Protokolle auf Fehler.

   Show me recent errors in Application Insights
   

Nächste Schritte

• Azure Model Context Protocol (MCP)-Serverdokumentation – Tiefere technische Details