Azure CLI-bővítmények kezelése: Telepítés, frissítés és eltávolítás

Az Azure CLI lehetővé teszi bővítmények betöltését. Az Azure CLI bővítményei úgy jellemezhetők, mint Python wheel-ek, amelyek nem a CLI részeként vannak szállítva, hanem parancssorké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 karbantartott 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

Miután megtalálta a telepíteni kívánt bővítményt, az az extension add használatával telepítse. Ha a bővítmény megjelenik a az extension list-available kimenetében, 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 kiterjesztésnek feltétlenül egy kompilált Python wheel-fájlnak kell lennie.

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

Létrehozhat egy privát bővítményindexet is a index.json formátuma alapján, majd a verziótól 2.20.0kezdve beállíthatja az Azure CLI által használt bővítményindex URL-címét. Ezután 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 telepítése után a rendszerhéjváltozó értéke $AZURE_EXTENSION_DIR alatt jelenik meg. Ha ez a változó nincs beállítva, az alapértelmezett hely a $HOME/.azure/cliextensions megadott Linux és macOS rendszereken, illetve a %USERPROFILE%\.azure\cliextensions megadott Windows rendszeren található.

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 a verziótól 2.12.0kezdve engedélyezve van. A korábbi támogatott verziók konfigurálásával is engedélyezheti.

az config set extension.use_dynamic_install=yes_prompt

A következő konfigurációs paranccsal parancssor nélkül engedélyezheti a dinamikus telepítést.

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 viselkedés visszaállításához. Ha a bővítmény nincs telepítve, a bővítmény parancs nem található hibát ad vissza.

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 futnak. A tulajdonság run_after_dynamic_installbeállításával módosíthatja az alapértelmezett viselkedést, és újrafuttatás nélkül kiléphet a no parancsból.

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 azt az az extension update használatával.

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 feloldani a bővítmény nevét a parancssori felülettel, távolítsa el a bővítményt, és próbálja meg újratelepíteni. A bővítmény az alapszintű parancssori felület része is lehet. Frissítse a parancssori felületet az Azure CLI telepítésében leírtak szerint, és ellenőrizze, hogy elérhetők-e a bővítmény parancsai.

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>

Gyakran Ismételt Kérdések

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 a parancssori felület figyelmeztetést ad ki a lecserélt parancsok futtatása előtt.

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 másokat nem érint.

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-bővítmények