Zarządzanie narzędziami programistycznymi Azure za pomocą azd tool

Interfejs wiersza polecenia dewelopera Azure (azd) zawiera wbudowaną grupę poleceń azd tool na potrzeby odnajdywania, instalowania, uaktualniania i sprawdzania stanu typowych narzędzi używanych do kompilowania i dostarczania aplikacji Azure. Stanowi nakładkę na bazowe menedżery pakietów na każdej platformie (takie jak winget, brew, apt, npm i interfejs wiersza polecenia VS Code code), udostępniając spójny zestaw podpoleceń, oraz obsługuje zarówno użycie interaktywne, jak i automatyzację.

Najczęstsze zastosowania azd tool to:

  • Zainstalowanie wszystkich zalecanych Azure narzędzi programistycznych na nowej maszynie przy użyciu jednego polecenia.
  • Ujednolicenie środowiska programistycznego w całym zespole lub wśród grupy agentów CI.
  • Inspekcja, które narzędzia Azure (i które wersje) są instalowane na danej maszynie.
  • Sprawdzanie i stosowanie aktualizacji do zainstalowanych narzędzi.
  • Konfiguracja narzędzia do obsługi skryptów w potokach przy użyciu flag nieinterakcyjnych i danych wyjściowych JSON.

Wbudowane narzędzia

Wbudowany rejestr zawiera następujące narzędzia. Użyj kolumn kategorii i priorytetu, aby określić, które narzędzia mają zastosowanie do danego przepływu pracy.

Id Name Category Priority Typowa strategia instalacji
az-cli Azure CLI cli Zalecane winget / brew / apt
github-copilot-cli interfejs wiersza polecenia GitHub Copilot cli Zalecane winget / brew / npm
vscode-azure-tools narzędzia Azure (VS Code) extension Zalecane code Interfejs linii komend (CLI)
vscode-bicep Bicep (VS Code) extension Zalecane code Interfejs linii komend (CLI)
vscode-github-copilot GitHub Copilot (VS Code) extension Optional code Interfejs linii komend (CLI)
azure-mcp-server Azure serwer MCP server Optional npm
azd-ai-extensions azd Rozszerzenia sztucznej inteligencji library Optional azd extension

Dokładna strategia instalacji zależy od systemu operacyjnego i menedżerów pakietów dostępnych na maszynie.

Note

Rozszerzenia programu VS Code wymagają, aby interfejs CLI code był dostępny na urządzeniu PATH. Jeśli code nie jest dostępna, narzędzia są wyświetlane jako nieinstalowane i nie można ich zainstalować za pomocą programu azd tool.

Omówienie poleceń

Grupa azd tool poleceń zawiera następujące polecenia podrzędne.

Polecenie Description
azd tool Uruchamia interaktywny proces, który wyświetla zainstalowane i dostępne narzędzia oraz umożliwia wybranie narzędzi do zainstalowania w jednym kroku.
azd tool list Wyświetla listę wszystkich zarejestrowanych narzędzi, w tym stan instalacji, wersję, kategorię i priorytet.
azd tool show <id> Przedstawia szczegółowe informacje dotyczące określonego narzędzia, w tym strategie instalacji dla poszczególnych platform i witrynę internetową projektu.
azd tool check Sprawdza zainstalowane narzędzia pod kątem dostępnych aktualizacji.
azd tool install [ids...] Instaluje co najmniej jedno narzędzie za pomocą polecenia id.
azd tool upgrade [ids...] Uaktualnia co najmniej jedno zainstalowane narzędzia.
azd tool uninstall [ids...] Usuwa co najmniej jedno narzędzie. Pomiń ids wybór narzędzi interaktywnie. Obsługuje usuwanie zbiorcze, --dry-run, i --output json.

Wszystkie polecenia obsługują opcję --output json, która zapewnia dane wyjściowe w formacie czytelnym dla maszyn, odpowiednim dla skryptów i potoków danych.

W przypadku umiejętności narzędzi dane wyjściowe JSON zawierają listę każdej umiejętności dla każdego agenta i zawiera agent pole. Przykład:

{
  "skills": [
    {
      "id": "my-skill",
      "agent": "copilot"
    }
  ]
}

Typowe flagi

Następujące flagi są dostępne w systemach install i upgrade:

  • --all: instaluje lub uaktualnia każde kwalifikujące się narzędzie. W przypadku install to polecenie zawiera wszystkie zalecane narzędzia. W przypadku polecenia upgrade to polecenie obejmuje wszystkie zainstalowane narzędzia, dla których są dostępne aktualizacje.

Polecenia install, upgradei uninstall obsługują --dry-run akcje podglądu bez wprowadzania zmian.

Następujące opcje kontrolują zachowanie monitujące:

  • azd może działać automatycznie w trybie nieinteraktywnym, gdy wykryje środowisko CI/CD lub agenta AI.
  • --no-prompt: Jawnie wyłącza interaktywne monity.
  • AZD_NON_INTERACTIVE=true: Jawnie wyłącza interaktywne monity.
  • AZD_NON_INTERACTIVE=false: Jawnie pozostawia prompty włączone, nawet w wykrytych środowiskach CI/CD lub agentów AI.
  • Jawne --no-prompt i AZD_NON_INTERACTIVE wartości zastępują automatyczne wykrywanie środowiska.

Przykładowy przypadek użycia: przygotowanie maszyny programistycznej od podstaw

Aby skonfigurować kompletny zestaw zalecanych narzędzi programistycznych Azure na nowej maszynie, uruchom następujące polecenie:

azd tool install --all

To polecenie instaluje każde narzędzie oznaczone jako recommended w rejestrze przy użyciu odpowiedniego menedżera pakietów dla bieżącej platformy. Aby wyświetlić podgląd akcji instalacji bez wprowadzania zmian, dodaj polecenie --dry-run:

