Partilhar via


Resolver problemas de instalação do Bicep

Este artigo descreve como resolver possíveis erros na instalação do Bicep.

Erro de código do Visual Studio

Se você vir a seguinte mensagem de erro pop-up no Visual Studio Code:

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

No VS Code, abra o modo de exibição Saída no painel na parte inferior da tela e selecione Bicep:

Painel de saída de código do Visual Studio

Se vir a seguinte saída no painel, verifique se adicionou a dotnetAcquisitionExtension.existingDotnetPath definição ao VS Code. Se essa configuração estiver presente, remova-a e reinicie o VS Code. Consulte Configurações de usuário e espaço de trabalho para definir as configurações de código do Visual Studio.

It was not possible to find any compatible framework version.

Caso contrário, levante um problema no repositório Bicep e inclua as mensagens de saída.

Várias versões da CLI do Bicep instaladas

Se você instalar manualmente a CLI do Bicep em mais de um local, poderá notar um comportamento inesperado, como a CLI do Bicep não sendo atualizada ao executar o comando upgrade. Ou, você pode notar que a execução az bicep version retorna uma versão, mas bicep --version retorna uma versão diferente.

Para resolver esse problema, você pode atualizar todos os locais ou selecionar um local para manter e excluir os outros locais.

Primeiro, abra o prompt de comando (não o PowerShell) e execute where bicepo . Este comando retorna os locais das instalações do Bicep. Se você estiver usando a instância da CLI do Bicep gerenciada pela CLI do Azure, não verá essa instalação porque ela não foi adicionada ao PATH. Se where bicep retornar apenas um local, pode ser que as versões conflitantes que você está vendo estejam entre a instalação manual e a instalação da CLI do Azure.

Para manter todos os locais de instalação, use o mesmo método usado anteriormente para instalar manualmente a CLI do Bicep para todos os locais que deseja manter. Se você estiver usando a CLI do Azure, execute az bicep upgrade para atualizar essa versão.

Para manter apenas um local de instalação, use as seguintes etapas:

  1. Exclua os arquivos das instalações que você não deseja manter.
  2. Remova esses locais da variável de ambiente PATH .

Se você tiver uma instalação manual e a instância gerenciada pela CLI do Azure, poderá combinar seu uso a uma instância.

  1. Exclua o local de instalação manual.
  2. Adicione o local da CLI do Bicep instalada pela CLI do Azure à variável PATH . Para Windows, o local mantido pela CLI do Azure é %USERPROFILE%\.Azure\bin.

Depois de adicionar a instância da CLI do Azure ao PATH, você pode usar essa versão com um ou az bicep bicep.

Próximos passos

Para obter mais informações sobre como usar o Visual Studio Code e a extensão Bicep, consulte Guia de início rápido: criar arquivos Bicep com o Visual Studio Code.