Azure MCP Server-hulpprogramma's voor Azure Deploy

De Azure MCP-server helpt u bij het beheren van Azure Deploy-taken. Deze taken omvatten bewerkingen die architectuurdiagrammen genereren, app-logboeken ophalen, implementatieplannen ophalen, IaC-regels ophalen en pijplijnrichtlijnen bieden, allemaal via prompts in natuurlijke taal.

Azure Deploy is een set hulpprogramma's waarmee u implementaties in Azure-resources kunt plannen, valideren en bewaken. Zie de documentatie voor Azure Deploy voor meer informatie.

Note

Toolparameters: De hulpprogramma's van de Azure MCP Server definiëren parameters voor gegevens die ze nodig hebben om taken uit te voeren. Sommige van deze parameters zijn specifiek voor elk hulpprogramma en worden hieronder beschreven. Andere parameters zijn globaal en worden gedeeld door alle hulpprogramma's. Zie Hulpprogrammaparameters voor meer informatie.

App-logboeken ophalen

Dit hulpprogramma toont toepassingslogboeken voor toepassingen die door de Azure Developer CLI (azd) worden geïmplementeerd. Met dit hulpprogramma wordt een query uitgevoerd op de Log Analytics-werkruimte van de toepassing voor Azure Container Apps, Azure App Service en Azure Functions. De werkruimte en de bijbehorende resources worden automatisch gedetecteerd vanuit de configuratie van de azd-omgeving. Het werkt alleen voor toepassingen die zijn geïmplementeerd door azd up.

Controleer de implementatiestatus of los problemen na de implementatie op.

Voorbeelden van prompts zijn:

  • Toon het logboek van de toepassing die is geïmplementeerd door azd voor de Azd-omgevingsnaam 'dev' en de werkruimtemap '/home/alice/projects/my-app'.
Kenmerk Verplicht of optioneel Description
AZD env-naam Verplicht De omgevingsnaam die is gemaakt door de Azure Developer CLI (azd) en die is opgeslagen in AZURE_ENV_NAME tijdens azd init of azd up. Als het hulpprogramma niet in context is opgegeven, wordt de .azure map in de werkruimte gecontroleerd, of azd env list uitgevoerd.
Werkruimtemap Verplicht Het volledige pad naar de werkruimtemap die het azd-project bevat.
Limiet Optioneel Het maximum aantal logboekrijen dat moet worden opgehaald. Gebruik deze om resultaten te beperken of te voorkomen dat de tokenlimieten worden overschreden. De standaardwaarde is 200.

Hints voor aantekening van hulpprogramma's:

Destructief: ❌ | Idempotent: ✅ | Open wereld: ❌ | Alleen-lezen: ✅ | Geheim: ❌ | Lokaal vereist: ❌

Architectuurdiagram genereren

Dit hulpprogramma maakt deel uit van de MCP-toolset (Model Context Protocol). Er wordt een diagram van de Azure-servicearchitectuur gegenereerd waarin aanbevolen Azure-services en de bijbehorende logische verbindingen voor een toepassing worden weergegeven. Met dit hulpprogramma wordt het diagram van een toepassingstopologie (AppTopology) weergegeven als invoer. U geeft een AppTopology op waarmee services, rekenhosts, afhankelijkheden en omgevingsinstellingen worden beschreven. U kunt de AppTopology bouwen door de werkruimte te scannen om services, frameworks en omgevingsvariabelen te detecteren voor verbindingsreeksen. Voor .NET Aspire-toepassingen, aspireManifest.json opnemen. Het diagram is gericht op serviceselectie en verbindingen. Er wordt geen gedetailleerd netwerktopologie of beveiligingsontwerp weergegeven.

Voorbeelden van prompts zijn:

  • Genereer het Azure-architectuurdiagram voor deze toepassing ruwe MCP-toolinvoer '<secure-password>'.
Kenmerk Verplicht of optioneel Description
Onbewerkte mcp tool-invoer Verplicht JSON-object waarmee de invoerstructuur voor dit hulpprogramma wordt gedefinieerd.

Hints voor aantekening van hulpprogramma's:

Destructief: ❌ | Idempotent: ✅ | Open wereld: ❌ | Alleen-lezen: ✅ | Geheim: ❌ | Lokaal vereist: ❌

