Nota
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare ad accedere o modificare le directory.
L'accesso a questa pagina richiede l'autorizzazione. È possibile provare a modificare le directory.
Il server MCP di Azure consente di gestire le attività di distribuzione di Azure. Queste attività includono operazioni che generano diagrammi di architettura, recuperano i log delle app, i piani di distribuzione, recuperano le regole IaC e forniscono indicazioni sulla pipeline, tutto tramite prompt in linguaggio naturale.
Distribuzione di Azure è un set di strumenti che consentono di pianificare, convalidare e monitorare le distribuzioni nelle risorse di Azure. Per altre informazioni, vedere la documentazione relativa alla distribuzione di Azure.
Nota
Parametri degli strumenti: gli strumenti del server MCP di Azure definiscono i parametri per i dati necessari per completare le attività. Alcuni di questi parametri sono specifici di ogni strumento e sono documentati di seguito. Altri parametri sono globali e condivisi da tutti gli strumenti. Per altre informazioni, vedere Parametri degli strumenti.
Ottenere i log delle app
Questo strumento mostra i log delle applicazioni per le applicazioni distribuite dalla CLI di Azure per sviluppatori (azd). Questo strumento esegue una query sull'area di lavoro Log Analytics dell'applicazione per App Contenitore di Azure, Servizio app di Azure e Funzioni di Azure. Individua automaticamente l'area di lavoro e le risorse associate dalla configurazione dell'ambiente azd. Funziona solo per le applicazioni distribuite da azd up.
Controllare lo stato della distribuzione o risolvere i problemi di post-distribuzione.
Alcuni prompt di esempio includono:
- "Mostra il log dell'applicazione distribuita da azd per il nome azd env 'dev' e la cartella dell'area di lavoro '/home/alice/projects/my-app'".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| AZD env name | Obbligatorio | Nome dell'ambiente creato dall'interfaccia della riga di comando per sviluppatori di Azure (azd) e archiviato in AZURE_ENV_NAME durante azd init o azd up. Se non specificato nel contesto, questo strumento controlla la .azure directory nell'area di lavoro o esegue azd env list. |
| Cartella dell'area di lavoro | Obbligatorio | Percorso completo della cartella dell'area di lavoro che contiene il progetto azd. |
| Limit | Opzionale | Numero massimo di righe di log da recuperare. Usarlo per limitare i risultati o evitare di superare i limiti dei token. Il valore predefinito è 200. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Generare un diagramma dell'architettura
Questo strumento fa parte del set di strumenti MCP (Model Context Protocol). Genera un diagramma dell'architettura dei servizi di Azure che mostra i servizi di Azure consigliati e le relative connessioni logiche per un'applicazione. Questo strumento esegue il rendering del diagramma da una topologia dell'applicazione (AppTopology) fornita come input. Si fornisce una topologia AppTopology che descrive i servizi, gli host di calcolo, le dipendenze e le impostazioni dell'ambiente. È possibile compilare la topologia AppTopology analizzando l'area di lavoro per rilevare servizi, framework e variabili di ambiente per le stringhe di connessione. Per le applicazioni .NET Aspire, includere aspireManifest.json. Il diagramma è incentrato sulla selezione dei servizi e sulle connessioni. Non mostra la topologia di rete dettagliata o la progettazione della sicurezza.
Alcuni prompt di esempio includono:
- "Generare il diagramma dell'architettura di Azure per l'input dello strumento MCP non elaborato dell'applicazione "<secure-password>".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Input dello strumento MCP non elaborato | Obbligatorio | Oggetto JSON che definisce la struttura di input per questo strumento. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Ottenere le regole IaC
Recupera regole e procedure consigliate per la creazione di file Bicep e Terraform Infrastructure as Code (IaC) per distribuire applicazioni Azure. Questo strumento MCP (Model Context Protocol) restituisce indicazioni sugli standard di configurazione delle risorse di Azure, sulla compatibilità con l'interfaccia della riga di comando di Azure (azd) e sull'interfaccia della riga di comando di Azure e sui requisiti di qualità IaC generali. Usare le indicazioni per migliorare gli script Bicep e i modelli Terraform per le risorse di Azure e per allineare le distribuzioni alle procedure consigliate di Azure.
Alcuni prompt di esempio includono:
- Mostrami le regole e le procedure consigliate per la scrittura di Bicep e Terraform IaC per Azure utilizzando lo strumento di distribuzione "AzCli".
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Strumento di distribuzione | Obbligatorio | Strumento di distribuzione da usare. Valori validi: AzCli, AZD. |
| Tipo IaC | Opzionale | Tipo di file IaC usato per la distribuzione. I valori validi includono bicep, terraform. Lasciare vuoto solo se si vuole usare lo script di comando della CLI di Azure senza il file IaC. |
| Tipi di risorse | Opzionale | Elenco dei tipi di risorse di Azure per cui generare regole. Ottenere il valore dal contesto e usare le stesse risorse definite nel piano. Valore valido: appservice,containerapp,function,aks,azuredatabaseforpostgresql,azuredatabaseformysql,azuresqldatabase,,azurecosmosdb,,azurestorageaccount .azurekeyvault |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Examples
- Specificare le regole IaC per Bicep e Terraform per il servizio app di Azure e il database SQL di Azure: "Ottenere le regole per lo strumento di distribuzione 'AZD' e il tipo IaC 'bicep' per le risorse 'appservice','azuresqldatabase'".
- Mostrare le procedure consigliate per un modello Terraform che distribuisce il servizio Azure Kubernetes e Azure Key Vault: "Ottenere le regole per lo strumento di distribuzione 'AzCli' e il tipo IaC 'terraform' per le risorse 'aks','azurekeyvault'".
- Richiedere controlli di qualità IaC generali senza un file IaC usando uno script AzCli: "Ottenere regole per lo strumento di distribuzione 'AzCli' e lasciare vuoto il tipo IaC per le risorse 'azurestorageaccount'".
Ottenere una guida sulla pipeline
Questo strumento MCP (Model Context Protocol) genera la configurazione della pipeline CI/CD e indicazioni dettagliate per distribuire un'applicazione in Azure usando GitHub Actions o le pipeline di Azure DevOps. Supporta le distribuzioni basate su Azure Developer CLI (azd) e Azure CLI. Può generare pipeline che effettuano il provisioning dell'infrastruttura e distribuiscono il codice dell'applicazione.
È possibile scegliere GitHub Actions o Azure DevOps, decidere se la pipeline deve solo distribuire o eseguire il provisioning dell'infrastruttura e verificare se il progetto usa azd (ad esempio, è presente un azure.yaml file). Specificare deploy-only o provision-and-deploy, e impostare Is azd project su true solo se il progetto usa gli strumenti azd ed è disponibile un file azure.yaml.
Alcuni prompt di esempio includono:
- "Come si configura una pipeline CI/CD con GitHub Actions per distribuire l'app in Azure, con l'opzione di distribuzione 'deploy-only', non è un progetto AZD, e la piattaforma pipeline 'github-actions'?"
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Opzione Distribuisci | Obbligatorio | Valori validi: *deploy-only*, *provision-and-deploy*. L'impostazione predefinita è solo deploy-only. Impostare su provision-and-deploy solo quando si desidera esplicitamente una pipeline di infrastruttura di provisioning che utilizza script di provisioning locali. |
| È il progetto AZD | Obbligatorio | Indica se utilizzare lo strumento AZD nella pipeline di distribuzione. Impostare su true solo se azure.yaml viene fornito o se il contesto suggerisce l'uso di strumenti AZD. |
| Piattaforma di pipeline | Obbligatorio | La piattaforma per la distribuzione della pipeline. Valori validi: github-actions, azure-devops. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌
Ottieni il piano di distribuzione
Genera un piano di distribuzione formattato e dettagliato per un'applicazione in Azure. Questo strumento, incluso nel protocollo MCP (Model Context Protocol), suggerisce le risorse di Azure, fornisce modelli di infrastruttura come codice (IaC) ed elenca i passaggi di distribuzione in base a un servizio di hosting di destinazione e a uno strumento di provisioning scelto. Ad esempio, i servizi di hosting di destinazione includono Azure Container Apps, Azure App Service o Azure Kubernetes Service (AKS). Per gli strumenti di provisioning, gli esempi includono l'interfaccia della riga di comando per sviluppatori di Azure (azd), l'interfaccia della riga di comando di Azure con Bicep o Terraform.
Questo strumento non analizza l'area di lavoro o rileva automaticamente le risorse. Si analizza il progetto, si determinano framework, dipendenze e risorse esistenti, si sceglie il servizio di hosting e lo strumento di provisioning e quindi si specificano tali valori per generare il piano.
Alcuni prompt di esempio includono:
- Come creare un piano di distribuzione dettagliato per il progetto 'my-webapp' in Azure con l'opzione di distribuzione 'provision-and-deploy', lo strumento di provisioning 'AZD', il tipo di origine 'from-project', il servizio app di destinazione 'WebApp', la cartella dell'area di lavoro '/home/dev/my-webapp' e le opzioni IaC 'bicep'?
| Parametro | Obbligatorio o facoltativo | Description |
|---|---|---|
| Opzione Distribuisci | Obbligatorio | Impostare il valore in base all'input del progetto e dell'utente. Valori validi: provision-and-deploy, deploy-only, provision-only. Scegliere deploy-only quando si esegue la distribuzione in risorse di Azure esistenti o quando i file IaC esistono già. Scegliere provision-only quando si vuole eseguire solo il provisioning delle risorse di Azure. Scegliere provision-and-deploy quando si vuole effettuare il provisioning dell'infrastruttura e distribuire l'applicazione. |
| Nome progetto | Obbligatorio | Nome del progetto per cui generare il piano di distribuzione. Se non si specifica un nome di progetto, lo strumento lo deduce dall'area di lavoro. |
| Strumento di provisioning | Obbligatorio | Strumento da usare per il provisioning delle risorse di Azure. Valori validi: AzCli, AZD. Ad esempio, l'interfaccia della riga di comando per sviluppatori di Azure (azd) o l'interfaccia della riga di comando di Azure con Bicep. |
| Tipo di origine | Obbligatorio | L'origine del piano da cui generare. Valori validi: from-project, from-azure, from-context. Usare from-project per basare il piano sui file di progetto nell'area di lavoro. Usare from-azure per basare il piano sulle risorse di Azure esistenti. Usare from-context per basare il piano sui valori forniti quando non esistono file di progetto o risorse di Azure. |
| Servizio app di destinazione | Obbligatorio | Servizio di Azure per distribuire l'applicazione. Valori validi: ContainerApp, WebApp, FunctionApp, AKS. Consigliarne una in base all'architettura e al runtime dell'applicazione. |
| Cartella dell'area di lavoro | Obbligatorio | Percorso completo della cartella dell'area di lavoro. |
| Opzioni IaC | Opzionale | Opzione Infrastruttura come codice. Valori validi: bicep, terraform. Lascia vuoto per usare uno script Azure CLI. |
| Gruppo di risorse | Opzionale | Nome del gruppo di risorse di Azure. |
Suggerimenti di annotazione degli strumenti:
Distruttivo: ❌ | Idempotente: ✅ | Open World: ❌ | Sola lettura: ✅ | Segreto: ❌ | Locale obbligatorio: ❌