Ferramentas do Servidor MCP do Azure para Implantação do Azure

O Servidor MCP do Azure ajuda você a gerenciar tarefas de Implantação do Azure. Essas tarefas incluem operações que geram diagramas de arquitetura, obtêm logs de aplicativos, recuperam planos de implantação, buscam regras de IaC e fornecem diretrizes de pipeline, tudo por meio de prompts de linguagem natural.

A Implantação do Azure é um conjunto de ferramentas que ajudam você a planejar, validar e monitorar implantações em recursos do Azure. Para obter mais informações, consulte a documentação de Implantação do Azure.

Nota

Parâmetros de ferramenta: as ferramentas do Servidor MCP do Azure definem parâmetros para os dados necessários para concluir tarefas. Alguns desses parâmetros são específicos para cada ferramenta e estão documentados abaixo. Outros parâmetros são globais e compartilhados por todas as ferramentas. Para obter mais informações, consulte parâmetros de ferramenta.

Obter os logs do aplicativo

Essa ferramenta exibe os logs de aplicativos para programas que a CLI do Desenvolvedor do Azure (azd) implanta. Essa ferramenta consulta o workspace de Log Analytics do aplicativo para Aplicativos de Contêiner do Azure, o Serviço de Aplicativo do Azure e o Azure Functions. Ele descobre automaticamente o workspace e os recursos associados a partir da configuração do ambiente no azd. Ele funciona apenas para aplicativos implantados por azd up.

Verifique o status da implantação ou solucione problemas pós-implantação.

Os prompts de exemplo incluem:

  • Mostre-me o log do aplicativo implantado pelo azd para o nome do ambiente Azd 'dev' e a pasta de trabalho '/home/alice/projects/my-app'.
Parâmetro Obrigatório ou opcional Description
Nome do env do AZD Obrigatório O nome do ambiente criado pela CLI do Azure Developer (azd) e armazenado em AZURE_ENV_NAME durante azd init ou azd up. Se não for fornecido no contexto, esta ferramenta verificará o diretório .azure no espaço de trabalho ou executará azd env list.
Pasta do espaço de trabalho Obrigatório O caminho completo para a pasta de workspace que contém o projeto azd.
Limit Opcional O número máximo de linhas de log que podem ser recuperadas. Use-o para limitar os resultados ou evitar exceder os limites de token. O padrão é 200.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Gerar diagrama de arquitetura

Essa ferramenta faz parte do conjunto de ferramentas MCP (Model Context Protocol). Ele gera um diagrama de arquitetura de serviço do Azure que mostra os serviços recomendados do Azure e suas conexões lógicas para um aplicativo. Essa ferramenta renderiza o diagrama de uma topologia de aplicativo (AppTopology) fornecida como entrada. Você fornece uma AppTopology que descreve serviços, hosts de computação, dependências e configurações de ambiente. Você pode criar a AppTopology verificando o workspace para detectar serviços, estruturas e variáveis de ambiente para cadeias de conexão. Para aplicativos .NET Aspire, inclua aspireManifest.json. O diagrama se concentra na seleção e nas conexões dos serviços. Ele não mostra topologia de rede detalhada ou design de segurança.

Os prompts de exemplo incluem:

  • "Gere o diagrama de arquitetura do Azure para esta entrada bruta da ferramenta MCP do aplicativo '<secure-password>'."
Parâmetro Obrigatório ou opcional Description
Entrada bruta da ferramenta mcp Obrigatório Objeto JSON que define a estrutura de entrada para essa ferramenta.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Obter regras de IaC

Obtém regras e práticas recomendadas para criar arquivos de Infraestrutura como Código (IaC) com Bicep e Terraform, para implantar aplicativos no Azure. Essa ferramenta MCP (Protocolo de Contexto de Modelo) retorna diretrizes sobre os padrões de configuração de recursos do Azure, a compatibilidade com a CLI do Desenvolvedor do Azure (azd) e a CLI do Azure e os requisitos gerais de qualidade de IaC. Use as diretrizes para melhorar scripts Bicep e modelos do Terraform para recursos do Azure e alinhar implantações com as práticas recomendadas do Azure.

Os prompts de exemplo incluem:

  • "Mostre-me as regras e as práticas recomendadas para escrever o Bicep e o Terraform IaC para a Azure usando a ferramenta de implantação 'AzCli'."
Parâmetro Obrigatório ou opcional Description
Ferramenta de implantação Obrigatório A ferramenta de implantação a ser usada. Valores válidos: AzCli, AZD.
Tipo de IaC Opcional O tipo de arquivo IaC usado para implantação. Os valores válidos incluem bicep. terraform Deixe vazio somente se você quiser usar o script de comando da CLI do Azure sem o arquivo IaC.
Tipos de recursos Opcional Lista de tipos de recursos do Azure para os quais gerar regras. Obtenha o valor do contexto e use os mesmos recursos definidos no plano. Valor válido: appservice,containerapp,,function,aksazuredatabaseforpostgresql,,azuredatabaseformysql,azuresqldatabase,,azurecosmosdb,azurestorageaccount,,,azurekeyvault.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Exemplos

  • Forneça regras de IaC para o Bicep e o Terraform para o Serviço de Aplicativo do Azure e o Banco de Dados SQL do Azure: "Obter regras para a ferramenta de implantação 'AZD' e o tipo iaC 'bicep' para recursos 'appservice','azuresqldatabase'".
  • Mostrar as práticas recomendadas para um modelo do Terraform que implanta o Serviço de Kubernetes do Azure e o Azure Key Vault: "Obter regras para a ferramenta de implantação 'AzCli' e o tipo IaC 'terraform' para recursos 'aks','azurekeyvault'".
  • Solicite verificações gerais de qualidade de IaC sem um arquivo IaC, utilizando um script do Azure CLI: "Obtenha regras para a ferramenta de implantação 'Azure CLI' e deixe o tipo de IaC em branco para os recursos 'azurestorageaccount'".