IaC-regels ophalen

Hiermee worden regels en aanbevolen procedures opgehaald voor het maken van Bicep- en Terraform Infrastructure as Code-bestanden (IaC) om Azure-toepassingen te implementeren. Dit MCP-hulpprogramma (Model Context Protocol) retourneert richtlijnen voor azure-resourceconfiguratiestandaarden, compatibiliteit met Azure Developer CLI (azd) en Azure CLI, en algemene IaC-kwaliteitsvereisten. Gebruik de richtlijnen om Bicep-scripts en Terraform-sjablonen voor Azure-resources te verbeteren en implementaties af te stemmen op best practices voor Azure.

Voorbeelden van prompts zijn:

  • "Toon me de regels en best practices voor het schrijven van Bicep en Terraform IaC voor Azure met behulp van het implementatiehulpprogramma 'AzCli'.
Kenmerk Verplicht of optioneel Description
Implementatieprogramma Verplicht Het implementatieprogramma dat moet worden gebruikt. Geldige waarden: AzCli, AZD.
IaC type Optioneel Het type IaC-bestand dat wordt gebruikt voor implementatie. Geldige waarden zijn , bicepterraform. Laat alleen leeg als u een Azure CLI-opdrachtscript zonder IaC-bestand wilt gebruiken.
Resourcetypen Optioneel Lijst met Azure-resourcetypen voor het genereren van regels. Haal de waarde op uit de context en gebruik dezelfde resources die in het plan zijn gedefinieerd. Geldige waarde: appservice,containerapp,function,aks,azuredatabaseforpostgresql,azuredatabaseformysql,azuresqldatabase,,azurecosmosdb,,,azurestorageaccount.azurekeyvault

Hints voor aantekening van hulpprogramma's:

Destructief: ❌ | Idempotent: ✅ | Open wereld: ❌ | Alleen-lezen: ✅ | Geheim: ❌ | Lokaal vereist: ❌

Examples

  • Geef IaC-regels op voor Bicep en Terraform voor Azure App Service en Azure SQL Database: 'Haal regels op voor het implementatietool 'AZD' en IaC-type 'bicep' voor resources 'appservice', 'azuresqldatabase'.
  • Best practices weergeven voor een Terraform-sjabloon die Azure Kubernetes Service en Azure Key Vault implementeert: 'Regels ophalen voor implementatiegereedschap 'AzCli' en IaC-type 'terraform' voor resources 'aks', 'azurekeyvault'.
  • Vraag om algemene IaC-kwaliteitscontroles zonder een IaC-bestand met behulp van een AzCli-script: 'Haal regels op voor het implementatiehulpmiddel 'AzCli' en laat het IaC-type leeg voor bronnen 'azurestorageaccount'.

Verkrijg pijplijnrichtlijnen

Met dit MCP-hulpprogramma (Model Context Protocol) worden configuratie van CI/CD-pijplijnen en stapsgewijze richtlijnen gegenereerd voor het implementeren van een toepassing in Azure met behulp van GitHub Actions of Azure DevOps-pijplijnen. Azure Developer CLI (azd) en Op Azure CLI gebaseerde implementaties worden ondersteund. Het kan pijplijnen genereren die infrastructuur inrichten en toepassingscode implementeren.

U kunt GitHub Actions of Azure DevOps kiezen, bepalen of de pijplijn alleen infrastructuur moet implementeren of inrichten en of het project azd gebruikt (bijvoorbeeld een azure.yaml bestand aanwezig is). Geef deploy-only of provision-and-deploy op, en stel Is azd project in op true alleen als het project azd-tooling gebruikt en er een azure.yaml-bestand beschikbaar is.

Voorbeelden van prompts zijn:

  • Hoe stel ik een CI/CD-pijplijn in met GitHub Actions om mijn app in Azure te implementeren, met de optie 'deploy-only', aangezien het geen AZD-project is en het pijplijnplatform 'github-actions' is?
