Poznámka
Přístup k této stránce vyžaduje autorizaci. Můžete se zkusit přihlásit nebo změnit adresáře.
Přístup k této stránce vyžaduje autorizaci. Můžete zkusit změnit adresáře.
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.
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
vyberteExtensions
.Vyberte
Bicep
ze seznamu rozšíření.Select the
FEATURE CONTRIBUTIONS
tab: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
# 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
- Download bicep-linux-x64 from the Bicep release page in a non-air-gapped environment.
- Zkopírujte spustitelný soubor do adresáře $HOME/.azure/bin na počítači s mezerou vzduchu. Přejmenujte soubor na bicep.
macOS
- Download bicep-osx-x64 from the Bicep release page in a non-air-gapped environment.
- Zkopírujte spustitelný soubor do adresáře $HOME/.azure/bin na počítači s mezerou vzduchu. Přejmenujte soubor na bicep.
Windows
- Download bicep-win-x64.exe from the Bicep release page in a non-air-gapped environment.
- 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ů.
Warning
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 přijmete, je na vlastní riziko, a společnost Microsoft si vyhrazuje právo zásadně změnit tento balíček kdykoli.
Další informace o instalaci a využívání balíčků NuGet naleznete v tématu Pracovní postup 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í 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 rychlý start: Integrace Bicep se službou Azure Pipelines. Pokud chcete nasadit soubory Bicep prostřednictvím GitHub Actions, přečtěte si rychlý start: Nasazení souborů Bicep pomocí GitHub Actions.