Bicep: IaC moderno do Azure

O Bicep é uma linguagem específica de domínio (DSL) desenvolvida pela Microsoft como uma alternativa concisa e fortemente tipada aos modelos JSON do ARM. O Bicep é compilado para o JSON padrão do ARM, portanto usa o mesmo mecanismo de implantação do ARM e é compatível com todos os tipos de recursos do Azure desde o primeiro dia. O Bicep elimina grande parte do código repetitivo exigido pelo JSON puro e oferece melhor segurança de tipos e suporte ao IntelliSense.

A mesma conta de armazenamento que exige cerca de 25 linhas de JSON em um modelo do ARM precisa de apenas cerca de 8 linhas no Bicep. O Bicep elimina '$schema', contentVersion, o contêiner da matriz resources e a sintaxe detalhada das expressões. Os nomes e tipos das propriedades permanecem idênticos, pois o Bicep é uma camada de abstração direta sobre o JSON do ARM — não há nenhuma diferença em tempo de execução.

Os parâmetros do Bicep usam uma sintaxe concisa param name type = defaultValue. Você pode aplicar decoradores (prefixados com @) diretamente acima de um parâmetro para adicionar restrições, como @minLength(), @maxLength(), @allowed() e @description(). O decorador @secure() marca um parâmetro como confidencial, sendo equivalente a secureString no JSON do ARM.

As variables do Bicep são declaradas com a palavra-chave var e podem conter qualquer expressão, inclusive interpolação de cadeias de caracteres usando a sintaxe '${value}'. A interpolação de cadeias de caracteres é uma das melhorias de legibilidade mais importantes em relação ao JSON do ARM — não são mais necessárias chamadas à função concat(). O Bicep também é compatível com expressões condicionais usando o operador ternário condition ? trueValue : falseValue.

No Bicep, cada recurso recebe um nome simbólico — um identificador usado para referenciá-lo dentro do modelo. O nome simbólico não é igual ao nome do recurso no Azure. Use nomes simbólicos para acessar propriedades de recursos e estabelecer dependências implícitas, referenciando um recurso dentro de outro e eliminando a necessidade de uma matriz dependsOn explícita.

As saídas do Bicep são declaradas com a palavra-chave output, seguida pelo nome, tipo e valor da saída. Pode referenciar as propriedades de um recurso implantado usando o nome simbólico e a notação de ponto, que é muito mais legível do que a função reference() do ARM. As saídas são essenciais para transmitir valores entre chamadas de módulos do Bicep.

Os módulos do Bicep são equivalentes aos modelos vinculados no JSON do ARM, permitindo dividir a infraestrutura em componentes reutilizáveis. Um módulo é simplesmente outro arquivo .bicep. Pode referenciá-lo usando a palavra-chave module, passar parâmetros e consumir suas saídas. Os módulos também podem ser publicados e consumidos a partir de um Azure Container Registry para reutilização por toda a equipe.

Se já tiver modelos JSON do ARM existentes, a CLI do Bicep poderá descompilá-los para Bicep usando bicep decompile. O resultado pode exigir alguma limpeza manual, mas oferece um excelente ponto de partida. A Microsoft também disponibiliza um playground online em aka.ms/bicepdemo, onde pode colar JSON do ARM e ver o Bicep equivalente em tempo real.

A CLI do Azure oferece suporte direto a arquivos Bicep — não é necessário compilá-los manualmente para JSON do ARM antes da implantação. Passe o caminho do arquivo .bicep para az deployment group create usando a opção --template-file, e a CLI fará a compilação de forma transparente. Os mesmos subcomandos validate e what-if funcionam com arquivos Bicep exatamente como com JSON do ARM.

O Bicep oferece suporte a loops de recursos usando a sintaxe for ... in para criar várias instâncias de um recurso a partir de um parâmetro de matriz, eliminando a duplicação por copiar e colar. A palavra-chave if habilita a implantação condicional de recursos — incluindo um recurso somente quando determinada condição for verdadeira. Esses dois recursos são compilados, respectivamente, nas construções copy e condition do ARM.

A extensão do Bicep para o Visual Studio Code oferece IntelliSense avançado, verificação de tipos e destaque de erros na linha enquanto digita. A CLI do Bicep inclui um analisador que verifica violações de boas práticas, como parâmetros não utilizados, descrições ausentes e versões incorretas da API. Execute az bicep lint --file main.bicep no seu pipeline de CI para detectar problemas antes da implantação.

Teste sua compreensão dos conceitos do Microsoft Azure Fundamentals (AZ-900) apresentados nesta lição.

Nesta lição, aprendeu que: o Bicep é uma abstração concisa e fortemente tipada sobre o JSON do ARM, que é compilada para modelos ARM padrão; módulos e loops permitem criar código de infraestrutura reutilizável e DRY; e a CLI do Azure implanta arquivos Bicep diretamente, oferecendo suporte ao mesmo fluxo de trabalho de validação, what-if e implantação. A seguir, exploraremos o Terraform no Azure.