Install Bicep tools

2025-04-12

Připravte prostředí na práci se soubory Bicep. Pokud chcete vytvářet a nasazovat soubory Bicep, doporučujeme použít některou z následujících možností:

Úlohy	Možnosti	Instalace rozhraní příkazového řádku Bicep
Autor	Visual Studio Code and Bicep extension	automatická
	Visual Studio and Bicep extension	automatická
Deploy	Azure CLI	automatická
	Azure PowerShell	manuál
	Visual Studio Code and Bicep extension	manuál
	Air-gapped cloud	download

Warning

Stabilita rozhraní příkazového řádku Bicep v emulovaných prostředích není zaručená, protože emulační nástroje, jako je Rosetta2 a QEMU, obvykle nenapodobují architekturu dokonale.

Visual Studio Code and Bicep extension

K vytváření souborů Bicep potřebujete dobrý editor Bicep. Naše doporučení:

Visual Studio Code – Pokud ještě nemáte Visual Studio Code , nainstalujte ho.
Bicep extension for Visual Studio Code. Visual Studio Code with the Bicep extension provides language support and resource autocompletion. Toto rozšíření vám pomůže vytvářet a ověřovat soubory Bicep.

Pokud chcete rozšíření nainstalovat, vyhledejte bicep na kartě Rozšíření nebo na webu Visual Studio Marketplace.

Vyberte volbu Instalovat.

Pokud chcete ověřit, že jste příponu nainstalovali, otevřete libovolný soubor s příponou .bicep souboru. V pravém dolním rohu by se měl zobrazit režim jazyka, který se změní na Bicep.

Snímek obrazovky s režimem jazyka Bicep

Pokud během instalace dojde k chybě, přečtěte si téma Řešení potíží s instalací Bicep.

Soubory Bicep můžete nasadit přímo z editoru Visual Studio Code. Další informace najdete v tématu Nasazení souborů Bicep pomocí editoru Visual Studio Code.

Configure Bicep extension

Zobrazení nastavení:

V nabídce View vyberte Extensions.
Vyberte Bicep ze seznamu rozšíření.

Select the FEATURE CONTRIBUTIONS tab:

Snímek obrazovky s nastavením rozšíření Bicep

Rozšíření Bicep má tato nastavení a výchozí hodnoty:

ID	Výchozí hodnota	Popis
bicep.decompileOnPaste	true	Automatically convert pasted JSON values, Azure Resource Manager JSON templates (ARM templates,) or resources from an ARM template into Bicep (use Undo to revert). Další informace najdete v příkazu Vložit JSON jako Bicep.
bicep.enableOutputTimestamps	true	Prepend each line displayed in the Bicep Operations output channel with a timestamp.
bicep.suppressedWarnings		Upozornění, která jsou potlačována, protože bylo stisknuto tlačítko Nezobrazovat znovu. Remove items to reset.
bicep.enableSurveys	true	Enable occasional surveys to collect feedback that helps us improve the Bicep extension.
bicep.completions.getAllAccessibleAzureContainerRegistries	nepravda	Při dokončování odkazů na modul br:, zadejte dotaz na Azure pro všechny registry kontejnerů, které jsou přístupné pro uživatele (může být pomalé). Pokud je tato možnost vypnutá, zobrazí se seznam pouze registrů nakonfigurovaných v moduleAliases v bicepconfig.json souborech.
bicep.trace.server	off	Nakonfigurujte trasování zpráv odesílaných na server jazyka Bicep.

Konfigurace nastavení:

V nabídce Soubor vyberte Předvolby a potom Nastavení.
Expand Extensions to select Bicep:

Visual Studio and Bicep extension

Pokud chcete vytvořit soubor Bicep ze sady Visual Studio, potřebujete:

Visual Studio – Pokud ještě sadu Visual Studio nemáte, nainstalujte ji.
Rozšíření Bicep pro Visual Studio Visual Studio with the Bicep extension provides language support and resource autocompletion. Toto rozšíření vám pomůže vytvářet a ověřovat soubory Bicep. Nainstalujte rozšíření z Visual Studio Marketplace.

Pokud si chcete projít příručku, podívejte se na Příručka pro rychlý start: Vytvoření souborů Bicep pomocí sady Visual Studio.

Azure CLI

Když používáte Azure CLI s Bicepem, máte všechno, co potřebujete k nasazení a dekompilování souborů Bicep. Azure CLI automaticky nainstaluje rozhraní příkazového řádku Bicep při spuštění příkazu, který ho potřebuje.

Musíte mít nainstalované Azure CLI verze 2.20.0 nebo novější . Informace o instalaci nebo aktualizaci Azure CLI v různých operačních systémech najdete tady:

Pokud chcete ověřit aktuální verzi, spusťte:

az --version

K ověření instalace rozhraní příkazového řádku Bicep použijte:

az bicep version

Pokud chcete upgradovat na nejnovější verzi, použijte:

az bicep upgrade

Další příkazy najdete v Bicep CLI.

Důležité

The Azure CLI installs a self-contained instance of the Bicep CLI. Tato instance není v konfliktu s žádnými verzemi, které jste možná nainstalovali ručně. The Azure CLI doesn't add Bicep CLI to your PATH.

Dokončili jste nastavení prostředí Bicep. Zbytek tohoto článku popisuje kroky instalace, které nepotřebujete při používání Azure CLI.

Azure PowerShell

Musíte mít nainstalovaný Azure PowerShell verze 5.6.0 nebo novější . Informace o aktualizaci nebo instalaci najdete v tématu Instalace Azure PowerShellu.

