Средства Azure MCP Server для развертывания Azure

Сервер Azure MCP помогает управлять задачами развертывания Azure. К этим задачам относятся операции, которые создают схемы архитектуры, получают лог-файлы приложений, получают планы развертывания, извлекают правила IaC и дают рекомендации по конвейеру через запросы на естественном языке.

Развертывание Azure — это набор средств, которые помогают планировать, проверять и отслеживать развертывания в ресурсах Azure. Дополнительные сведения см. в документации по развертыванию Azure.

Заметка

Параметры инструментов: Инструменты сервера Azure MCP определяют параметры данных, которые им необходимы для выполнения задач. Некоторые из этих параметров относятся к каждому инструменту и описаны ниже. Другие параметры являются глобальными и общими для всех инструментов. Дополнительные сведения см. в разделе "Параметры средства".

Получение журналов приложений

В этом средстве отображаются журналы приложений для приложений, развертываемых интерфейсом командной строки разработчика Azure (azd). Это средство запрашивает рабочую область Log Analytics приложения для приложений контейнеров Azure, Службы приложений Azure и Функций Azure. Он автоматически обнаруживает рабочую область и связанные ресурсы из конфигурации azd environment. Он работает только для приложений, развернутых с помощью azd up.

Проверьте состояние развертывания или устранение неполадок после развертывания.

Примеры запросов:

  • "Покажите журнал приложения, развернутого с помощью azd для окружения Azd с именем 'dev' и рабочей папки '/home/alice/projects/my-app'".
Параметр Обязательно или необязательно Description
AZD env name Обязательно Имя среды, созданное интерфейсом командной строки разработчика Azure (azd) и хранящееся в AZURE_ENV_NAME во время azd init или azd up. Если данный инструмент не указан в контексте, он либо проверяет каталог .azure в рабочей области, либо запускает azd env list.
Папка рабочей области Обязательно Полный путь к папке рабочей области, содержащей проект azd.
Limit Необязательно Максимальное количество извлекаемых строк журнала. Используйте его, чтобы ограничить результаты или избежать превышения ограничений токенов. Значение по умолчанию — 200.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Создание схемы архитектуры

Это средство является частью набора инструментов протокола контекста модели (MCP). Он создает схему архитектуры службы Azure, которая показывает рекомендуемые службы Azure и их логические подключения для приложения. Это средство отображает схему из топологии приложения (AppTopology), предоставленной в качестве входных данных. Вы предоставляете AppTopology, описывающее службы, вычислительные узлы, зависимости и параметры среды. Вы можете создать AppTopology, проверив рабочую область для обнаружения служб, платформ и переменных среды для строк подключения. Для приложений .NET Aspire включите aspireManifest.json. Схема фокусируется на выборе службы и подключениях. Он не отображает подробную топологию сети или структуру безопасности.

Примеры запросов:

  • Создайте схему архитектуры Azure для этого приложения. Необработанные входные данные средства MCP: '<secure-password>'.
Параметр Обязательно или необязательно Description
Входные данные необработанного инструмента mcp Обязательно Объект JSON, определяющий входную структуру для этого средства.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Получить правила IaC

Извлекает правила и лучшие практики для создания файлов Bicep и Terraform в формате Infrastructure as Code (IaC) с целью развертывания приложений Azure. Это средство протокола контекста модели (MCP) возвращает рекомендации по стандартам конфигурации ресурсов Azure, совместимости с Azure Developer CLI (azd) и Azure CLI и общими требованиями к качеству IaC. Используйте рекомендации по улучшению сценариев Bicep и шаблонов Terraform для ресурсов Azure и согласованию развертываний с рекомендациями Azure.

Примеры запросов:

  • "Показать правила и рекомендации по написанию Bicep и Terraform IaC для Azure с помощью средства развертывания AzCli".
Параметр Обязательно или необязательно Description
Средство развертывания Обязательно Используемое средство развертывания. Допустимые значения: AzCli, AZD.
Тип IaC Необязательно Тип файла IaC, используемого для развертывания. Допустимые значения включают bicep, terraform. Оставьте пустым только в том случае, если вы хотите использовать скрипт команд Azure CLI без файла IaC.
Типы ресурсов Необязательно Список типов ресурсов Azure для создания правил. Получите значение из контекста и используйте те же ресурсы, определенные в плане. Допустимое значение: appservice, containerapp, function, aks, azuredatabaseforpostgresql, azuredatabaseformysql, azuresqldatabase, azurecosmosdb, azurestorageaccount, azurekeyvault.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Примеры

  • Укажите правила IaC для Bicep и Terraform для Службы приложений Azure и Базы данных SQL Azure: "Получите правила для средства развертывания 'AZD' и типа IaC 'bicep' для ресурсов 'appservice', 'azuresqldatabase'".
  • Ознакомьтесь с лучшими практиками по созданию шаблона Terraform для развертывания службы Kubernetes Azure и Azure Key Vault: "Получите правила для средства развертывания 'AzCli' и типа IaC 'terraform' для ресурсов 'aks', 'azurekeyvault'".
  • Запросить общие проверки качества IaC без файла IaC с использованием скрипта AzCli: "Получить правила для средства развертывания 'AzCli' и оставить пустым тип IaC для ресурсов 'azurestorageaccount'".

