Bővítmények használata és kezelése az Azure CLI-vel

Az Azure CLI lehetővé teszi bővítmények betöltését. Az Azure CLI bővítményeit Python-kerekeknek nevezzük, amelyek nem a parancssori felület részeként vannak szállítva, hanem CLI-parancsként futnak. A bővítményekkel hozzáférhet a kísérleti és előzetes parancsokhoz, valamint saját CLI-felületeket írhat. Ez a cikk bemutatja, hogyan kezelheti a bővítményeket, és megválaszolja a használatukkal kapcsolatos gyakori kérdéseket.

Bővítmények keresése

A Microsoft által biztosított és fenntartott Azure CLI-bővítmények megtekintéséhez használja az az extension list-available parancsot.

az extension list-available --output table

A bővítmények listája a dokumentációs webhelyen is elérhető.

Bővítmények telepítése

Bővítmények manuális telepítése

Ha megtalálta a telepítendő bővítményt, az az extension add parancs használatával szerezze be. Ha a bővítmény szerepel azaz extension list-available parancs listájában, akkor név alapján telepítheti.

az extension add --name <extension-name>

Ha a bővítmény külső erőforrásból származik vagy van közvetlen hivatkozás hozzá, adja meg a forrás URL-címét vagy a helyi útvonalat. A bővítménynek feltétlenül lefordított Python wheel-fájlnak kell lennie.

az extension add --source <URL-or-path>

Létrehozhat egy privát bővítményindexet is az index.json formátumban, majd beállíthatja az Azure CLI által használt bővítményindex URL-címét a verziótól 2.20.0kezdve. Ezt követően név szerint telepítheti a bővítményt a privát bővítményindexből.

az config set extension.index_url=<URL>
az extension add --name <extension-name>

A bővítmény a telepítés után megtalálható az $AZURE_EXTENSION_DIR felületváltozóban. Ha ez a változó nincs beállítva, akkor az alapértelmezett értéke $HOME/.azure/cliextensions a Linux és macOS rendszereken, és %USERPROFILE%\.azure\cliextensions a Windows rendszereken.

Bővítmények automatikus telepítése

Ha nem telepített bővítményparancsot futtat, az Azure CLI felismeri a futtatott parancsot, és a verziótól 2.10.0kezdve automatikusan telepíti a bővítményt. Ez a dinamikus telepítésnek nevezett funkció alapértelmezés szerint engedélyezve van a óta 2.12.0. A korábbi támogatott verziók konfigurálásával is engedélyezheti.

az config set extension.use_dynamic_install=yes_prompt

A dinamikus telepítés parancssor nélküli engedélyezéséhez használja a következő konfigurációs parancsot.

az config set extension.use_dynamic_install=yes_without_prompt

Az alábbi konfigurációs paranccsal kikapcsolhatja a dinamikus telepítési funkciót az alapértelmezett működés visszaállításához. A bővítményparancs parancs nem található hibát ad vissza, ha a bővítmény nincs telepítve.

az config set extension.use_dynamic_install=no

Alapértelmezés szerint a dinamikus telepítést kérő bővítményparancsok a bővítmény telepítése után is futni fognak. Módosíthatja az alapértelmezett viselkedést, és újrafuttatás nélkül kiléphet a parancsból, ha a tulajdonságot értékre run_after_dynamic_installnoállítja.

az config set extension.run_after_dynamic_install=no

Bővítmények frissítése

Ha név alapján telepít egy bővítményt, frissítse az az extension update paranccsal.

az extension update --name <extension-name>

Ellenkező esetben a bővítmények a forrásból frissíthetők, a Bővítmények telepítése című szakaszban található utasítások szerint.

Ha nem tudja a parancssori felülettel feloldani a bővítmény nevét, távolítsa el, és próbálja meg újratelepíteni. A bővítmény az alap CLI részévé is válhat. Próbálja meg frissíteni a CLI-t az Azure CLI telepítése című szakaszban leírtak szerint, és ellenőrizze, hogy a bővítmény parancsai megjelentek-e.

Bővítmények eltávolítása

Ha már nincs szüksége egy bővítményre, távolítsa el az az extension remove paranccsal.

az extension remove --name <extension-name>

A bővítményt manuálisan is eltávolíthatja úgy, hogy törli a telepítési helyről. Az $AZURE_EXTENSION_DIR felületváltozó határozza meg a modulok telepítésének helyét. Ha ez a változó nincs beállítva, akkor az alapértelmezett értéke $HOME/.azure/cliextensions a Linux és macOS rendszereken, és %USERPROFILE%\.azure\cliextensions a Windows rendszereken.

rm -rf $AZURE_EXTENSION_DIR/<extension-name>

GYIK

Néhány válasz a CLI bővítményeivel kapcsolatos gyakori kérdésekre.

Milyen fájlformátumok engedélyezettek a telepítéshez?

Jelenleg csak a lefordított Python wheel-fájlok telepíthetők bővítményként.

A bővítmények lecserélhetnek meglévő parancsokat?

Igen. A bővítmények lecserélhetik a meglévő parancsokat, de egy lecserélt parancs futtatása előtt a parancssori felület figyelmeztetést ad ki.

Hogyan állapíthatom meg, hogy egy bővítmény előzetes verzióban van-e?

A bővítmény dokumentációja és verziószámozása azt mutatja, hogy előzetes verzióban van-e. A Microsoft gyakran CLI-bővítményként adja ki az előzetes verziójú parancsokat, biztosítva a lehetőséget későbbi áthelyezésükre a fő CLI-termékbe. Amikor megtörténik a parancsok áthelyezése a bővítményekből, a régi bővítményt el kell távolítani.

Függhetnek egymástól a bővítmények?

Nem. Mivel a CLI nem garantálja a betöltés sorrendet, előfordulhat, hogy a függőségeket nem sikerül kielégíteni. A bővítmények eltávolítása nincs hatással másokra.

A CLI frissítésével a bővítmények frissítése is megtörténik?

Nem. A bővítményeket külön kell frissíteni a Bővítmények frissítése című szakaszban leírtak szerint.

Hogyan fejleszthetjük ki a saját bővítményünket?

További segítségért tekintse meg a hivatalos adattárat. Azure/azure-cli-extensions