Kenmerk Verplicht of optioneel Description
Implementatieoptie Verplicht Geldige waarden: alleen implementeren, inrichten en implementeren. Standaard instellen op alleen implementeren. provision-and-deploy Alleen instellen als u expliciet een infrastructuurinrichtingspijplijn wilt die gebruikmaakt van lokale inrichtingsscripts.
Is AZD-project Verplicht Of u het AZD-hulpprogramma in de implementatiepijplijn wilt gebruiken. Ingesteld op true alleen als azure.yaml is opgegeven of als de context AZD-hulpprogramma's suggereert.
Pijplijnplatform Verplicht Het platform voor de implementatiepijplijn. Geldige waarden: github-actions, azure-devops.

Hints voor aantekening van hulpprogramma's:

Destructief: ❌ | Idempotent: ✅ | Open wereld: ❌ | Alleen-lezen: ✅ | Geheim: ❌ | Lokaal vereist: ❌

Implementatieplan ophalen

Hiermee genereert u een opgemaakt, stapsgewijs implementatieplan voor een toepassing naar Azure. Dit hulpprogramma, onderdeel van het Model Context Protocol (MCP), stelt Azure-resources voor, biedt sjablonen voor infrastructuur als code (IaC) en vermeldt implementatiestappen op basis van een doelhostingservice en een gekozen inrichtingsprogramma. Doelhostingservices zijn bijvoorbeeld Azure Container Apps, Azure App Service of Azure Kubernetes Service (AKS). Voor inrichtingshulpprogramma's zijn voorbeelden Azure Developer CLI (azd), Azure CLI met Bicep of Terraform.

Met dit hulpprogramma wordt uw werkruimte niet gescand of worden resources automatisch gedetecteerd. U analyseert het project, bepaalt frameworks, afhankelijkheden en bestaande resources, kiest de hostingservice en het inrichtingsprogramma en geeft deze waarden op om het plan te genereren.

Voorbeelden van prompts zijn:

  • "Hoe maak ik een stapsgewijs implementatieplan voor projectnaam 'my-webapp' in Azure met implementatieoptie 'provision-and-deploy', provisioning tool 'AZD', brontype 'from-project', target app service 'WebApp', werkruimtemap '/home/dev/my-webapp' en IaC options 'bicep'?
Kenmerk Verplicht of optioneel Description
Implementatieoptie Verplicht Stel de waarde in op basis van project- en gebruikersinvoer. Geldige waarden: provision-and-deploy, deploy-only, provision-only. Kies deploy-only wanneer u implementeert in bestaande Azure-resources of wanneer er al IaC-bestanden bestaan. Kies provision-only wanneer u alleen Azure-resources wilt inrichten. Kies provision-and-deploy wanneer u infrastructuur wilt inrichten en de toepassing wilt implementeren.
Projectnaam Verplicht De naam van het project waarvoor het implementatieplan moet worden gegenereerd. Als u geen projectnaam opgeeft, wordt deze afgeleid door het hulpprogramma uit de werkruimte.
Provisioning-tool Verplicht Het hulpprogramma dat moet worden gebruikt voor het inrichten van Azure-resources. Geldige waarden: AzCli, AZD. Bijvoorbeeld Azure Developer CLI (azd) of Azure CLI met Bicep.
Brontype Verplicht De bron van het plan waaruit moet worden gegenereerd. Geldige waarden: from-project, from-azure, from-context. Gebruik from-project dit om het plan te baseren op projectbestanden in de werkruimte. Gebruik from-azure dit om het plan te baseren op bestaande Azure-resources. Gebruik from-context dit om het plan te baseren op waarden die u opgeeft wanneer er geen projectbestanden of Azure-resources bestaan.
Doel-app-service Verplicht De Azure-service om de toepassing te implementeren. Geldige waarden: ContainerApp, WebApp, FunctionApp, . AKS Raad er een aan op basis van de toepassingsarchitectuur en runtime.
Werkruimtemap Verplicht Het volledige pad van de werkruimtemap.
IaC-opties Optioneel De optie Infrastructuur als code. Geldige waarden: bicep, terraform. Laat leeg om een Azure CLI-script te gebruiken.
Resourcegroep Optioneel De naam van de Azure-resourcegroep.

Hints voor aantekening van hulpprogramma's:

Destructief: ❌ | Idempotent: ✅ | Open wereld: ❌ | Alleen-lezen: ✅ | Geheim: ❌ | Lokaal vereist: ❌

Verwante inhoud

  • Last updated on