Guida introduttiva: Installare gli strumenti Bicep
Prima di poter distribuire i tipi Bicep di Microsoft Graph, è necessario configurare l'ambiente di creazione e distribuzione. Questo articolo illustra come installare gli strumenti seguenti, usati nelle guide introduttive e nelle esercitazioni in questa documentazione:
- Per la creazione: Visual Studio Code (VS Code) e l'estensione Bicep
- Assicurarsi di disporre di Bicep versione v0.29.45 o successiva
- Per la distribuzione: Interfaccia della riga di comando di Azure
In alternativa, è possibile usare l'estensione Visual Studio e Bicep per la creazione e Azure PowerShell per la distribuzione. Per altre informazioni, vedere Installare gli strumenti Bicep.
Importante
Microsoft Graph Bicep è attualmente in anteprima. Vedere le condizioni per l'utilizzo supplementari per le anteprime di Microsoft Azure per termini legali aggiuntivi che si applicano a funzionalità di Azure in versione beta, in anteprima o in altro modo non ancora disponibili a livello generale.
Estensione VS Code e Bicep
Per creare file Bicep, è necessario un editor Bicep valido. Consigliamo:
Visual Studio Code - se Visual Studio Code non è già disponibile, 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 in Visual Studio Marketplace.
Selezionare Installa.
Per verificare di aver installato l'estensione, aprire qualsiasi file con l'estensione del file .bicep
. L'angolo in basso a destra verrà visualizzata la modalità di linguaggio in Bicep.
Se viene visualizzato un errore durante l'installazione, vedere Risolvere i problemi di installazione di Bicep.
Interfaccia della riga di comando di Azure
Quando si usa l'interfaccia della riga di comando di Azure con Bicep, è necessario distribuire e decompilare file Bicep. L'interfaccia della riga di comando di Azure installa automaticamente l'interfaccia della riga di comando di Bicep quando viene eseguito un comando che lo richiede.
È necessario che sia installata 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:
- Installare l'interfaccia della riga di comando di Azure in Windows
- Installare l'interfaccia della riga di comando di Azure in Linux
- Installare l'interfaccia della riga di comando di Azure in macOS
Per verificare la versione corrente, eseguire:
az --version
Per convalidare l'installazione dell'interfaccia della riga di comando di Bicep, usare:
az bicep version
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.
È stato configurato l'ambiente Bicep. È ora possibile procedere con la creazione di un file Bicep che dichiara le risorse di Microsoft Graph e distribuirlo in modalità interattiva.