Outils de serveur Azure MCP pour Azure Deploy

Le serveur Azure MCP vous aide à gérer les tâches Azure Deploy. Ces tâches incluent des opérations qui génèrent des diagrammes d'architecture, obtiennent des journaux d'applications, récupèrent des plans de déploiement, extraient des règles IaC et fournissent des conseils pour le pipeline, en utilisant des invites en langage naturel.

Azure Deploy est un ensemble d’outils qui vous aident à planifier, valider et surveiller les déploiements sur des ressources Azure. Pour plus d’informations, consultez la documentation Azure Deploy.

Note

Paramètres de l’outil : les outils Azure MCP Server définissent des paramètres pour les données dont ils ont besoin pour effectuer des tâches. Certains de ces paramètres sont spécifiques à chaque outil et sont documentés ci-dessous. D’autres paramètres sont globaux et partagés par tous les outils. Pour plus d’informations, consultez Paramètres de l’outil.

Obtenir les journaux d’activité d’application

Cet outil affiche les journaux d’application des applications déployées par l’interface CLI développeur Azure (azd). Cet outil interroge l’espace de travail Log Analytics de l’application pour Azure Container Apps, Azure App Service et Azure Functions. Il découvre automatiquement l’espace de travail et les ressources associées à partir de la configuration de l’environnement azd. Il fonctionne uniquement pour les applications déployées par azd up.

Vérifiez l’état du déploiement ou résolvez les problèmes de post-déploiement.

Voici quelques exemples d’invites :

  • « Affichez-moi le journal de l’application déployée par azd pour Azd env nom 'dev' et le dossier d’espace de travail '/home/alice/projects/my-app'. »
Paramètre Obligatoire ou facultatif Descriptif
Nom de l’env AZD Obligatoire Nom de l’environnement créé par Azure Developer CLI (azd) et stocké dans AZURE_ENV_NAME pendant azd init ou azd up. S’il n’est pas fourni dans le contexte, cet outil vérifie le répertoire .azure de l’espace de travail ou exécute azd env list.
Dossier espace de travail Obligatoire Chemin d’accès complet au dossier de l’espace de travail qui contient le projet azd.
Limite Optional Nombre maximal de lignes de journal à récupérer. Utilisez-la pour limiter les résultats ou éviter de dépasser les limites de tokens. La valeur par défaut est 200.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Générer un diagramme d’architecture

Cet outil fait partie de l’ensemble d’outils MCP (Model Context Protocol). Il génère un diagramme d’architecture de service Azure qui montre les services Azure recommandés et leurs connexions logiques pour une application. Cet outil affiche le diagramme à partir d’une topologie d’application (AppTopology) fournie comme entrée. Vous fournissez une AppTopology qui décrit les services, les hôtes de calcul, les dépendances et les paramètres d’environnement. Vous pouvez générer l’AppTopology en analysant l’espace de travail pour détecter les services, les frameworks et les variables d’environnement pour les chaînes de connexion. Pour les applications .NET Aspire, incluez aspireManifest.json. Le diagramme se concentre sur la sélection et les connexions de service. Il n’affiche pas de topologie de réseau ou de conception de sécurité détaillée.

Voici quelques exemples d’invites :

  • « Générez le diagramme d’architecture Azure pour cette entrée d’outil MCP brute de l’application «< secure-password> ».
Paramètre Obligatoire ou facultatif Descriptif
Entrée brute de l’outil mcp Obligatoire Objet JSON qui définit la structure d’entrée de cet outil.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Obtenir des règles IaC

Récupère des règles et des bonnes pratiques pour créer des fichiers Bicep et Terraform Infrastructure as Code (IaC) pour déployer des applications Azure. Cet outil MCP (Model Context Protocol) retourne des conseils sur les normes de configuration des ressources Azure, la compatibilité avec Azure Developer CLI (azd) et Azure CLI et les exigences générales de qualité IaC. Utilisez les conseils pour améliorer les scripts Bicep et les modèles Terraform pour les ressources Azure et aligner les déploiements avec les meilleures pratiques Azure.

Voici quelques exemples d’invites :

  • « Montrez-moi les règles et les meilleures pratiques pour écrire Bicep et Terraform IaC pour Azure à l’aide de l’outil de déploiement « AzCli ».
Paramètre Obligatoire ou facultatif Descriptif
Outil de déploiement Obligatoire Outil de déploiement à utiliser. Valeurs valides : AzCli, AZD.
Type IaC Optional Type de fichier IaC utilisé pour le déploiement. Les valeurs valides incluent bicep, terraform. Laissez vide uniquement si vous souhaitez utiliser le script de commande Azure CLI sans fichier IaC.
Types de ressources Optional Liste des types de ressources d'Azure pour générer des règles. Obtenez la valeur du contexte et utilisez les mêmes ressources définies dans le plan. Valeur valide : appservice,containerapp,,function,,,aksazuredatabaseforpostgresqlazuredatabaseformysqlazuresqldatabaseazurecosmosdbazurestorageaccountazurekeyvault

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Examples

  • Fournissez des règles IaC pour Bicep et Terraform pour Azure App Service et Azure SQL Database : « Obtenir des règles pour l’outil de déploiement « AZD » et le type IaC « bicep » pour les ressources « appservice », « azuresqldatabase ».
  • Affichez les meilleures pratiques pour un modèle Terraform qui déploie Azure Kubernetes Service et Azure Key Vault : « Obtenir des règles pour l’outil de déploiement « AzCli » et le type IaC « terraform » pour les ressources « aks », « azurekeyvault ».
  • Demandez des vérifications de qualité IaC générales sans fichier IaC, à l’aide d’un script AzCli : « Obtenir des règles pour l’outil de déploiement « AzCli » et laisser le type IaC vide pour les ressources « azurestorageaccount ».

