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.

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.

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.
  • --dry-run: wyświetla podgląd akcji azd bez wprowadzania żadnych zmian.

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

  • --no-prompt: Wyłącza interaktywne monity. Przydatne w skryptach.
  • AZD_NON_INTERACTIVE=true: Zmienna środowiskowa równoważna zmiennej .--no-prompt
  • AZD_SKIP_FIRST_RUN=true: Wyłącza monit sprawdzenia narzędzia przy pierwszym uruchomieniu.

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

azd Uruchamia również okresowe sprawdzanie aktualizacji w tle i wyświetla nieinwazyjne powiadomienia, gdy są dostępne nowsze wersje zarejestrowanych narzędzi.

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

Pierwsze uruchomienie

Przy pierwszym uruchomieniu polecenia przepływu pracy, takiego jak azd init, azd uplub azd deploy , azd wykonuje jednorazowe sprawdzanie narzędzia i monituje o przejrzenie lub zainstalowanie zalecanych narzędzi.

Użyj dowolnej z poniższych opcji, aby pominąć lub wyłączyć monit pierwszego uruchomienia:

  • Przekaż --no-prompt w poleceniu przepływu pracy.
  • Ustaw zmienną środowiskową AZD_SKIP_FIRST_RUN=true.
  • Uruchom w wykrytym środowisku CI. azd automatycznie pomija monit, gdy ustawiono CI, TF_BUILD lub GITHUB_ACTIONS.

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 argumentami install i upgrade, aby uniknąć interaktywnego wyboru.
  • Dodaj --no-prompt lub ustaw opcję AZD_NON_INTERACTIVE=true pomijania monitów.
  • Użyj polecenia --output json , aby przechwycić wyniki ustrukturyzowane dla kroków podrzędnych.
  • Korzystaj z automatycznego wykrywania CI, które wyłącza monit przy pierwszym uruchomieniu i powiadomienia o aktualizacjach w tle.

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