Azure fejlesztési eszközök kezelése a(z) azd tool segítségével

A Azure fejlesztői parancssori felület (azd) beépített azd tool parancscsoportot tartalmaz a Azure-alkalmazások létrehozásához és szállításához használt gyakori eszközök felderítéséhez, telepítéséhez, frissítéséhez és állapotának ellenőrzéséhez. Az alapul szolgáló csomagkezelőket az egyes platformokon (például winget, brew, apt, , npmés a VS Code code CLI-n) egy konzisztens alparancskészlet mögé csomagolja, és támogatja az interaktív használatot és az automatizálást is.

A(z) azd tool gyakori használati esetei a következők:

  • Az összes ajánlott Azure fejlesztői eszköz telepítése egy új gépen egyetlen paranccsal.
  • A fejlesztési környezet szabványosítása egy csapaton vagy egy CI-ügynökcsoporton belül.
  • Annak naplózása, hogy mely Azure eszközök (és mely verziók) vannak telepítve egy adott gépen.
  • Frissítések keresése és alkalmazása a telepített eszközökre.
  • Szkriptelő eszköz beállítása folyamatláncokban nem interaktív kapcsolókkal és JSON-kimenettel.

Beépített eszközök

A beépített beállításjegyzék az alábbi eszközöket tartalmazza. A kategória- és prioritásoszlopokkal meghatározhatja, hogy mely eszközök vonatkoznak egy adott munkafolyamatra.

Azonosító Name Category Priority Tipikus telepítési stratégia
az-cli Azure CLI cli Recommended winget / brew / apt
github-copilot-cli GitHub Copilot parancssori felület cli Recommended winget / brew / npm
vscode-azure-tools Azure-eszközök (VS Code) extension Recommended code PARANCSSORI FELÜLET
vscode-bicep Bicep (VS Code) extension Recommended code PARANCSSORI FELÜLET
vscode-github-copilot GitHub Copilot (VS Code) extension Optional code PARANCSSORI FELÜLET
azure-mcp-server Azure MCP-kiszolgáló server Optional npm
azd-ai-extensions azd AI-bővítmények library Optional azd extension

A pontos telepítési stratégia az operációs rendszertől és a gépen elérhető csomagkezelőktől függ.

Megjegyzés

A VS Code-bővítmények használatához szükség van arra, hogy a(z) code rendszeren elérhető legyen a PATH parancssori felület. Ha code nem érhető el, az eszközök nincs telepítveként jelennek meg, és a azd tool használatával nem telepíthetők.

Parancsok áttekintése

A azd tool parancscsoport az alábbi alparancsokat tartalmazza.

Command Description
azd tool Elindít egy interaktív folyamatot, amely megjeleníti a telepített és elérhető eszközöket, és egy lépésben kéri az eszközök telepítését.
azd tool list Felsorolja az összes regisztrált eszközt, beleértve a telepítési állapotot, a verziót, a kategóriát és a prioritást.
azd tool show <id> Részletes információkat jelenít meg egy adott eszközről, beleértve a platformonkénti telepítési stratégiákat és a projekt webhelyét.
azd tool check Ellenőrzi a telepített eszközöket az elérhető frissítésekért.
azd tool install [ids...] Egy vagy több eszköz telepítése a következő szerint id: .
azd tool upgrade [ids...] Egy vagy több telepített eszköz frissítése.
azd tool uninstall [ids...] Eltávolít egy vagy több eszközt. Kihagyhatja ids az eszközök interaktív kiválasztását. Támogatja a tömeges eltávolítást és --dry-runa --output json.

Minden parancs támogatja --output json a szkriptekhez és folyamatokhoz megfelelő, géppel olvasható kimenetet.

Az eszközismeretek esetében a JSON-kimenet felsorolja az egyes ügynökök egyes készségeit, és tartalmaz egy agent mezőt. Például:

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

Gyakori jelzők

A következő jelölők érhetők el itt: install és upgrade:

  • --all: Minden jogosult eszközt telepít vagy frissít. A(z) install esetében ez a parancs tartalmazza az összes ajánlott eszközt. A(z) upgrade esetében ez a parancs az összes olyan telepített eszközt felsorolja, amelyhez elérhető frissítés.

A install, upgradeés uninstall parancsok módosítás nélkül támogatják --dry-run a műveletek előnézetét.

A következő beállítások szabályozzák a kérési viselkedést:

  • azd automatikusan futhat nem interaktív üzemmódban, ha CI/CD- vagy AI-ügynök környezetet észlel.
  • --no-prompt: Explicit módon letiltja az interaktív kéréseket.
  • AZD_NON_INTERACTIVE=true: Explicit módon letiltja az interaktív kéréseket.
  • AZD_NON_INTERACTIVE=false: Kifejezetten engedélyezve hagyja a megerősítést kérő üzemmódot, még észlelt CI/CD- vagy AI-ügynök környezetekben is.
  • Az explicit --no-prompt és AZD_NON_INTERACTIVE az értékek felülbírálják a környezet automatikus észlelését.

Minta használati eset: fejlesztői gép indítása

Az ajánlott Azure fejlesztői eszközök teljes készletének új gépen való beállításához futtassa a következő parancsot:

