Azure MCP Server-Tools für Azure Deploy

Der Azure MCP-Server hilft Ihnen beim Verwalten von Azure Deploy-Aufgaben. Zu diesen Aufgaben gehören Vorgänge, die Architekturdiagramme generieren, App-Protokolle abrufen, Bereitstellungspläne abrufen, IaC-Regeln abrufen und Pipelineanleitungen bereitstellen, und zwar über Anweisungen in natürlicher Sprache.

Azure Deploy ist eine Reihe von Tools, mit denen Sie Bereitstellungen für Azure-Ressourcen planen, überprüfen und überwachen können. Weitere Informationen finden Sie in der Azure Deploy-Dokumentation.

Anmerkung

Toolparameter: Die Azure MCP Server-Tools definieren Parameter für Daten, die sie zum Ausführen von Aufgaben benötigen. Einige dieser Parameter sind für jedes Tool spezifisch und werden unten dokumentiert. Andere Parameter sind global und werden von allen Tools gemeinsam genutzt. Weitere Informationen finden Sie unter Toolparameter.

Abrufen von App-Protokollen

Dieses Tool zeigt Anwendungsprotokolle für Anwendungen an, die von der Azure Developer CLI (azd) bereitgestellt werden. Dieses Tool fragt den Log Analytics-Arbeitsbereich der Anwendung für Azure-Container-Apps, Azure App Service und Azure-Funktionen ab. Er ermittelt automatisch den Arbeitsbereich und die zugeordneten Ressourcen aus der Azd-Umgebungskonfiguration. Es funktioniert nur für Anwendungen, die von azd up bereitgestellt werden.

Überprüfen Sie den Bereitstellungsstatus oder beheben Sie Probleme nach der Bereitstellung.

Beispiele für Prompts:

  • Zeigen Sie mir das Protokoll der Anwendung, die von azd für den Azd-Umgebungsnamen 'dev' und den Arbeitsbereich-Ordner '/home/alice/projects/meine-app' bereitgestellt wurde.
Parameter Erforderlich oder optional Description
AZD-env-Name Erforderlich Der Umgebungsname, der von der Azure Developer CLI (azd) erstellt und während azd init oder azd up in AZURE_ENV_NAME gespeichert wird. Wenn es nicht im Kontext bereitgestellt wird, überprüft dieses Tool das .azure-Verzeichnis im Arbeitsbereich oder führt azd env list aus.
Arbeitsbereichsordner Erforderlich Der vollständige Pfad zum Arbeitsbereichsordner, der das azd-Projekt enthält.
Begrenzung Wahlfrei Die maximale Anzahl der abzurufenden Protokollzeilen. Verwenden Sie sie, um Ergebnisse zu begrenzen oder das Überschreiten von Token-Limits zu vermeiden. Der Standardwert ist 200.

Hinweise zur Werkzeugkommentierung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheim: ❌ | Lokal erforderlich: ❌

Architekturdiagramm generieren

Dieses Tool ist Teil des MCP-Toolsets (Model Context Protocol). Es generiert ein Azure-Dienstarchitekturdiagramm, das empfohlene Azure-Dienste und ihre logischen Verbindungen für eine Anwendung zeigt. Dieses Tool rendert das Diagramm aus einer Anwendungstopologie (AppTopology), die als Eingabe bereitgestellt wird. Sie stellen eine AppTopology bereit, die Dienste, Computehosts, Abhängigkeiten und Umgebungseinstellungen beschreibt. Sie können die AppTopology erstellen, indem Sie den Arbeitsbereich überprüfen, um Dienste, Frameworks und Umgebungsvariablen für Verbindungszeichenfolgen zu erkennen. Für .NET Aspire-Anwendungen schließen Sie aspireManifest.json ein. Das Diagramm konzentriert sich auf die Dienstauswahl und -verbindungen. Es werden keine detaillierte Netzwerktopologie oder Sicherheitsdesigns angezeigt.

Beispiele für Prompts:

  • Generieren Sie das Diagramm der Azure-Architektur für diese rohe MCP-Tool-Eingabe "<secure-password>".
Parameter Erforderlich oder optional Description
Unformatierte Mcp-Tooleingabe Erforderlich JSON-Objekt, das die Eingabestruktur für dieses Tool definiert.

Hinweise zur Werkzeugkommentierung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheim: ❌ | Lokal erforderlich: ❌

Abrufen von IaC-Regeln