azd tool install --all --dry-run

Aby zachować bieżące zainstalowane narzędzia, uruchom następujące polecenia:

azd tool check
azd tool upgrade --all

Lista zainstalowanych i dostępnych narzędzi

Uruchom polecenie azd tool list , aby wyświetlić każde zarejestrowane narzędzie, jego stan instalacji i zainstalowaną wersję:

$ azd tool list

  Id                     Name                      Category    Priority      Status          Version
  ─────────────────────  ────────────────────────  ──────────  ────────────  ──────────────  ────────
  az-cli                 Azure CLI                 cli         recommended   Installed       2.67.0
  github-copilot-cli     GitHub Copilot CLI        cli         recommended   Not Installed
  vscode-azure-tools     Azure Tools (VS Code)     extension   recommended   Installed       0.9.0
  vscode-bicep           Bicep (VS Code)           extension   recommended   Installed       0.30.0
  vscode-github-copilot  GitHub Copilot (VS Code)  extension   optional      Not Installed
  azure-mcp-server       Azure MCP Server          server      optional      Not Installed
  azd-ai-extensions      azd AI Extensions         library     optional      Not Installed

Aby zwrócić te same dane co kod JSON na potrzeby skryptów, uruchom polecenie:

azd tool list --output json

Pokaż szczegóły narzędzia

Uruchom polecenie azd tool show <id> , aby sprawdzić określone narzędzie, w tym strategie instalacji, które mają zastosowanie do każdej obsługiwanej platformy i witryny internetowej projektu:

azd tool show az-cli

Instalowanie co najmniej jednego narzędzia

Przekaż co najmniej jedną wartość narzędzia id , aby zainstalować określone narzędzia:

azd tool install az-cli vscode-bicep

Aby zainstalować każde zalecane narzędzie, użyj polecenia --all:

azd tool install --all

Aby wyświetlić podgląd poleceń instalacji bez ich uruchamiania, dodaj polecenie --dry-run:

azd tool install az-cli --dry-run

Uruchamianie azd tool bez podpolecenia uruchamia interaktywny przepływ, który wyświetla zainstalowane narzędzia, umożliwia wybór dodatkowych narzędzi i instaluje je w jednym kroku.

Sprawdzanie dostępności aktualizacji

Uruchom polecenie azd tool check , aby skanować zainstalowane narzędzia pod kątem dostępnych aktualizacji:

azd tool check

Narzędzia uaktualniania

Uaktualnij określone narzędzia, przekazując ich id wartości:

azd tool upgrade az-cli github-copilot-cli

Uaktualnij wszystko, co ma dostępną aktualizację:

azd tool upgrade --all

Wyświetl podgląd planu uaktualniania bez stosowania go:

azd tool upgrade --all --dry-run

Narzędzia do odinstalowywania

Usuń co najmniej jedno narzędzie, przekazując ich id wartości.

azd tool uninstall az-cli azure-mcp-server

Wyświetl podgląd usunięcia bez wprowadzania zmian:

azd tool uninstall vscode-bicep --dry-run

Uruchamianie azd tool uninstall bez identyfikatorów narzędzi w celu interaktywnego wybierania narzędzi. Aby usunąć umiejętności z określonego agenta sztucznej inteligencji, użyj polecenia --agent.

azd tool uninstall my-skill --agent copilot

Dodaj --output json , gdy jest potrzebny wynik usunięcia skryptu lub potoku.

Pierwsze uruchomienie

Aby odnaleźć i zainstalować zalecane narzędzia programistyczne Azure, uruchom azd tool je jawnie. W przeciwieństwie do poprzednich wersji polecenia przepływu pracy, takie jak azd init, azd up i azd deploy, nie powodują już automatycznego wyświetlenia monitu o sprawdzenie narzędzi.

Użyj dowolnej z poniższych opcji, aby pominąć interaktywne monity podczas uruchamiania poleceń azd tool:

  • Przekaż --no-prompt polecenie .
  • Ustaw zmienną środowiskową AZD_NON_INTERACTIVE=true.
  • Uruchom w wykrytym środowisku CI/CD lub agenta SI. azd może automatycznie pomijać interaktywne pytania.

Aby pozostawić wyświetlanie monitów włączone w wykrytym środowisku CI/CD lub agenta AI, ustaw AZD_NON_INTERACTIVE=false. Jawne --no-prompt i AZD_NON_INTERACTIVE wartości zastępują automatyczne wykrywanie.

Scenariusze CI i nieinteraktywne

Grupa poleceń azd tool obsługuje potoki i skrypty za pomocą następujących opcji:

  • Użyj argumentów pozycyjnych id z elementami install, upgradei , aby uninstall uniknąć zaznaczenia interakcyjnego.
  • Dodaj --no-prompt, ustaw AZD_NON_INTERACTIVE=true, lub polegaj na automatycznym wykrywaniu w środowiskach ciągłej integracji/ciągłego wdrażania (CI/CD) lub agentów AI, aby wyłączyć monity.
  • Ustawienie AZD_NON_INTERACTIVE=false wyłącza automatyczne wykrywanie i pozostawia włączone monity w środowiskach CI/CD lub agentów AI.
  • Jawne --no-prompt i AZD_NON_INTERACTIVE wartości zastępują automatyczne wykrywanie.
  • Użyj polecenia --output json , aby przechwycić wyniki ustrukturyzowane dla kroków podrzędnych.

Poniższy przykład instaluje Azure CLI i rozszerzenie Bicep w kroku potoku:

azd tool install az-cli vscode-bicep --no-prompt --output json

Treści powiązane

  • Last updated on