Risolvere i problemi di installazione di Bicep

Questo articolo descrive come risolvere potenziali errori nell'installazione di Bicep.

Errore di runtime .NET

Quando si installa l'estensione Bicep per Visual Studio Code, è possibile che vengano visualizzati i messaggi di errore seguenti:

Failed to install .NET runtime v5.0

Failed to download .NET 5.0.x ....... Error!

Avviso

Si tratta di un'ultima soluzione di resort che può causare problemi durante l'aggiornamento delle versioni.

Per risolvere il problema, è possibile installare manualmente .NET dal sito Web .NET e quindi configurare Visual Studio Code per riutilizzare un'installazione esistente di .NET con le impostazioni seguenti:

Windows

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "C:\\Program Files\\dotnet\\dotnet.exe"
  }
]

macOS

Se è necessaria un'installazione x64, usare:

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "/usr/local/share/dotnet/x64/dotnet"
  }
]

Per altre installazioni macOS, usare:

"dotnetAcquisitionExtension.existingDotnetPath": [
  {
    "extensionId": "ms-azuretools.vscode-bicep",
    "path": "/usr/local/share/dotnet/dotnet"
  }
]

Per la configurazione delle impostazioni di Visual Studio Code, vedere Impostazioni utente e area di lavoro.

Errore di Visual Studio Code

Se viene visualizzato il popup del messaggio di errore seguente in Visual Studio Code:

The Bicep server crashed 5 times in the last 3 minutes. The server will not be restarted.

Da VS Code aprire la visualizzazione Output nel riquadro nella parte inferiore della schermata e quindi selezionare Bicep:

Se nel riquadro viene visualizzato l'output seguente e si usa l'interfaccia della riga di comando di Bicep versione 0.4.1124 o successiva, verificare se è stata aggiunta l'opzione dotnetAcquisitionExtension.existingDotnetPath di configurazione a VS Code. Vedere Errore di runtime .NET. Se questa opzione di configurazione è presente, rimuoverla e riavviare VS Code.

It was not possible to find any compatible framework version.

In caso contrario, generare un problema nel repository Bicep e includere i messaggi di output.

Più versioni dell'interfaccia della riga di comando di Bicep installate

Se si installa manualmente l'interfaccia della riga di comando di Bicep in più posizioni, è possibile notare un comportamento imprevisto, ad esempio l'interfaccia della riga di comando di Bicep non viene aggiornata quando si esegue il comando di aggiornamento. In alternativa, è possibile notare che l'esecuzione di az bicep version restituisce una versione, ma bicep --version restituisce una versione diversa.

Per risolvere questo problema, è possibile aggiornare tutte le posizioni oppure selezionare un percorso per gestire ed eliminare le altre posizioni.

Aprire prima di tutto il prompt dei comandi (non PowerShell) ed eseguire where bicep. Questo comando restituisce i percorsi delle installazioni di Bicep. Se si usa l'istanza dell'interfaccia della riga di comando di Bicep gestita dall'interfaccia della riga di comando di Azure, questa installazione non verrà visualizzata perché non viene aggiunta al percorso. Se where bicep restituisce un solo percorso, è possibile che le versioni in conflitto visualizzate siano tra l'installazione manuale e l'installazione dell'interfaccia della riga di comando di Azure.

Per mantenere tutti i percorsi di installazione, usare lo stesso metodo usato in precedenza per installare manualmente l'interfaccia della riga di comando di Bicep per tutti i percorsi da gestire. Se si usa l'interfaccia della riga di comando di Azure, eseguire az bicep upgrade per aggiornare tale versione.

Per mantenere un solo percorso di installazione, seguire questa procedura:

1. Eliminare i file per le installazioni che non si desidera mantenere.
2. Rimuovere tali posizioni dalla variabile di ambiente PATH.

Se si dispone di un'installazione manuale e dell'istanza gestita dall'interfaccia della riga di comando di Azure, è possibile combinare l'utilizzo a un'istanza.

1. Eliminare il percorso di installazione manuale.
2. Aggiungere il percorso dell'interfaccia della riga di comando di Bicep installata dall'interfaccia della riga di comando di Azure alla variabile PATH. Per Windows, il percorso gestito dall'interfaccia della riga di comando di Azure è %USERPROFILE%\.Azure\bin.

Dopo aver aggiunto l'istanza dell'interfaccia della riga di comando di Azure al percorso, è possibile usare tale versione con az bicep o bicep.

Passaggi successivi

Per altre informazioni sull'uso di Visual Studio Code e dell'estensione Bicep, vedere Avvio rapido: Creare file Bicep con Visual Studio Code.