Ruft Regeln und bewährte Praktiken zum Erstellen von Bicep- und Terraform-Infrastrukturdefinitionen als Code (IaC) zur Bereitstellung von Azure-Anwendungen ab. Dieses McP-Tool (Model Context Protocol) gibt Anleitungen zu Azure-Ressourcenkonfigurationsstandards, Kompatibilität mit Azure Developer CLI (azd) und Azure CLI sowie allgemeine IaC-Qualitätsanforderungen zurück. Verwenden Sie die Anleitung, um Bicep-Skripts und Terraform-Vorlagen für Azure-Ressourcen zu verbessern und Bereitstellungen mit bewährten Azure-Methoden auszurichten.

Beispiele für Prompts:

  • Zeigen Sie mir die Regeln und bewährten Methoden zum Schreiben von Bicep und Terraform IaC für Azure mithilfe des Bereitstellungstools "Azure CLI".
Parameter Erforderlich oder optional Description
Bereitstellungstool Erforderlich Das zu verwendende Bereitstellungstool. Gültige Werte: AzCli, AZD.
IaC-Typ Wahlfrei Der Typ der IaC-Datei, die für die Bereitstellung verwendet wird. Gültige Werte sind bicep, terraform. Lassen Sie nur leer, wenn Sie das Azure CLI-Befehlsskript ohne IaC-Datei verwenden möchten.
Ressourcentypen Wahlfrei Liste der Azure-Ressourcentypen, für die Regeln generiert werden sollen. Rufen Sie den Wert aus dem Kontext ab, und verwenden Sie die gleichen Ressourcen, die im Plan definiert sind. Gültiger Wert: appservice,,,containerapp,,function,aks,azuredatabaseforpostgresql,azuredatabaseformysqlazuresqldatabase,,.azurecosmosdbazurestorageaccountazurekeyvault

Hinweise zur Werkzeugkommentierung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheim: ❌ | Lokal erforderlich: ❌

Examples

  • Bereitstellen von IaC-Regeln für Bicep und Terraform für Azure App Service und Azure SQL-Datenbank: "Abrufen von Regeln für das Bereitstellungstool 'AZD' und IaC-Typ 'bicep' für Ressourcen 'appservice','azuresqldatabase'".
  • Zeigen Sie bewährte Methoden für eine Terraform-Vorlage an, die Azure Kubernetes Service und Azure Key Vault bereitstellt: "Regeln für das Bereitstellungstool 'AzCli' und den IaC-Typ 'terraform' für Ressourcen 'aks','azurekeyvault'" abrufen.
  • Fordern Sie allgemeine IaC-Qualitätsprüfungen ohne eine IaC-Datei an, indem Sie ein AzCli-Skript verwenden: "Regeln für das Bereitstellungstool 'AzCli' abrufen und den IaC-Typ für Ressourcen 'azurestorageaccount' leer lassen".

Pipeline-Anleitungen erhalten

Dieses McP-Tool (Model Context Protocol) generiert eine CI/CD-Pipelinekonfiguration und schrittweise Anleitungen zum Bereitstellen einer Anwendung in Azure mithilfe von GitHub-Aktionen oder Azure DevOps-Pipelines. Es unterstützt Azure Developer CLI (azd) und Azure CLI-basierte Bereitstellungen. Sie kann Pipelines generieren, die Infrastruktur bereitstellen und Anwendungscode einsetzen.

Sie können GitHub Actions oder Azure DevOps auswählen und entscheiden, ob die Pipeline nur implementieren oder zusätzlich die Infrastruktur bereitstellen soll. Bestätigen Sie außerdem, ob das Projekt azd verwendet (z. B. ist eine azure.yaml-Datei vorhanden). Geben Sie \ oder \ an, und legen Sie \ auf \ fest, nur wenn das Projekt azd-Tooling verwendet und eine azure.yaml-Datei verfügbar ist.

Beispiele für Prompts:

  • "Wie kann ich eine CI/CD-Pipeline mit GitHub Actions einrichten, um meine App in Azure bereitzustellen, mit der Option "Nur bereitstellen", es handelt sich nicht um ein AZD-Projekt und die Pipelineplattform "github-actions"?"
Parameter Erforderlich oder optional Description
Bereitstellungsoption Erforderlich Gültige Werte: deploy-only, provision-and-deploy. Standardmäßig auf 'nur bereitstellen' setzen. Legen Sie provision-and-deploy nur fest, wenn Sie explizit eine Infrastrukturbereitstellungspipeline wünschen, die lokale Bereitstellungsskripts verwendet.
Ist das AZD-Projekt Erforderlich Gibt an, ob das AZD-Tool in der Bereitstellungspipeline verwendet werden soll. true Wird nur festgelegt, wenn azure.yaml vorhanden ist oder der Kontext AZD-Tools vorschlägt.
Pipelineplattform Erforderlich Die Plattform für die Bereitstellungspipeline. Gültige Werte: github-actions, azure-devops.

