Narzędzia programu Azure MCP Server dla usługi Azure Deploy

Serwer MCP platformy Azure ułatwia zarządzanie zadaniami wdrażania platformy Azure. Te zadania obejmują operacje, które generują diagramy architektury, pobierają dzienniki aplikacji, pobierają plany wdrażania, pobierają reguły IaC i dostarczają wskazówki dotyczące przepływu zadań, a wszystko to za pośrednictwem poleceń w języku naturalnym.

Azure Deploy to zestaw narzędzi, które ułatwiają planowanie, weryfikowanie i monitorowanie wdrożeń w zasobach platformy Azure. Aby uzyskać więcej informacji, zobacz dokumentację usługi Azure Deploy.

Notatka

Parametry narzędzia: Narzędzia serwera MCP platformy Azure definiują parametry dla danych potrzebnych do ukończenia zadań. Niektóre z tych parametrów są specyficzne dla każdego narzędzia i zostały opisane tutaj. Inne parametry są globalne i współużytkowane przez wszystkie narzędzia. Aby uzyskać więcej informacji, zobacz Parametry narzędzia.

Pobieranie dzienników aplikacji

To narzędzie pokazuje dzienniki aplikacji dla aplikacji wdrażanych przez interfejs wiersza polecenia dewelopera platformy Azure (azd). To narzędzie wysyła zapytania do obszaru roboczego Log Analytics aplikacji związanej z usługami Azure Container Apps, Azure App Service i Azure Functions. Automatycznie odnajduje przestrzeń roboczą oraz zasoby skojarzone z konfiguracji środowiska azd. Działa tylko w przypadku aplikacji wdrożonych przez azd up.

Sprawdź stan wdrożenia lub rozwiąż problemy po wdrożeniu.

Przykładowe monity obejmują:

  • "Pokaż mi dziennik aplikacji wdrożonej przez azd dla nazwy env Azd "dev" i folderu obszaru roboczego "/home/alice/projects/my-app".
Parameter Wymagane lub opcjonalne Description
Nazwa env AZD Wymagane Nazwa środowiska utworzona przez interfejs wiersza polecenia dewelopera platformy Azure (azd) i przechowywana w AZURE_ENV_NAME podczas azd init lub azd up. Jeśli nie podano w kontekście, to narzędzie sprawdza katalog .azure w obszarze roboczym lub uruchamia azd env list.
Folder obszaru roboczego Wymagane Pełna ścieżka do folderu obszaru roboczego zawierającego projekt azd.
Limit Opcjonalnie Maksymalna liczba wierszy logów do pobrania. Służy do ograniczania wyników lub unikania przekraczania limitów tokenów. Wartość domyślna to 200.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ✅

Generowanie diagramu architektury

To narzędzie jest częścią zestawu narzędzi protokołu MCP (Model Context Protocol). Generuje diagram architektury usługi platformy Azure przedstawiający zalecane usługi platformy Azure i ich połączenia logiczne dla aplikacji. To narzędzie renderuje diagram z topologii aplikacji (AppTopology) dostarczonej jako dane wejściowe. Udostępniasz aplikację AppTopology, która opisuje usługi, hosty obliczeniowe, zależności i ustawienia środowiska. Możesz utworzyć aplikację AppTopology, przeskanując obszar roboczy w celu wykrywania usług, struktur i zmiennych środowiskowych dla parametrów połączenia. W przypadku aplikacji .NET Aspire uwzględnij wartość aspireManifest.json. Diagram koncentruje się na wybieraniu usług i połączeniach. Nie pokazuje on szczegółowej topologii sieci ani projektu zabezpieczeń.

Przykładowe monity obejmują:

  • Wygeneruj diagram architektury platformy Azure dla tej aplikacji z nieprzetworzonym wejściem narzędzia MCP '<secure-password>'.
Parameter Wymagane lub opcjonalne Description
Nieprzetworzone dane wejściowe narzędzia mcp Wymagane Obiekt JSON, który definiuje strukturę danych wejściowych dla tego narzędzia.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Uzyskaj reguły IaC

