Instalace nástrojů Bicep

Pojďme se ujistit, že je vaše prostředí nastavené pro práci se soubory Bicep. Pokud chcete vytvářet a nasazovat soubory Bicep, doporučujeme některou z následujících možností:

Úkoly Možnosti Instalace rozhraní příkazového řádku Bicep
Autor Rozšíření VS Code a Bicep automatická
Nasadit Azure CLI automatická
Azure PowerShell Ruční
Rozšíření VS Code a Bicep automatická
Vzduchově zasekaný cloud stáhnout

Rozšíření VS Code a Bicep

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.

  • Rozšíření Bicep pro Visual Studio Code Visual Studio Code s rozšířením Bicep poskytuje podporu jazyka a automatické dokončování prostředků. 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 marketplace sady Visual Studio.

    Vyberte Nainstalovat.

    Instalace rozšíření Bicep

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

Režim jazyka Bicep

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

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

Azure CLI

Když používáte Azure CLI s Bicep, máte všechno, co potřebujete k nasazení a dekompilování souborů Bicep. Azure CLI automaticky nainstaluje rozhraní příkazového řádku Bicep, když se spustí příkaz, který ho potřebuje.

Musíte mít nainstalované Azure CLI verze 2.20.0 nebo novější . Pokud chcete nainstalovat nebo aktualizovat Azure CLI, přečtěte si téma:

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

az --version

Pokud chcete ověřit instalaci 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 tématu Rozhraní příkazového řádku Bicep.

Důležité

Azure CLI nainstaluje samostatnou instanci rozhraní příkazového řádku Bicep. Tato instance není v konfliktu s žádnými verzemi, které jste možná nainstalovali ručně. Azure CLI nepřidá rozhraní příkazového řádku Bicep do vaší cesty.

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 nainstalovanou verzi Azure PowerShell 5.6.0 nebo novější. Pokud chcete aktualizovat nebo nainstalovat, přečtěte si téma Instalace Azure PowerShell.

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é

Pro příkazy PowerShellu není k dispozici samostatná instance rozhraní příkazového řádku Bicep nainstalovaného rozhraním příkazového řádku Azure CLI. Azure PowerShell nasazení 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 s 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í rozhraní příkazového řádku Bicep a přidají ho do cesty. Musíte ručně nainstalovat jiné použití než Azure CLI.

Při ruční instalaci vyberte umístění, které se liší od umístění spravovaného Rozhraním příkazového řádku Azure. 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

# 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

V případě 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

Via 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!

Windows

Instalační služba systému Windows

Stáhněte a spusťte nejnovější instalační program systému Windows. Instalační program nevyžaduje oprávnění správce. Po instalaci se rozhraní příkazového řádku Bicep přidá do cesty uživatele. 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í použití 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!

Instalace na cloud s mezerami vzduchu

bicep upgrade Příkazy bicep install nefungují v prostředí s mezerami vzduchu. Pokud chcete nainstalovat Rozhraní příkazového řádku Bicep v prostředí s mezerami vzduchu, musíte spustitelný soubor rozhraní příkazového řádku Bicep stáhnout ručně a uložit ho do souboru .azure/bin. Toto umístění je místo, kde je nainstalovaná instance spravovaná rozhraním příkazového řádku Azure.

  • Linux

    1. Stáhněte si bicep-linux-x64 ze stránky verze Bicep v prostředí bez vzduchu.
    2. Zkopírujte spustitelný soubor do adresáře $HOME/.azure/bin na počítači s mezerami vzduchu. Přejmenujte soubor na bicep.
  • macOS

    1. Stáhněte si bicep-osx-x64 ze stránky verze Bicep v prostředí bez vzduchu.
    2. Zkopírujte spustitelný soubor do adresáře $HOME/.azure/bin na počítači s mezerami vzduchu. Přejmenujte soubor na bicep.
  • Windows

    1. Stáhněte sibicep-win-x64.exe ze stránky verze Bicep v prostředí bez vzduchu.
    2. Zkopírujte spustitelný soubor do adresáře %UserProfile%/.azure/bin na počítači s mezerami vzduchu. Přejmenujte soubor na bicep.exe.

Instalace nočních buildů

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

Upozornění

Tyto předběžné buildy jsou mnohem pravděpodobnější, že budou mít známé nebo neznámé chyby.

Další kroky

Další informace o používání editoru Visual Studio Code a rozšíření Bicep najdete v tématu Rychlý start: Vytváření souborů Bicep pomocí editoru Visual Studio Code.

Pokud máte problémy s instalací Bicep, přečtěte si téma Řešení potíží s instalací Bicep.

Pokud chcete nasadit soubory Bicep ze služby Azure Pipeline, přečtěte si téma Integrace Bicep s Azure Pipelines. Pokud chcete nasadit soubory Bicep prostřednictvím GitHub Actions, přečtěte si téma Nasazení souborů Bicep pomocí GitHub Actions.