azd tool install --all

Ez a parancs telepíti a beállításjegyzékben szereplő recommended összes eszközt a megfelelő csomagkezelő használatával az aktuális platformhoz. Ha módosítás nélkül szeretné megtekinteni a telepítési műveleteket, adja hozzá a következőt --dry-run:

azd tool install --all --dry-run

A telepített eszközök naprakészen tartásához futtassa a következő parancsokat:

azd tool check
azd tool upgrade --all

Telepített és elérhető eszközök listázása

A azd tool list futtatásával megjelenítheti az összes regisztrált eszközt, azok telepítési állapotát és telepített verzióját:

$ 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

Ha ugyanazokat az adatokat szeretné visszaadni, mint a JSON szkripteléshez, futtassa a következőt:

azd tool list --output json

Eszköz részleteinek megjelenítése

Futtassa a(z) azd tool show <id> parancsot egy adott eszköz adatainak megtekintéséhez, beleértve az egyes támogatott platformokra vonatkozó telepítési stratégiákat és a projekt webhelyét:

azd tool show az-cli

Egy vagy több eszköz telepítése

Konkrét eszközök telepítéséhez adjon meg egy vagy több eszközértéket id:

azd tool install az-cli vscode-bicep

Az ajánlott eszközök telepítéséhez használja a következőt --all:

azd tool install --all

Ha futtatás nélkül szeretné megtekinteni a telepítési parancsokat, adja hozzá a következőt --dry-run:

azd tool install az-cli --dry-run

Az alparancs nélküli futtatás azd tool egy interaktív folyamatot indít el, amely megjeleníti a telepített eszközöket, lehetővé teszi a további eszközök kiválasztását, és egyetlen lépésben telepíti őket.

Frissítések keresése

Futtassa a azd tool check parancsot a telepített eszközök elérhető frissítéseinek kereséséhez:

azd tool check

Eszközök frissítése

Adott eszközök frissítése az értékük id átadásával:

azd tool upgrade az-cli github-copilot-cli

Frissítsen mindent, amihez elérhető frissítés:

azd tool upgrade --all

A frissítési csomag előzetes verziója alkalmazás nélkül:

azd tool upgrade --all --dry-run

Eszközök eltávolítása

Egy vagy több eszköz eltávolítása az értékek átadásával id .

azd tool uninstall az-cli azure-mcp-server

Eltávolítás előnézete módosítások nélkül:

azd tool uninstall vscode-bicep --dry-run

Az eszközök interaktív kiválasztásához futtassa azd tool uninstall eszközazonosítók nélkül. Ha el szeretne távolítani egy képességet egy adott AI-ügynökből, használja a következőt --agent: .

azd tool uninstall my-skill --agent copilot

Adja hozzá --output json , ha szüksége van az eltávolítás eredményére egy szkriptben vagy folyamatban.

Első használati élmény

Az ajánlott Azure-fejlesztői eszközök megkereséséhez és telepítéséhez futtassa kifejezetten a(z) azd tool elemet. A korábbi verzióktól eltérően a munkafolyamat-parancsok, például azd inita , azd upés azd deploy többé nem aktiválnak automatikus eszközellenőrzési kérést.

A parancsok futtatásakor azd tool az alábbi lehetőségek bármelyikével kihagyhatja az interaktív utasításokat:

  • Adja át a(z) --no-prompt argumentumot a parancsnak.
  • Állítsa be a környezeti változót AZD_NON_INTERACTIVE=true.
  • Futtatás felismert CI/CD- vagy AI-ügynökkörnyezetben. azd automatikusan megkerülheti az interaktív kéréseket.

Ha az észlelt CI/CD- vagy AI-ügynökkörnyezetben továbbra is engedélyezni szeretné a kérést, állítsa be a következőt AZD_NON_INTERACTIVE=false: . A --no-prompt és AZD_NON_INTERACTIVE explicit módon megadott értékei felülírják az automatikus észlelést.

CI és nem interaktív forgatókönyvek

A azd tool parancscsoport a következő lehetőségeken keresztül támogatja a folyamatokat és a szkripteket:

  • Használjon pozícióargumentumokat id a install, upgradeés uninstall az interaktív kijelölés elkerülése érdekében.
  • Adjon hozzá --no-prompt, állítson be AZD_NON_INTERACTIVE=truevagy támaszkodjon az automatikus észlelésre CI/CD- vagy AI-ügynökkörnyezetekben a kérések letiltásához.
  • Állítsa a(z) AZD_NON_INTERACTIVE=false értéket úgy, hogy letiltsa az automatikus észlelést, és a rákérdezés engedélyezve maradjon CI/CD- vagy AI-ügynök-környezetekben.
  • A --no-prompt és AZD_NON_INTERACTIVE explicit módon megadott értékei felülírják az automatikus észlelést.
  • Az alsóbb rétegbeli lépések strukturált eredményeinek rögzítésére használható --output json .

Az alábbi példa egy folyamatlépésben telepíti a Azure CLI és a Bicep bővítményt:

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

Kapcsolódó tartalom

  • Utolsó frissítés időpontja: