Compartilhar via


Início Rápido: Instalar ferramentas do Bicep

Antes de implantar tipos Bicep do Microsoft Graph, você deve configurar seu ambiente de criação e implantação. Este artigo mostra como instalar as seguintes ferramentas, que são usadas em guias de início rápido e tutoriais nesta documentação:

  • Para criação: Visual Studio Code (VS Code) e extensão Bicep
    • Verifique se você tem o Bicep versão v0.29.45 ou superior
  • Para implantação: CLI do Azure

Como alternativa, você pode usar a extensão do Visual Studio e do Bicep para criação e o Azure PowerShell para implantação. Para obter mais informações, confira Instalar as ferramentas do Bicep.

Importante

O Microsoft Graph Bicep está atualmente em versão prévia. Veja os Termos de Uso Complementares para Versões Prévias do Microsoft Azure para obter termos legais que se aplicam aos recursos do Azure que estão em versão beta, versão prévia ou que, de outra forma, ainda não foram lançados em disponibilidade geral.

VS Code e a extensão Bicep

Para criar arquivos Bicep, você precisará de um bom editor de Bicep. Recomendações:

  • Visual Studio Code - Se você ainda não tiver o Visual Studio Code, instale-o.

  • Extensão do Bicep para o Visual Studio Code. O Visual Studio Code com a extensão do Bicep fornece suporte a idiomas e preenchimento automático de recursos. A extensão ajuda a criar e validar arquivos Bicep.

    Para instalar a extensão, pesquise bicep na guia Extensões ou no Marketplace do Visual Studio.

    Selecione Instalar.

    Captura de tela da instalação da extensão Bicep.

Para verificar se você instalou a extensão, abra qualquer arquivo com a extensão de arquivo .bicep. Você deve ver o modo de idioma no canto inferior direito mudar para Bicep.

Captura de tela do modo de linguagem Bicep.

Se você receber um erro durante a instalação, consulte Troubleshoot Bicep installation.

CLI do Azure

Ao usar a CLI do Azure com o Bicep, você tem tudo o que precisa para implantar e descompilar arquivos Bicep. A CLI do Azure instalará automaticamente a CLI do Bicep quando um comando for executado que precise dele.

Você deve ter a CLI do Azure versão 2.20.0 ou mais recente instalada. Para instalar ou atualizar a CLI do Azure, consulte:

Para verificar sua versão atual, execute:

az --version

Para validar a instalação da CLI do Bicep, use:

az bicep version

Para atualizar para a versão mais recente, use:

az bicep upgrade

Para obter mais comandos, consulte CLI do Bicep.

Importante

A CLI do Azure instala uma instância autossuficiente da CLI do Bicep. Essa instância não está em conflito com nenhuma versão que você possa ter instalado manualmente. A CLI do Azure não adiciona a CLI do Bicep ao seu PATH.

Você configurou seu ambiente Bicep. Agora você pode continuar a criar um arquivo Bicep que declara recursos do Microsoft Graph e implantar esse arquivo no modo interativo.

Próxima etapa