Hinweise zur Werkzeugkommentierung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheim: ❌ | Lokal erforderlich: ❌

Bereitstellungsplan abrufen

Generiert einen formatierten, schrittweisen Bereitstellungsplan für eine Anwendung in Azure. Dieses Tool, Teil des Model Context Protocol (MCP), schlägt Azure-Ressourcen vor, stellt Infrastruktur als Codevorlagen (IaC) bereit und listet Bereitstellungsschritte basierend auf einem Zielhostingdienst und einem ausgewählten Bereitstellungstool auf. Beispielsweise umfassen Zielhostingdienste Azure Container-Apps, Azure App Service oder Azure Kubernetes Service (AKS). Beispiele für Bereitstellungstools sind Azure Developer CLI (azd), Azure CLI mit Bicep oder Terraform.

Mit diesem Tool wird Ihr Arbeitsbereich nicht überprüft oder Ressourcen automatisch erkannt. Sie analysieren das Projekt, bestimmen Frameworks, Abhängigkeiten und vorhandene Ressourcen, wählen den Hostingdienst und das Bereitstellungstool aus und stellen dann diese Werte bereit, um den Plan zu generieren.

Beispiele für Prompts:

  • Wie erstelle ich einen Schritt-für-Schritt-Bereitstellungsplan für das Projekt "my-webapp" in Azure mit der Bereitstellungsoption "bereitstellen-und-provisionieren", dem Bereitstellungstool 'AZD', dem Quelltyp 'vom Projekt', dem App-Dienst 'WebApp', dem Arbeitsordner '/home/dev/my-webapp' und den IaC-Optionen 'bicep'?
Parameter Erforderlich oder optional Description
Option "Bereitstellen" Erforderlich Legen Sie den Wert basierend auf Projekt- und Benutzereingaben fest. Gültige Werte: provision-and-deploy, deploy-only, provision-only. Wählen Sie deploy-only aus, wenn Sie zu vorhandenen Azure-Ressourcen bereitstellen oder wenn IaC-Dateien bereits existieren. Wählen Sie provision-only aus, wann Sie nur Azure-Ressourcen bereitstellen möchten. Wählen Sie provision-and-deploy aus, wann Sie die Infrastruktur bereitstellen und die Anwendung bereitstellen möchten.
Projektname Erforderlich Der Name des Projekts, für das der Bereitstellungsplan generiert werden soll. Wenn Sie keinen Projektnamen angeben, leitet das Tool ihn aus dem Arbeitsbereich ab.
Bereitstellungstool Erforderlich Das Tool, das für die Bereitstellung von Azure-Ressourcen verwendet werden soll. Gültige Werte: AzCli, AZD. Beispielsweise Azure Developer CLI (azd) oder Azure CLI mit Bicep.
Quellentyp Erforderlich Die Quelle, von der der Plan generiert werden soll. Gültige Werte: from-project, from-azure, from-context. Verwenden Sie from-project, um den Plan auf Projektdateien im Arbeitsbereich zu basieren. Verwenden Sie from-azure, um den Plan auf vorhandenen Azure-Ressourcen zu basieren. Verwenden Sie from-context, um den Plan auf von Ihnen angegebenen Werten zu basieren, wenn keine Projektdateien oder Azure-Ressourcen vorhanden sind.
Ziel-App-Dienst Erforderlich Der Azure-Dienst zum Bereitstellen der Anwendung. Gültige Werte: ContainerApp, WebApp, FunctionApp, . AKS Empfehlen Sie eine basierend auf der Anwendungsarchitektur und Laufzeit.
Arbeitsbereichsordner Erforderlich Der vollständige Pfad des Arbeitsbereichsordners.
IaC-Optionen Wahlfrei Die Option "Infrastruktur als Code". Gültige Werte: bicep, terraform. Lassen Sie leer, um ein Azure CLI-Skript zu verwenden.
Ressourcengruppe Wahlfrei Der Name der Azure-Ressourcengruppe.

Hinweise zur Werkzeugkommentierung:

Destruktiv: ❌ | Idempotent: ✅ | Offene Welt: ❌ | Schreibgeschützt: ✅ | Geheim: ❌ | Lokal erforderlich: ❌

Verwandte Inhalte

  • Last updated on