Installare gli strumenti di Bicep

Assicurarsi che l'ambiente sia configurato per lo sviluppo e la distribuzione di file Bicep.

Ambiente di sviluppo

Per creare file Bicep, è necessario un buon editor Bicep. È consigliabile:

  • Visual Studio Code: se non si dispone già di Visual Studio Code, installarlo.

  • Estensione Bicep per Visual Studio Code. Visual Studio Code con l'estensione Bicep fornisce il supporto del linguaggio e il completamento automatico delle risorse. L'estensione consente di creare e convalidare i file Bicep.

    Per installare l'estensione, cercare bicep nella scheda Estensioni o nel marketplace Visual Studio.

    Selezionare Installa.

    Installare l'estensione Bicep

Per verificare di aver installato l'estensione, aprire qualsiasi file con .bicep l'estensione . La modalità lingua nell'angolo inferiore destro dovrebbe essere cambiata in Bicep.

Modalità lingua del bicipite

Ambiente di distribuzione

Il modo più semplice per ottenere i comandi necessari per distribuire un file Bicep è installare la versione più recente dell'interfaccia della riga di comando di Azure. È anche possibile usare PowerShell, ma è necessaria un'installazione aggiuntiva.

Interfaccia della riga di comando di Azure

È necessario avere installato l'interfaccia della riga di comando di Azure versione 2.20.0 o successiva. Per installare o aggiornare l'interfaccia della riga di comando di Azure, vedere:

Per verificare la versione corrente, eseguire:

az --version

È ora disponibile tutto il necessario per distribuire e decompilare i file Bicep. Tutto è disponibile perché l'interfaccia della riga di comando di Azure 2.20.0 o versioni successive installa automaticamente l'interfaccia della riga di comando di Bicep quando viene eseguito un comando che ne richiede la necessità.

Per avviare manualmente l'installazione dell'interfaccia della riga di comando di Bicep, usare:

az bicep install

Per eseguire l'aggiornamento alla versione più recente, usare:

az bicep upgrade

Per altri comandi, vedere Interfaccia della riga di comando di Bicep.

Importante

L'interfaccia della riga di comando di Azure installa un'istanza autonoma dell'interfaccia della riga di comando di Bicep. Questa istanza non è in conflitto con le versioni installate manualmente. L'interfaccia della riga di comando di Azure non aggiunge l'interfaccia della riga di comando di Bicep al percorso.

PowerShell

È necessario aver installato Azure PowerShell versione 5.6.0 o successiva. Per aggiornare o installare, vedere Installare Azure PowerShell.

Azure PowerShell non installa automaticamente l'interfaccia della riga di comando di Bicep. È invece necessario installare manualmente l'interfaccia della riga di comando di Bicep.

Importante

L'istanza autonoma dell'interfaccia della riga di comando di Bicep installata dall'interfaccia della riga di comando di Azure non è disponibile per i comandi di PowerShell. Azure PowerShell le distribuzioni non riescono se l'interfaccia della riga di comando di Bicep non è stata installata manualmente.

Quando si installa manualmente l'interfaccia della riga di comando di Bicep, eseguire i comandi Bicep con la sintassi anziché con la sintassi per l'interfaccia della riga bicep az bicep di comando di Azure.

Per distribuire i file Bicep, usare l'interfaccia della riga di comando di Bicep versione 0.3.1 o successiva. Per controllare la versione dell'interfaccia della riga di comando di Bicep, eseguire:

bicep --version

Eseguire l'installazione manuale

I metodi seguenti installano l'interfaccia della riga di comando di Bicep e la aggiungono a PATH. È necessario installare manualmente per qualsiasi uso diverso dall'interfaccia della riga di comando di 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!

macOS

tramite homebrew
# Add the tap for bicep
brew tap azure/bicep

# Install the tool
brew install bicep
tramite 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

Windows Installer

Scaricare ed eseguire il programma di installazione di Windows più recente. Il programma di installazione non richiede privilegi amministrativi. Dopo l'installazione, l'interfaccia della riga di comando di Bicep viene aggiunta al percorso utente. Chiudere e riaprire tutte le finestre della shell dei comandi aperte per l'applicazione della modifica PATH.

Chocolatey
choco install bicep
Winget
winget install -e --id Microsoft.Bicep
Manuale con PowerShell
# 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!

Installare le build notturne

Se si vogliono provare i bit di versione non definitiva più recenti di Bicep prima del rilascio, vedere Installare build notturne.

Avviso

Queste build non definitiva hanno molto più probabilità di avere bug noti o sconosciuti.

Passaggi successivi

Per altre informazioni sull'uso Visual Studio Code'estensione Bicep, vedere Avvio rapido: Crearefile Bicep con Visual Studio Code .