Pobiera reguły i najlepsze rozwiązania dotyczące tworzenia plików Bicep i Terraform Infrastructure as Code (IaC) w celu wdrażania aplikacji platformy Azure. To narzędzie protokołu MCP (Model Context Protocol) zwraca wskazówki dotyczące standardów konfiguracji zasobów platformy Azure, zgodności z interfejsem wiersza polecenia dla deweloperów platformy Azure (azd) i interfejsem wiersza polecenia platformy Azure oraz ogólnymi wymaganiami dotyczącymi jakości IaC. Skorzystaj ze wskazówek, aby ulepszyć skrypty Bicep i szablony narzędzia Terraform dla zasobów platformy Azure oraz dostosować wdrożenia do najlepszych rozwiązań platformy Azure.

Przykładowe monity obejmują:

  • "Pokaż mi reguły i najlepsze rozwiązania dotyczące pisania rozwiązań Bicep i Terraform IaC dla platformy Azure przy użyciu narzędzia wdrażania "AzCli".
Parameter Wymagane lub opcjonalne Description
Narzędzie wdrażania Wymagane Narzędzie do wdrażania, które należy użyć. Prawidłowe wartości: AzCli, AZD.
Typ IaC Opcjonalnie Typ pliku IaC używanego do wdrożenia. Prawidłowe wartości to bicep, terraform. Pozostaw puste tylko wtedy, gdy chcesz użyć skryptu polecenia Azure CLI bez pliku IaC.
Typy zasobów Opcjonalnie Lista typów zasobów platformy Azure do generowania reguł. Pobierz wartość z kontekstu i użyj tych samych zasobów zdefiniowanych w planie. Prawidłowa wartość: ,,,,appservicecontainerappfunctionaksazuredatabaseforpostgresql,.azuredatabaseformysqlazuresqldatabaseazurecosmosdbazurestorageaccountazurekeyvault

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Examples

  • Podaj reguły IaC dla Bicep i Terraform dla usług Azure App Service i Azure SQL Database: "Pobierz reguły dla narzędzia wdrażania 'AZD' i typu IaC 'bicep' dla zasobów 'appservice', 'azuresqldatabase'".
  • Pokaż najlepsze praktyki dotyczące szablonu programu Terraform, który wdraża Azure Kubernetes Service i Azure Key Vault: „Pobierz reguły dla narzędzia wdrażania 'AzCli' i typu IaC 'terraform' dla zasobów 'aks', 'azurekeyvault'”.
  • Zażądaj ogólnych kontroli jakości IaC bez pliku IaC przy użyciu skryptu AzCli: "Pobierz reguły dla narzędzia wdrażania "AzCli" i pozostaw typ IaC pusty dla zasobów "azurestorageaccount".

Uzyskaj wskazówki dotyczące przepływu pracy

To narzędzie protokołu Model Context Protocol (MCP) generuje konfigurację potoku CI/CD oraz zapewnia szczegółowe wskazówki krok po kroku dotyczące wdrażania aplikacji na platformie Azure, korzystając z GitHub Actions lub potoków Azure DevOps. Obsługuje Azure Developer CLI (azd) oraz wdrożenia oparte na Azure CLI. Może generować potoki, które dostarczają infrastrukturę oraz wdrażają kod aplikacji.

Możesz wybrać GitHub Actions lub Azure DevOps, zdecydować, czy potok powinien tylko wdrażać, czy także aprowizować infrastrukturę, i potwierdzić, czy projekt używa azd (na przykład istnieje plik azure.yaml). Określ deploy-only lub provision-and-deploy i ustaw Is azd project na true tylko wtedy, gdy projekt używa narzędzi azd i dostępny jest plik azure.yaml.

Przykładowe monity obejmują:

  • "Jak skonfigurować potok ciągłej integracji/ciągłego wdrażania za pomocą funkcji GitHub Actions w celu wdrożenia mojej aplikacji na platformie Azure z opcją "deploy-only", nie jest to projekt AZD i platforma potoku "github-actions"?"
Parameter Wymagane lub opcjonalne Description
Opcja Wdróż Opcjonalnie Prawidłowe wartości: deploy-only, provision-and-deploy. Ustawienie domyślne do wdrażania tylko. Ustaw wartość na provision-and-deploy tylko wtedy, gdy potrzebujesz pipeline'u prowizjonowania infrastruktury, który używa lokalnych skryptów prowizjonowania.
Czy to jest projekt AZD Opcjonalnie Czy używać narzędzia AZD w potoku wdrażania. Ustaw na true tylko wtedy, gdy azure.yaml jest podana lub kontekst sugeruje narzędzia AZD.
Platforma przetwarzania danych Opcjonalnie Platforma potoku wdrożeniowego. Prawidłowe wartości: github-actions, azure-devops.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Pobieranie planu wdrażania