Obtenir des conseils sur le pipeline

Cet outil MCP (Model Context Protocol) génère la configuration du pipeline CI/CD et des instructions pas à pas pour déployer une application sur Azure à l’aide de GitHub Actions ou de pipelines Azure DevOps. Il prend en charge azure Developer CLI (azd) et les déploiements basés sur Azure CLI. Il peut générer des pipelines qui provisionnent l’infrastructure et déploient du code d’application.

Vous pouvez choisir GitHub Actions ou Azure DevOps, décider si le pipeline doit uniquement déployer ou approvisionner une infrastructure, et confirmer si le projet utilise azd (par exemple, un azure.yaml fichier est présent). Spécifiez deploy-only ou provision-and-deploy, et définissez Is azd project à true uniquement si le projet utilise l'outil azd et qu’un fichier azure.yaml est disponible.

Voici quelques exemples d’invites :

  • « Comment configurer un pipeline CI/CD avec GitHub Actions pour déployer mon application sur Azure, avec l’option Déployer « déployer uniquement », ce n’est pas un projet AZD et la plateforme de pipeline « github-actions » ?
Paramètre Obligatoire ou facultatif Descriptif
Option Déployer Obligatoire Valeurs valides : déploiement seul, approvisionnement et déploiement. Mode par défaut : déploiement seul. Défini sur provision-and-deploy uniquement lorsque vous souhaitez explicitement un pipeline d’approvisionnement d’infrastructure qui utilise des scripts d’approvisionnement locaux.
Est-ce que c'est le projet AZD Obligatoire Faut-il utiliser l’outil AZD dans le pipeline de déploiement ? Défini sur true uniquement si azure.yaml est disponible ou si le contexte suggère des outils AZD.
Plateforme de pipeline Obligatoire Plateforme du pipeline de déploiement. Valeurs valides : github-actions, azure-devops.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Obtenir le plan de déploiement

Génère un plan de déploiement pas à pas mis en forme pour une application vers Azure. Cet outil, qui fait partie du protocole MCP (Model Context Protocol), suggère des ressources Azure, fournit des modèles d’infrastructure en tant que code (IaC) et répertorie les étapes de déploiement basées sur un service d’hébergement cible et un outil d’approvisionnement choisi. Par exemple, les services d’hébergement cible incluent Azure Container Apps, Azure App Service ou Azure Kubernetes Service (AKS). Pour les outils d’approvisionnement, des exemples incluent Azure Developer CLI (azd), Azure CLI avec Bicep ou Terraform.

Cet outil n’analyse pas votre espace de travail ni ne détecte automatiquement les ressources. Vous analysez le projet, déterminez les infrastructures, les dépendances et les ressources existantes, choisissez le service d’hébergement et l’outil d’approvisionnement, puis fournissez ces valeurs pour générer le plan.

Voici quelques exemples d’invites :

  • « Comment créer un plan de déploiement pas à pas pour le nom de projet « my-webapp » sur Azure avec l’option de déploiement « provision-and-deploy », l’outil d’approvisionnement « AZD », le type de source « from-project », le service d’application cible « WebApp », le dossier de l’espace de travail « /home/dev/my-webapp » et les options IaC « bicep » ?
Paramètre Obligatoire ou facultatif Descriptif
Option Déployer Obligatoire Définissez la valeur en fonction de l’entrée du projet et de l’utilisateur. Valeurs valides : provision-and-deploy, deploy-only, provision-only. Choisissez quand vous déployez deploy-only sur des ressources Azure existantes ou lorsque des fichiers IaC existent déjà. Choisissez provision-only quand vous souhaitez provisionner uniquement des ressources Azure. Choisissez provision-and-deploy quand vous souhaitez approvisionner l’infrastructure et déployer l’application.
Nom du projet Obligatoire Nom du projet pour lequel générer le plan de déploiement. Si vous ne fournissez pas de nom de projet, l’outil l’déduit de l’espace de travail.
Outil d’approvisionnement Obligatoire Outil à utiliser pour l’approvisionnement des ressources Azure. Valeurs valides : AzCli, AZD. Par exemple, Azure Developer CLI (azd) ou Azure CLI avec Bicep.
Type de source Obligatoire La source à partir de laquelle générer le plan. Valeurs valides : from-project, from-azure, from-context. Utiliser from-project pour baser le plan sur les fichiers de projet dans l’espace de travail. Permet from-azure de baser le plan sur les ressources Azure existantes. Permet from-context de baser le plan sur les valeurs que vous fournissez quand aucun fichier projet ou ressources Azure n’existe.
Service d’application cible Obligatoire Service Azure pour déployer l’application. Valeurs valides : ContainerApp, , WebAppFunctionApp, AKS. Recommandez-en une basée sur l’architecture et le runtime de l’application.
Dossier espace de travail Obligatoire Chemin complet du dossier de l’espace de travail.
Options IaC Optional Option d'Infrastructure as Code Valeurs valides : bicep, terraform. Laissez vide pour utiliser un script Azure CLI.
Groupe de ressources Optional Nom du groupe de ressources Azure.

Indicateurs d’annotation d’outil :

Destructeur : ❌ | Idempotent : ✅ | Monde Ouvert : ❌ | Lecture seule : ✅ | Secret : ❌ | Local requis : ❌

Contenu connexe

  • Last updated on