Получение руководства по конвейеру

Это средство протокола контекста модели (MCP) создает конфигурацию конвейера CI/CD и пошаговые инструкции по развертыванию приложения в Azure с помощью GitHub Actions или конвейеров Azure DevOps. Он поддерживает azure Developer CLI (azd) и развертывания на основе Azure CLI. Он может создавать конвейеры, которые подготавливают инфраструктуру и развертывают код приложения.

Вы можете выбрать GitHub Actions или Azure DevOps, определить, должен ли конвейер развертывать или подготавливать инфраструктуру, а также проверить, используется ли проект azd (например, azure.yaml файл присутствует). Укажите deploy-only или provision-and-deploy, и установите Is azd project в true только в том случае, если проект использует инструменты azd и доступен файл azure.yaml.

Примеры запросов:

  • "Как настроить конвейер CI/CD с помощью GitHub Actions для развертывания моего приложения в Azure с параметром 'только развертывание'; проект не является AZD, а в качестве платформы конвейера используется 'github-actions'?"
Параметр Обязательно или необязательно Description
Вариант развертывания Обязательно Допустимые значения: только развертывание, подготовка и развертывание. По умолчанию используется только развертывание. Установите значение provision-and-deploy только в том случае, если вы явно хотите конвейер подготовки инфраструктуры, который использует локальные скрипты подготовки.
Проект AZD Обязательно Следует ли использовать средство AZD в конвейере развертывания. Установите значение true только в том случае, если azure.yaml задано или контекст предлагает средства AZD.
Платформа конвейера Обязательно Платформа для конвейера развертывания. Допустимые значения: github-actions, azure-devops.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌

Получение плана развертывания

Создает форматированный пошаговый план развертывания для приложения в Azure. Это средство, являющееся частью протокола контекста модели (MCP), предлагает ресурсы Azure, предоставляет шаблоны инфраструктуры как кода (IaC) и перечисляет шаги развертывания в зависимости от целевой службы размещения и выбранного средства подготовки. Например, целевые службы размещения включают приложения контейнеров Azure, Службу приложений Azure или Службу Azure Kubernetes (AKS). Примеры инструментов развертывания включают Azure Developer CLI (azd), Azure CLI с Bicep или Terraform.

Это средство не сканирует рабочую область или не обнаруживает ресурсы автоматически. Вы анализируете проект, определяете платформы, зависимости и существующие ресурсы, выбираете службу размещения и средство подготовки, а затем предоставляете эти значения для создания плана.

Примеры запросов:

  • "Как создать пошаговый план развертывания для имени проекта "my-webapp" в Azure с параметром развертывания "подготовка и развертывание", инструментом подготовки "AZD", типом источника "from-project", целевой службой приложений "WebApp", папкой рабочей области "/home/dev/my-webapp" и параметрами IaC "bicep"?"
Параметр Обязательно или необязательно Description
Вариант развертывания Обязательно Задайте значение на основе входных данных проекта и пользователя. Допустимые значения: provision-and-deploy, , deploy-onlyprovision-only. Выберите deploy-only , когда вы развертываете существующие ресурсы Azure или когда файлы IaC уже существуют. Выберите provision-only, когда требуется подготовить только ресурсы Azure. Выберите provision-and-deploy , когда нужно подготовить инфраструктуру и развернуть приложение.
Имя проекта Обязательно Имя проекта для создания плана развертывания. Если имя проекта не указано, средство выводит его из рабочей области.
Инструмент развертывания Обязательно Средство, используемое для развертывания ресурсов Azure. Допустимые значения: AzCli, AZD. Например, с помощью Azure Developer CLI (azd) или Azure CLI с использованием Bicep.
Тип источника Обязательно Источник плана, из которого необходимо генерировать. Допустимые значения: from-project, , from-azurefrom-context. Используется from-project для создания плана на основе файлов проекта в рабочей области. Используйте from-azure, чтобы создать план на основе существующих ресурсов Azure. Используйте from-context, чтобы основывать план на предоставленных вами значениях, если отсутствуют файлы проекта или ресурсы Azure.
Целевая служба приложений Обязательно Служба Azure для развертывания приложения. Допустимые значения: ContainerApp, , WebAppFunctionAppAKS. Рекомендуйте один вариант на основе архитектуры приложения и среды выполнения.
Папка рабочей области Обязательно Полный путь к папке рабочей области.
Параметры IaC Необязательно Параметр "Инфраструктура как код". Допустимые значения: bicep, terraform. Оставьте поле пустым, чтобы использовать командную строку Azure CLI.
Группа ресурсов Необязательно Имя группы ресурсов Azure.

Подсказки по аннотациям инструмента:

Разрушительный: ❌ | Идемпотент: ✅ | Открытый мир: ❌ | Только для чтения: ✅ | Секрет: ❌ | Локальность обязательна: ❌