Generuje sformatowany, szczegółowy plan wdrożenia dla aplikacji na platformie Azure. To narzędzie, część protokołu MCP (Model Context Protocol), sugeruje zasoby platformy Azure, udostępnia szablony infrastruktury jako kodu (IaC) i wyświetla kroki wdrażania oparte na docelowej usłudze hostingu i wybranym narzędziu aprowizacji. Na przykład docelowe usługi hostingu obejmują usługi Azure Container Apps, Azure App Service lub Azure Kubernetes Service (AKS). W przypadku narzędzi aprowizacji, przykłady obejmują Azure Developer CLI (azd), Azure CLI z Bicepem lub Terraform.

To narzędzie nie skanuje obszaru roboczego ani automatycznie wykrywa zasobów. Analizujesz projekt, określasz struktury, zależności i istniejące zasoby, wybierasz usługę hostingową i narzędzie aprowizacji, a następnie podajesz te wartości, aby wygenerować plan.

Przykładowe monity obejmują:

  • "Jak utworzyć plan wdrożenia krok po kroku dla nazwy projektu "my-webapp" na platformie Azure z opcją wdrażania "provision-and-deploy", narzędziem aprowizacji "AZD", typem źródłowym "from-project", docelową usługą app service "WebApp", folderem obszaru roboczego "/home/dev/my-webapp" i opcjami IaC "bicep"?"
Parameter Wymagane lub opcjonalne Description
Opcja Wdróż Opcjonalnie Ustaw wartość na podstawie danych wejściowych projektu i użytkownika. Prawidłowe wartości: provision-and-deploy, , deploy-onlyprovision-only. Wybierz deploy-only , kiedy wdrażasz istniejące zasoby platformy Azure lub gdy istnieją już pliki IaC. Wybierz provision-only , kiedy chcesz aprowizować tylko zasoby platformy Azure. Wybierz provision-and-deploy , kiedy chcesz aprowizować infrastrukturę i wdrożyć aplikację.
Nazwa projektu Wymagane Nazwa projektu do wygenerowania planu wdrożenia. Jeśli nie podasz nazwy projektu, narzędzie wywnioskuje je z obszaru roboczego.
Narzędzie do wdrażania Opcjonalnie Narzędzie do aprowizowania zasobów platformy Azure. Prawidłowe wartości: AzCli, AZD. Na przykład interfejs wiersza polecenia dla deweloperów platformy Azure (azd) lub interfejs wiersza polecenia platformy Azure z aplikacją Bicep.
Typ źródła Opcjonalnie Źródło, z którego pochodzi plan do wygenerowania. Prawidłowe wartości: from-project, , from-azurefrom-context. Użyj from-project, aby oprzeć plan na plikach projektu w obszarze roboczym. Użyj from-azure, aby oprzeć plan na istniejących zasobach Azure. Użyj from-context polecenia , aby oprzeć plan na wartościach podanych, gdy nie istnieją żadne pliki projektu ani zasoby platformy Azure.
Docelowa usługa aplikacji Opcjonalnie Usługa platformy Azure służąca do wdrażania aplikacji. Prawidłowe wartości: ContainerApp, , WebAppFunctionApp, AKS. Zaleca się wybór na podstawie architektury aplikacji i środowiska uruchomieniowego.
Folder obszaru roboczego Wymagane Pełna ścieżka folderu obszaru roboczego.
Opcje IaC Opcjonalnie Opcja Infrastruktura jako kod. Prawidłowe wartości: bicep, terraform. Pozostaw wartość pustą, aby użyć skryptu interfejsu wiersza polecenia platformy Azure.

Wskazówki adnotacji narzędzi:

Destrukcyjny Idempotentny Open World Tylko do odczytu Secret Wymagane lokalnie
❌ ✅ ❌ ✅ ❌ ❌

Treści powiązane

  • Last updated on