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 použít některou z následujících možností:

Úlohy Možnosti Instalace rozhraní příkazového řádku Bicep
Vytvořit Rozšíření VS Code a Bicep automatická
Rozšíření Sady Visual Studio a Bicep automatická
Nasadit Azure CLI automatická
Azure PowerShell Ruční
Rozšíření VS Code a Bicep Ruční
Vzduchově zvětšovaný cloud download

Upozorňující

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 a rozšíření 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ů. 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.

    Screenshot of installing Bicep extension.

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.

Screenshot of Bicep language mode.

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 VS Code. Další informace najdete v tématu Nasazení souborů Bicep ze sady Visual Studio Code.

Konfigurace rozšíření Bicep

Zobrazení nastavení:

  1. View V nabídce vyberte Extensions.

  2. Vyberte Bicep ze seznamu rozšíření.

  3. FEATURE CONTRIBUTIONS Vyberte kartu:

    Screenshot of Bicep extension settings.

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

    ID Výchozí hodnota Popis
    bicep.decompileOnPaste true Automaticky převést vložené hodnoty JSON, šablony JSON ARM nebo prostředky ze šablony JSON ARM na Bicep (k vrácení použijte funkci Zpět). Další informace naleznete v tématu Vložit jako Bicep.
    bicep.enableOutputTimestamps true Předem se zobrazí každý řádek zobrazený ve výstupním kanálu Operace Bicep s časovým razítkem.
    bicep.suppressedWarnings Upozornění potlačovaná, protože se stisklo tlačítko Nezobrazovat znovu. Odeberte položky, které chcete obnovit.
    bicep.enableSurveys true Povolte občasné průzkumy a shromážděte zpětnou vazbu, která nám pomůže vylepšit rozšíření Bicep.
    bicep.completions.getAllAccessibleAzureContainerRegistries false (nepravda) Při dokončování odkazů na modul br:se dotazujte 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 části moduleAliases v bicepconfig.json .
    bicep.trace.server vypnuto Nakonfigurujte trasování zpráv odesílaných na server jazyka Bicep.

Konfigurace nastavení:

  1. File V nabídce vyberte Preferencesa pak vyberte Settings.

  2. Rozbalte Extensionspoložku a pak vyberte Bicep:

    Screenshot of configuring Bicep extension settings.

Rozšíření Sady Visual Studio a Bicep

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 s rozšířením Bicep poskytuje podporu jazyka a automatické dokončování prostředků. Toto rozšíření vám pomůže vytvářet a ověřovat soubory Bicep. Nainstalujte rozšíření ze sady Visual Studio Marketplace.

Pokud si chcete projít kurz, podívejte se na 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ší . 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

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 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 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í rozhraní příkazového řádku Bicep a přidají ho do cesty. Musíte ručně nainstalovat jakékoli jiné použití 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

# 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 vyšší nepotřebuje výjimku Gatekeeper. Noční sestavení rozhraní příkazového řádku Bicep ale stále vyžadují výjimku.

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. 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í 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!

Instalace na cloud s mezerami vzduchu

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

  • 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 mezerou 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 mezerou vzduchu. Přejmenujte soubor na bicep.
  • Windows

    1. Stáhněte si bicep-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 mezerou vzduchu. Přejmenujte soubor na bicep.exe.

Pokud používáte úlohu Azure CLI v cloudu, která je mimo provoz, musíte nastavit useGlobalConfig vlastnost úkolu na truehodnotu . Výchozí hodnota je false. Příklad najdete v CI /CD se soubory Azure Pipelines a Bicep.

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ů.

Upozorňující

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

Instalace balíčku NuGet

Tým Bicep veřejně zpřístupnil balíček NuGet Azure.Bicep.Core na nuget.org. I když je veřejný, nejedná se o podporovaný balíček. Jakákoli závislost, kterou na tomto balíčku vezmete, bude provedena na vlastní nebezpečí a vyhrazujeme si právo nasdílení zásadních změn do tohoto balíčku kdykoli.

Další informace o instalaci a využívání balíčků NuGet naleznete v tématu Využívání balíčků.

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 se službou 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.