Příkazy rozhraní příkazového řádku Bicep
Tento článek popisuje příkazy, které můžete použít v rozhraní příkazového řádku Bicep. Máte dvě možnosti pro spuštění těchto příkazů: buď pomocí Azure CLI, nebo přímým vyvoláním příkazů Rozhraní příkazového řádku Bicep. Každá metoda vyžaduje odlišný proces instalace. Další informace najdete v tématu Instalace Azure CLI a instalace Azure PowerShellu.
Tento článek ukazuje, jak spouštět příkazy v Azure CLI. Při spouštění prostřednictvím Azure CLI spustíte příkazy pomocí azpříkazu . Pokud nepoužíváte Azure CLI, spusťte příkazy bez az spuštění příkazu. Například az bicep build se stane bicep builda az bicep version stane bicep --versionse .
build
Příkaz build převede soubor Bicep na šablonu Azure Resource Manageru (šablonu ARM). Obvykle nemusíte tento příkaz spouštět, protože se spustí automaticky při nasazení souboru Bicep. Spusťte ho ručně, pokud chcete zobrazit JSON šablony ARM, který se vytvoří z vašeho souboru Bicep.
Následující příklad převede soubor Bicep s názvem main.bicep na šablonu ARM s názvem main.json. Nový soubor se vytvoří ve stejném adresáři jako soubor Bicep.
az bicep build --file main.bicep
Další příklad uloží main.json do jiného adresáře.
az bicep build --file main.bicep --outdir c:\jsontemplates
Další příklad určuje název a umístění souboru, který se má vytvořit.
az bicep build --file main.bicep --outfile c:\jsontemplates\azuredeploy.json
Pokud chcete soubor stdoutvytisknout, použijte:
az bicep build --file main.bicep --stdout
Pokud váš soubor Bicep obsahuje modul, který odkazuje na externí registr, příkaz sestavení automaticky volá obnovení. Příkaz pro obnovení získá soubor z registru a uloží ho do místní mezipaměti.
Poznámka:
Příkaz restore neaktualizuje mezipaměť. Další informace najdete v tématu obnovení.
Pokud nechcete volat obnovení automaticky, použijte --no-restore přepínač:
az bicep build --no-restore <bicep-file>
Proces sestavení s přepínačem --no-restore selže, pokud některý z externích modulů ještě není uložený v mezipaměti:
The module with reference "br:exampleregistry.azurecr.io/bicep/modules/storage:v1" has not been restored.
Když se zobrazí tato chyba, spusťte build příkaz bez --no-restore přepínače nebo nejprve spusťte bicep restore .
Pokud chcete přepínač použít --no-restore , musíte mít rozhraní příkazového řádku Bicep verze 0.4.X nebo vyšší.
build-params
Příkaz build-params sestaví soubor .bicepparam do souboru parametrů JSON.
az bicep build-params --file params.bicepparam
Tento příkaz převede soubor parametrů params.bicepparam na soubor parametrů JSON parametru params.json .
Dekompilovat
Příkaz decompile převede JSON šablony ARM na soubor Bicep.
az bicep decompile --file main.json
Příkaz vytvoří soubor s názvem main.bicep ve stejném adresáři jako main.json. Pokud main.bicep existuje ve stejném adresáři, použijte přepínač --force k přepsání existujícího souboru Bicep.
Další informace o použití tohoto příkazu najdete v tématu Dekompilování KÓDU JSON šablony ARM na Bicep.
decompile-params
Příkaz decompile-params dekompiluje soubor parametrů JSON do souboru parametrů .bicepparam .
az bicep decompile-params --file azuredeploy.parameters.json --bicep-file ./dir/main.bicep
Tento příkaz dekompiluje soubor parametrů azuredeploy.parameters.json do souboru azuredeploy.parameters.bicepparam . --bicep-file určuje cestu k souboru Bicep (vzhledem k souboru .bicepparam), na který odkazuje deklarace using .
format
Příkaz format naformátuje soubor Bicep. Má stejnou funkci jako zástupce v editoru SHIFT+ALT+F Visual Studio Code.
az bicep format --file main.bicep
generate-params
Příkaz generate-params sestaví soubor parametrů z daného souboru Bicep, aktualizuje se, pokud existuje soubor parametrů.
az bicep generate-params --file main.bicep --output-format bicepparam --include-params all
Příkaz vytvoří soubor parametrů Bicep s názvem main.bicepparam. Soubor parametrů obsahuje všechny parametry v souboru Bicep bez ohledu na to, jestli jsou nakonfigurované s výchozími hodnotami, nebo ne.
az bicep generate-params --file main.bicep --outfile main.parameters.json
Příkaz vytvoří soubor parametrů s názvem main.parameters.json. Soubor parametrů obsahuje pouze parametry bez výchozích hodnot nakonfigurovaných v souboru Bicep.
install
Příkaz install přidá rozhraní příkazového řádku Bicep do místního prostředí. Další informace najdete v tématu Instalace nástrojů Bicep. Tento příkaz je k dispozici pouze prostřednictvím Azure CLI.
Pokud chcete nainstalovat nejnovější verzi, použijte:
az bicep install
Instalace konkrétní verze:
az bicep install --version v0.3.255
Lint
Příkaz lint vrátí chyby a porušení pravidel linter souboru Bicep.
az bicep lint --file main.bicep
Pokud váš soubor Bicep obsahuje modul, který odkazuje na externí registr, příkaz lint automaticky volá obnovení. Příkaz pro obnovení získá soubor z registru a uloží ho do místní mezipaměti.
Poznámka:
Příkaz restore neaktualizuje mezipaměť. Další informace najdete v tématu obnovení.
Pokud nechcete volat obnovení automaticky, použijte --no-restore přepínač:
az bicep lint --no-restore <bicep-file>
Proces lint s přepínačem --no-restore selže, pokud některý z externích modulů ještě není uložený v mezipaměti:
The module with reference "br:exampleregistry.azurecr.io/bicep/modules/storage:v1" has not been restored.
Když se zobrazí tato chyba, spusťte lint příkaz bez --no-restore přepínače nebo nejprve spusťte bicep restore .
list-versions
Příkaz list-versions vrátí všechny dostupné verze rozhraní příkazového řádku Bicep. Pomocí tohoto příkazu zjistíte, jestli chcete upgradovat nebo nainstalovat novou verzi. Tento příkaz je k dispozici pouze prostřednictvím Azure CLI.
az bicep list-versions
Příkaz vrátí pole dostupných verzí.
[
"v0.20.4",
"v0.19.5",
"v0.18.4",
"v0.17.1",
"v0.16.2",
"v0.16.1",
"v0.15.31",
"v0.14.85",
"v0.14.46",
"v0.14.6",
"v0.13.1",
"v0.12.40",
"v0.12.1",
"v0.11.1",
"v0.10.61",
"v0.10.13",
"v0.9.1",
"v0.8.9",
"v0.8.2",
"v0.7.4",
"v0.6.18",
"v0.6.11",
"v0.6.1",
"v0.5.6",
"v0.4.1318",
"v0.4.1272",
"v0.4.1124",
"v0.4.1008",
"v0.4.613",
"v0.4.451"
]
publikování
Příkaz publish přidá modul do registru. Registr kontejneru Azure musí existovat a publikování účtu do registru musí mít správná oprávnění. Další informace o nastavení registru modulu naleznete v tématu Použití privátního registru pro moduly Bicep. Pokud chcete publikovat modul, musí mít účet správný profil a oprávnění pro přístup k registru. Můžete nakonfigurovat prioritu profilu a přihlašovacích údajů pro ověřování v registru v konfiguračním souboru Bicep.
Po publikování souboru do registru na něj můžete odkazovat v modulu.
Pokud chcete použít příkaz pro publikování, musíte mít rozhraní příkazového řádku Bicep verze 0.14.X nebo vyšší. Pokud chcete použít --documentationUri/-d parametr, musíte mít rozhraní příkazového řádku Bicep verze 0.14.X nebo vyšší.
Pokud chcete publikovat modul do registru, použijte:
az bicep publish --file <bicep-file> --target br:<registry-name>.azurecr.io/<module-path>:<tag> --documentationUri <documentation-uri>
Příklad:
az bicep publish --file storage.bicep --target br:exampleregistry.azurecr.io/bicep/modules/storage:v1 --documentationUri https://www.contoso.com/exampleregistry.html
Příkaz publish nerozpozná aliasy zadané v souboru bicepconfig.json . Zadejte úplnou cestu k modulu.
Upozorňující
Publikování do stejného cíle přepíše starý modul. Při aktualizaci doporučujeme zvýšit verzi.
Obnovení
Pokud váš soubor Bicep používá moduly publikované v registru, restore příkaz získá kopie všech požadovaných modulů z registru. Tyto kopie se ukládají v místní mezipaměti. Soubor Bicep lze sestavit pouze v případech, kdy jsou externí soubory k dispozici v místní mezipaměti. Normálně není spuštění obnovení nutné, protože se automaticky aktivuje procesem sestavení.
Pokud chcete obnovit externí moduly do místní mezipaměti, musí mít účet správný profil a oprávnění pro přístup k registru. Můžete nakonfigurovat prioritu profilu a přihlašovacích údajů pro ověřování v registru v konfiguračním souboru Bicep.
Pokud chcete použít příkaz pro obnovení, musíte mít rozhraní příkazového řádku Bicep verze 0.4.X nebo vyšší. Tento příkaz je aktuálně k dispozici pouze při přímém volání rozhraní příkazového řádku Bicep. V současné době není k dispozici prostřednictvím příkazu Azure CLI.
Pokud chcete externí moduly pro soubor obnovit ručně, použijte:
az bicep restore --file <bicep-file> [--force]
Zadaný soubor Bicep je soubor, který chcete nasadit. Musí obsahovat modul, který odkazuje na registr. Můžete například obnovit následující soubor:
module stgModule 'br:exampleregistry.azurecr.io/bicep/modules/storage:v1' = {
name: 'storageDeploy'
params: {
storagePrefix: 'examplestg1'
}
}
Místní mezipaměť se nachází v:
V systému Windows
%USERPROFILE%\.bicep\br\<registry-name>.azurecr.io\<module-path\<tag>V Linuxu
/home/<username>/.bicepNa Macu
~/.bicep
Příkaz restore neaktualizuje mezipaměť, pokud už je modul uložený v mezipaměti. Pokud chcete mezipaměť aktualizovat, můžete buď odstranit cestu modulu z mezipaměti, nebo použít --force přepínač s příkazem restore .
upgrade
Příkaz upgrade aktualizuje nainstalovanou verzi nejnovější verzí. Tento příkaz je k dispozici pouze prostřednictvím Azure CLI.
az bicep upgrade
version
Příkaz version vrátí vaši nainstalovanou verzi.
az bicep version
Příkaz zobrazí číslo verze.
Bicep CLI version 0.22.6 (d62b94db31)
Pokud chcete tento příkaz volat přímo prostřednictvím rozhraní příkazového řádku Bicep, použijte:
bicep --version
Pokud se rozhraní příkazového řádku Bicep nenainstalovalo, zobrazí se chybová zpráva s oznámením, že rozhraní příkazového řádku Bicep nebylo nalezeno.
Další kroky
Další informace o nasazení souboru Bicep najdete tady: