Como o Bicep funciona

  • 3 minutos

Você desenvolveu um reconhecimento sobre a linguagem do modelo Bicep e sobre os benefícios que ela fornece para a criação de modelos. Antes de começar o processo de criação de modelos Bicep para provisionar seus recursos, convém saber mais sobre como o Bicep funciona.

Nesta unidade, você aprende como o Bicep funciona com o Azure Resource Manager.

Implantação do Bicep

Na unidade anterior, você aprendeu que o Bicep foi projetado para um cenário ou domínio específico, o que faz com que seja uma linguagem específica de 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 Resource Manager, que ainda requer modelos JSON. As ferramentas incorporadas ao Bicep convertem o modelo Bicep em um modelo JSON. Esse processo é conhecido como transpilação, que basicamente trata o modelo do ARM como uma linguagem intermediária. A conversão ocorre automaticamente quando você envia sua implantação, ou você pode fazer isso 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.

Observação

Transpilação é o processo de converter o código-fonte escrito em uma linguagem para outra.

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

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

Após enviar essa implantação, o Resource Manager examina os recursos atualmente implantados no Azure. Em seguida, ele analisa o que você está tentando implantar e configura uma sequência de etapas para atingir esse estado. Todas essas atividades envolvem a invocação da API do Resource Manager.

Exiba o modelo JSON enviado para o Resource Manager usando o comando bicep build. No próximo exemplo, um modelo Bicep é convertido em seu modelo JSON correspondente:

bicep build main.bicep

Comparar JSON e Bicep

O Bicep fornece uma sintaxe mais simples para criar modelos. Confira a seguir os exemplos de dois modelos. O modelo à esquerda da tela é um modelo Bicep. O modelo à direita da tela é um modelo JSON.

Captura de tela que compara o código Bicep à esquerda da tela e o código JSON correspondente à direita 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.

Observação

Para exibir arquivos JSON e Bicep equivalentes lado a lado, confira Bicep Playground.