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
Autor Rozšíření VS Code a Bicep automatická
Visual Studio a rozšíření Bicep automatická
Nasadit Azure CLI automatická
Azure PowerShell Ruční
Rozšíření VS Code a Bicep Ruční
Mrak se vzduchem stáhnout

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 visual studio code ještě nemáte, nainstalujte si ho.

  • Rozšíření Bicep pro Visual Studio Code. Visual Studio Code s rozšířením Bicep poskytuje jazykovou podporu 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 webu Visual Studio Marketplace.

    Vyberte Nainstalovat.

    Snímek obrazovky s instalací rozšíření Bicep

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

Snímek obrazovky s režimem jazyka Bicep

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

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

Konfigurace rozšíření Bicep

Zobrazení nastavení:

  1. View V nabídce vyberte Extensions.

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

  3. Vyberte kartu FEATURE CONTRIBUTIONS :

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

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

    ID Výchozí hodnota Description
    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 Zpět). Další informace najdete v tématu Vložení jako bicep.
    bicep.enableOutputTimestamps true Před každý řádek zobrazený ve výstupním kanálu Bicep Operations pomocí časového razítka.
    bicep.suppressedWarnings Upozornění, která jsou potlačována, protože bylo stisknuto tlačítko Nezobrazovat znovu. Odeberte položky, které chcete resetovat.
    bicep.enableSurveys true Povolte občasné průzkumy, abyste mohli shromažďovat zpětnou vazbu, která nám pomáhá vylepšovat rozšíření Bicep.
    bicep.completions.getAllAccessibleAzureContainerRegistries false (nepravda) Při dokončování odkazů na moduly "br:" se dotazujte Azure na všechny registry kontejnerů přístupné uživateli (může být pomalé). Pokud je tato možnost vypnutá, zobrazí se pouze registry nakonfigurované v moduluAliases v souboru bicepconfig.json .
    bicep.trace.server možností Nakonfigurujte trasování zpráv odesílaných na jazykový server Bicep.

Konfigurace nastavení:

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

  2. Rozbalte Extensionsa pak vyberte Bicep:

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

Visual Studio a rozšíření Bicep

K vytvoření souboru Bicep ze sady Visual Studio potřebujete:

  • Visual Studio – Pokud ještě visual studio nemáte, nainstalujte si ho.
  • Rozšíření Bicep pro Visual Studio. Visual Studio s rozšířením Bicep poskytuje jazykovou podporu a automatické dokončování prostředků. 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: Vytváření souborů Bicep pomocí sady Visual Studio.

Azure CLI

Když používáte Azure CLI s bicepem, máte vše, 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 nainstalovanou verzi Azure CLI 2.20.0 nebo novější . Informace o instalaci nebo aktualizaci Azure CLI najdete tady:

Pokud chcete ověřit aktuální verzi, spusťte následující příkaz:

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 verzemi, které jste mohli nainstalovat ručně. Azure CLI nepřidá rozhraní příkazového řádku Bicep do cesty.

S nastavením prostředí Bicep jste skončili. Zbývající část tohoto článku popisuje kroky instalace, které při použití Azure CLI nepotřebujete.

Azure PowerShell

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

Azure PowerShell automaticky nenainstaluje rozhraní příkazového řádku Bicep. 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í k dispozici pro příkazy PowerShellu. Azure PowerShell nasazení selžou, pokud jste ručně nenainstalovali rozhraní příkazového řádku Bicep.

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

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

bicep --version

Ruční instalace

Následující metody nainstalují rozhraní příkazového řádku Bicep a přidají ho do cesty. Pokud chcete použít jiné použití než Azure CLI, musíte ji nainstalovat ručně.

Při ruční instalaci vyberte umístění, které se liší od umístění spravovaného pomocí 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 pomocí Azure CLI, 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 distribucí Linuxu, jako je Alpine, použijte v předchozím skriptu bicep-linux-musl-x64 místo bicep-linux-x64 .

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 nebo novější nevyžaduje výjimku Gatekeeper. Noční buildy 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.

Chocolatey

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 se vzduchem

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

  • Linux

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

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

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

Pokud používáte úlohu Azure CLI v cloudu se vzduchem, musíte vlastnost úlohy nastavit useGlobalConfig na true. Výchozí hodnota je false. Příklad najdete v tématu CI/CD se soubory Azure Pipelines a Bicep .

Instalace nočních buildů

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

Upozornění

U těchto předběžných buildů je mnohem pravděpodobnější, že budou obsahovat 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ávislosti, které na tomto balíčku přijmete, budou prováděny na vaše vlastní nebezpečí a vyhrazujeme si právo kdykoli odeslat změny způsobující chybu v tomto balíčku.

Další informace o instalaci a používání balíčků NuGet najdete v tématu Využití 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í bicepu, přečtěte si téma Řešení potíží s instalací bicepu.

Pokud chcete nasadit soubory Bicep ze služby Azure Pipeline, přečtěte si téma Integrace bicepu 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.