Správa rozšíření Azure CLI: Instalace, aktualizace a odebrání

Azure CLI umožňuje načtení rozšíření. Rozšíření pro Azure CLI jsou charakterizována jako Python balíčky, které nejsou součástí CLI, ale běží jako jeho příkazy. S rozšířeními získáte přístup k experimentálním a předběžným příkazům spolu s možností psát vlastní rozhraní rozhraní příkazového řádku. Tento článek popisuje správu rozšíření a odpovídá na běžné dotazy ohledně jejich využití.

Jak najít rozšíření

Pokud chcete zobrazit rozšíření Azure CLI poskytovaná a udržovaná Microsoftem, použijte příkaz az extension list-available .

az extension list-available --output table

Na webu dokumentace také hostujeme seznam rozšíření .

Postup instalace rozšíření

Ruční instalace rozšíření

Jakmile najdete rozšíření k instalaci, nainstalujte ho pomocí příkazu az extension add . Pokud se rozšíření zobrazí ve výstupu az extension list-available, můžete ho nainstalovat podle názvu.

az extension add --name <extension-name>

Pokud je rozšíření z externího zdroje nebo pokud na něj máte přímý odkaz, zadáte zdrojovou adresu URL nebo místní cestu. Přípona musí být zkompilovaný soubor ve formátu wheel pro Python.

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

Můžete také vytvořit index privátního rozšíření podle formátu v index.jsona pak nastavit adresu URL indexu rozšíření, kterou používá Azure CLI, počínaje verzí 2.20.0. Potom můžete rozšíření nainstalovat podle názvu z indexu privátního rozšíření.

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

Po instalaci rozšíření se zobrazí pod hodnotou $AZURE_EXTENSION_DIR shellové proměnné. Pokud tato proměnná není nastavená, výchozí umístění je $HOME/.azure/cliextensions v Linuxu a macOS a %USERPROFILE%\.azure\cliextensions ve Windows.

Automatická instalace rozšíření

Když spustíte příkaz rozšíření, který není nainstalovaný, azure CLI dokáže rozpoznat spuštěný příkaz a automaticky nainstalovat rozšíření od verze 2.10.0. Tato funkce, označovaná jako dynamická instalace, je ve výchozím nastavení povolená od verze 2.12.0. Můžete ho také povolit prostřednictvím konfigurace pro předchozí podporované verze.

az config set extension.use_dynamic_install=yes_prompt

Pomocí následujícího příkazu konfigurace povolte dynamickou instalaci bez výzvy.

az config set extension.use_dynamic_install=yes_without_prompt

Pomocí následujícího příkazu konfigurace vypněte funkci dynamické instalace, abyste se vrátili k výchozímu chování. Příkaz rozšíření vrátí chybu typu command-not-found, pokud rozšíření není nainstalované.

az config set extension.use_dynamic_install=no

Ve výchozím nastavení se příkaz rozšíření, který zobrazí výzvu k dynamické instalaci, bude po instalaci rozšíření dál spuštěn. Výchozí chování můžete změnit tak, že nastavíte vlastnost na run_after_dynamic_install, a tím ukončíte příkaz bez opakovaného no spuštění.

az config set extension.run_after_dynamic_install=no

Jak aktualizovat rozšíření

Pokud nainstalujete rozšíření podle názvu, aktualizujte ho pomocí příkazu az extension update.

az extension update --name <extension-name>

V opačném případě je možné rozšíření aktualizovat ze zdroje podle pokynů k instalaci rozšíření .

Pokud nemůžete použít rozhraní příkazového řádku k překladu názvu rozšíření, odinstalujte rozšíření a zkuste ho přeinstalovat. Rozšíření může být také součástí základního rozhraní příkazového řádku. Aktualizujte rozhraní příkazového řádku podle popisu v části Instalace Azure CLI a zkontrolujte, jestli jsou příkazy rozšíření k dispozici.

Postup odinstalace rozšíření

Pokud rozšíření už nepotřebujete, odeberte ho příkazem az extension remove.

az extension remove --name <extension-name>

Rozšíření můžete také odebrat ručně tak, že ho odstraníte z umístění, kde bylo nainstalované. Proměnná shellu $AZURE_EXTENSION_DIR definuje, kde se instalují moduly. Pokud tato proměnná není nastavena, její výchozí hodnota v Linuxu a macOS je $HOME/.azure/cliextensions a ve Windows to je %USERPROFILE%\.azure\cliextensions.

rm -rf $AZURE_EXTENSION_DIR/<extension-name>

Nejčastější dotazy

Tady jsou některé odpovědi na další běžné otázky týkající se rozšíření rozhraní příkazového řádku.

Jaké formáty souborů jsou povoleny pro instalaci?

V současné době lze jako rozšíření nainstalovat pouze kompilovaná kola Pythonu.

Mohou rozšíření nahradit existující příkazy?

Ano. Rozšíření můžou nahradit existující příkazy, ale rozhraní příkazového řádku před spuštěním nahrazeného příkazu vydá upozornění.

Jak zjistím, jestli je rozšíření v předběžné verzi?

Dokumentace a správa verzí rozšíření ukazují, jestli je v předběžné verzi. Microsoft často vydává příkazy Preview jako rozšíření rozhraní příkazového řádku s možností jejich pozdějšího přesunutí do hlavního produktu CLI. Když se příkazy přesunou z rozšíření, staré rozšíření by se mělo odinstalovat.

Mohou rozšíření záviset na sobě?

Ne. Vzhledem k tomu, že rozhraní příkazového řádku nezaručuje pořadí načítání, nemusí být závislosti splněné. Odebrání rozšíření nemá vliv na žádné jiné uživatele.

Aktualizují se rozšíření společně s rozhraním příkazového řádku?

Ne. Rozšíření musí být aktualizována samostatně, jak je popsáno v aktualizaci rozšíření.

Jak vyvíjet vlastní rozšíření?

Další pomoc najdete v oficiálním úložišti. Azure/azure-cli-extensions