Azure PowerShell neinstaluje rozhraní příkazového řádku Bicep automaticky. Místo toho musíte rozhraní příkazového řádku Bicep nainstalovat ručně.

Důležité

Samostatná instance rozhraní příkazového řádku Bicep, nainstalovaná pomocí Azure CLI, není dostupná pro příkazy PowerShellu. Nasazení Azure PowerShellu selžou, pokud jste rozhraní příkazového řádku Bicep nenainstalovali ručně.

Když ručně nainstalujete rozhraní příkazového řádku Bicep, spusťte příkazy Bicep se bicep syntaxí místo az bicep syntaxe pro Azure CLI.

Pokud chcete zkontrolovat verzi rozhraní příkazového řádku Bicep, spusťte:

bicep --version

Ruční instalace

Následující metody nainstalují Bicep CLI a přidají ho do vašeho PATH. Musíte ručně nainstalovat pro jakékoli použití jiné než Azure CLI.

Při ruční instalaci vyberte umístění, které se liší od umístění, které spravuje Azure CLI. Všechny následující příklady používají umístění s názvem bicep nebo .bicep. Toto umístění nebude v konfliktu s umístěním spravovaným Rozhraním příkazového řádku Azure, které používá .azure.

Linux
macOS
Windows

Linux

# Fetch the latest Bicep CLI binary
curl -Lo bicep https://github.com/Azure/bicep/releases/latest/download/bicep-linux-x64
# Mark it as executable
chmod +x ./bicep
# Add bicep to your PATH (requires admin)
sudo mv ./bicep /usr/local/bin/bicep
# Verify you can now access the 'bicep' command
bicep --help
# Done!

Poznámka:

U jednoduchých linuxových distribucí, jako je Alpine, použijte bicep-linux-musl-x64 místo bicep-linux-x64 v předchozím skriptu.

macOS

Přes homebrew

# Add the tap for bicep
brew tap azure/bicep

# Install the tool
brew install bicep

Přes BASH

# Fetch the latest Bicep CLI binary
curl -Lo bicep https://github.com/Azure/bicep/releases/latest/download/bicep-osx-x64
# Mark it as executable
chmod +x ./bicep
# Add Gatekeeper exception (requires admin)
sudo spctl --add ./bicep
# Add bicep to your PATH (requires admin)
sudo mv ./bicep /usr/local/bin/bicep
# Verify you can now access the 'bicep' command
bicep --help
# Done!

Poznámka:

Instalace rozhraní příkazového řádku Bicep verze 0.16.X nebo novější nepotřebuje výjimku Gatekeeper. However, nightly builds of the Bicep CLI still require the exception.

Windows

Instalační služba systému Windows

Stáhněte a spusťte nejnovější instalační službu systému Windows. Instalační program nevyžaduje oprávnění správce. After the installation, the Bicep CLI is added to your user PATH. Zavřete a znovu otevřete všechna otevřená okna příkazového prostředí, aby se změna PATH projevila.

Čokoláda

choco install bicep

Winget

winget install -e --id Microsoft.Bicep

Ruční s využitím PowerShellu

# Create the install folder
$installPath = "$env:USERPROFILE\.bicep"
$installDir = New-Item -ItemType Directory -Path $installPath -Force
$installDir.Attributes += 'Hidden'
# Fetch the latest Bicep CLI binary
(New-Object Net.WebClient).DownloadFile("https://github.com/Azure/bicep/releases/latest/download/bicep-win-x64.exe", "$installPath\bicep.exe")
# Add bicep to your PATH
$currentPath = (Get-Item -path "HKCU:\Environment" ).GetValue('Path', '', 'DoNotExpandEnvironmentNames')
if (-not $currentPath.Contains("%USERPROFILE%\.bicep")) { setx PATH ($currentPath + ";%USERPROFILE%\.bicep") }
if (-not $env:path.Contains($installPath)) { $env:path += ";$installPath" }
# Verify you can now access the 'bicep' command.
bicep --help
# Done!

Install on air-gapped cloud

bicep install a bicep upgrade příkazy nefungují v izolovaném prostředí. Pokud chcete nainstalovat rozhraní příkazového řádku Bicep v izolovaném prostředí, musíte spustitelný soubor rozhraní příkazového řádku Bicep stáhnout ručně a uložit ho do adresáře .azure/bin. V tomto umístění se instaluje instance spravovaná pomocí Azure CLI.

Linux
1. Download bicep-linux-x64 from the Bicep release page in a non-air-gapped environment.
2. Zkopírujte spustitelný soubor do adresáře $HOME/.azure/bin na počítači s mezerou vzduchu. Přejmenujte soubor na bicep.
macOS
1. Download bicep-osx-x64 from the Bicep release page in a non-air-gapped environment.
2. Zkopírujte spustitelný soubor do adresáře $HOME/.azure/bin na počítači s mezerou vzduchu. Přejmenujte soubor na bicep.
Windows
1. Download bicep-win-x64.exe from the Bicep release page in a non-air-gapped environment.
2. Zkopírujte spustitelný soubor do adresáře %UserProfile%/.azure/bin na počítači s mezerou vzduchu. Přejmenujte soubor na bicep.exe.

Pokud používáte úkol Azure CLI v izolovaném cloudu, musíte nastavit vlastnost úkolu na . Výchozí hodnota je false. See CI/CD with Azure Pipelines and Bicep files for an example.

Instalace nočních buildů

Pokud chcete vyzkoušet nejnovější předběžné verze bitů Bicep před jejich vydáním, přečtěte si téma Instalace nočních buildů.