Como funciona o Bicep

  • 3 minutos

Você desenvolveu uma compreensão da linguagem de modelo Bicep e os benefícios que ela fornece para a criação de modelos. Antes de começar o processo de escrever modelos de Bicep para provisionar seus recursos, você quer saber mais sobre como o Bicep funciona.

Nesta unidade, você aprenderá sobre como o Bicep funciona com o Azure Resource Manager.

Implantação do bíceps

Na unidade anterior, você aprendeu que o Bicep foi projetado para um cenário ou domínio específico, o que o torna uma linguagem específica do domínio. O Bicep foi criado para facilitar a implantação e a configuração de recursos do Azure.

Ao implantar um recurso ou uma série de recursos no Azure, você envia o modelo Bicep para o Gerenciador de Recursos, que ainda requer modelos JSON. As ferramentas incorporadas no Bicep convertem seu modelo Bicep em um modelo JSON. Este processo é conhecido como transpilação, que essencialmente trata o modelo ARM como uma linguagem intermediária. A conversão acontece automaticamente quando você envia sua implantação, ou você pode fazê-lo manualmente.

Diagrama que mostra o fluxo de trabalho de um autor de modelo, um modelo Bicep, um modelo JSON emitido e uma implantação no Azure.

Nota

Transpilação é o processo de conversão de código-fonte escrito em um idioma em outro idioma.

As versões mais recentes da CLI do Azure e do Azure PowerShell têm suporte interno ao Bicep. Você pode usar os mesmos comandos de implantação para implantar modelos Bicep e JSON. Por exemplo, o comando a seguir implanta um modelo Bicep em um grupo de recursos chamado storage-resource-group:

az deployment group create \
  --template-file main.bicep \
  --resource-group storage-resource-group

Depois que essa implantação é enviada, o Gerenciador de Recursos examina os recursos atualmente implantados no Azure. Em seguida, ele examina o que você está tentando implantar e define uma sequência de etapas para alcançar esse estado. Todas essas atividades envolvem invocar a API do Resource Manager.

Você pode exibir o modelo JSON enviado ao Gerenciador de Recursos usando o bicep build comando. No próximo exemplo, um modelo Bicep é convertido em seu modelo JSON correspondente:

bicep build main.bicep

Comparando JSON e Bicep

O bíceps fornece uma sintaxe mais simples para usar quando você estiver escrevendo modelos. Veja os exemplos a seguir de dois modelos. O modelo no lado esquerdo da tela é um modelo Bicep. O modelo no lado direito da tela é um modelo JSON.

Captura de tela que compara o código Bicep no lado esquerdo da tela e o código JSON correspondente no lado direito da tela.

Observe que o modelo Bicep contém menos código. A sintaxe é mais fácil de ler e compreender, e não há expressões complexas como no modelo JSON à direita.

Nota

Para visualizar arquivos JSON e Bicep equivalentes lado a lado, consulte Bicep Playground.