Como funciona o Bicep

Concluído

Você desenvolveu uma compreensão da linguagem de modelo Bicep e os benefícios que ela oferece 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 é uma linguagem específica do domínio, o que significa que ele foi projetado para um cenário ou domínio específico. 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 ao 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.

Diagram that shows the workflow from a template author, a Bicep template, an emitted JSON template, and a deployment to 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 o que já está implantado 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 à esquerda é um modelo Bicep. O modelo à direita é um modelo JSON.

Screenshot that compares Bicep code on the left and the corresponding JSON code on the right.

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.