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.
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.
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í:
View
V nabídce vyberteExtensions
.Vyberte
Bicep
ze seznamu rozšíření.Vyberte kartu
FEATURE CONTRIBUTIONS
: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í:
File
V nabídce vybertePreferences
a pak vyberteSettings
.Rozbalte
Extensions
a pak vyberteBicep
:
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
- Stáhněte si bicep-linux-x64 ze stránky verze Bicep v prostředí bez vzduchové mezery.
- Zkopírujte spustitelný soubor do adresáře $HOME/.azure/bin na počítači se vzduchem. Přejmenujte soubor na bicep.
macOS
- Stáhněte si bicep-osx-x64 ze stránky verze Bicep v prostředí bez mezery vzduchu.
- Zkopírujte spustitelný soubor do adresáře $HOME/.azure/bin na počítači se vzduchem. Přejmenujte soubor na bicep.
Windows
- Stáhněte sibicep-win-x64.exe ze stránky verze Bicep v prostředí bez mezer vzduchu.
- 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.