Obter diretrizes de pipeline

Essa ferramenta MCP (Protocolo de Contexto de Modelo) gera a configuração de pipeline de CI/CD e diretrizes passo a passo para implantar um aplicativo no Azure usando pipelines do GitHub Actions ou do Azure DevOps. Ele dá suporte à CLI do Desenvolvedor do Azure (azd) e a implantações baseadas na CLI do Azure. Ele pode gerar pipelines que provisionam a infraestrutura e implantam o código de aplicação.

Você pode escolher o GitHub Actions ou o Azure DevOps, decidir se o pipeline deve apenas implantar ou também provisionar a infraestrutura e confirmar se o projeto usa azd (por exemplo, um azure.yaml arquivo está presente). Especifique deploy-only ou provision-and-deploy, e defina Is azd project para true somente se o projeto usar ferramentas azd e um arquivo azure.yaml estiver disponível.

Os prompts de exemplo incluem:

  • "Como configurar um pipeline de CI/CD com o GitHub Actions para implantar meu aplicativo no Azure, com a opção 'somente para implantação', não sendo um projeto AZD, e a plataforma do pipeline 'github-actions'?"
Parâmetro Obrigatório ou opcional Description
Opção de Implantação Obrigatório Valores válidos: somente implantação, provisionamento e implantação. Definido para apenas implantar. Defina provision-and-deploy somente quando você quiser explicitamente um pipeline de provisionamento de infraestrutura que use scripts de provisionamento locais.
É o projeto AZD Obrigatório Se deve usar a ferramenta AZD no pipeline de implantação. Defina como true somente se azure.yaml for fornecido ou quando o contexto sugerir ferramentas do AZD.
Plataforma de pipeline Obrigatório A plataforma para o pipeline de implantação. Valores válidos: github-actions, azure-devops.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Obter plano de implantação

Gera um plano de implantação formatado passo a passo para um aplicativo para o Azure. Essa ferramenta, parte do Protocolo de Contexto de Modelo (MCP), sugere recursos do Azure, fornece modelos de IaC (infraestrutura como código) e lista as etapas de implantação com base em um serviço de hospedagem de destino e em uma ferramenta de provisionamento escolhida. Por exemplo, os serviços de hospedagem de destino incluem Aplicativos de Contêiner do Azure, Serviço de Aplicativo do Azure ou AKS (Serviço de Kubernetes do Azure). Para ferramentas de provisionamento, exemplos incluem a CLI do Desenvolvedor do Azure (azd), a CLI do Azure com o Bicep ou o Terraform.

Essa ferramenta não verifica seu workspace nem detecta recursos automaticamente. Você analisa o projeto, determina estruturas, dependências e recursos existentes, escolhe o serviço de hospedagem e a ferramenta de provisionamento e fornece esses valores para gerar o plano.

Os prompts de exemplo incluem:

  • "Como criar um plano de implantação passo a passo para o nome do projeto 'my-webapp' no Azure com a opção de implantação 'provision-and-deploy', a ferramenta de provisionamento 'AZD', o tipo de origem 'from-project', o serviço de aplicativo de destino 'WebApp', a pasta de workspace '/home/dev/my-webapp' e as opções de IaC 'bicep'?"
Parâmetro Obrigatório ou opcional Description
Opção de implantação Obrigatório Defina o valor com base na entrada do projeto e do usuário. Valores válidos: provision-and-deploy, , deploy-onlyprovision-only. Escolha deploy-only quando implantar em recursos existentes do Azure ou quando os arquivos IaC já existirem. Escolha provision-only quando você deseja provisionar apenas os recursos do Azure. Escolha provision-and-deploy quando você deseja provisionar a infraestrutura e implantar o aplicativo.
Nome do projeto Obrigatório O nome do projeto para o qual gerar o plano de implantação. Se você não fornecer um nome de projeto, a ferramenta o inferirá do workspace.
Ferramenta de provisionamento Obrigatório A ferramenta a ser usada para provisionar recursos do Azure. Valores válidos: AzCli, AZD. Por exemplo, CLI do Desenvolvedor do Azure (azd) ou Azure CLI com Bicep.
Tipo de Origem Obrigatório A fonte do plano a partir da qual gerar. Valores válidos: from-project, , from-azurefrom-context. Use from-project para basear o plano em arquivos de projeto no workspace. Use from-azure para basear o plano em recursos existentes do Azure. Use from-context para basear o plano nos valores fornecidos quando não existem arquivos de projeto ou recursos do Azure.
Serviço de aplicativo de destino Obrigatório O serviço do Azure para implantar o aplicativo. Valores válidos: ContainerApp, , WebApp, FunctionApp. AKS Recomende um com base na arquitetura e no runtime do aplicativo.
Pasta do espaço de trabalho Obrigatório O caminho completo da pasta do workspace.
Opções de IaC Opcional A opção Infraestrutura como Código. Valores válidos: bicep, terraform. Deixe vazio para usar um script da CLI do Azure.
Grupo de recursos Opcional O nome do grupo de recursos do Azure.

Dicas de anotação da ferramenta:

Destrutivo: ❌ | Idempotente: ✅ | Mundo Aberto: ❌ | Somente leitura: ✅ | Segredo: ❌ | Local Necessário: ❌

Conteúdo relacionado

  • Last updated on