Resumo
Você concordou em compartilhar o modelo Bicep com seus colegas, mas quando vocês começaram a examiná-lo juntos, ficou claro que eles ficaram confusos sobre a função dele. Você queria refatorar o modelo para facilitar o entendimento, a reutilização e a modificação dele para seus colegas.
Neste módulo, você aprendeu a escrever e estruturar seu código Bicep para dar suporte à colaboração. Você refatorou seu modelo para aprimorar os parâmetros e os nomes de recursos. Você o reestruturou para facilitar o entendimento e o uso dele. Além disso, você adicionou uma documentação explicativa na forma de comentários e metadados.
Durante esse processo, você viu como a extensão do Bicep para Visual Studio Code pode ajudar você a refatorar e reorganizar seu código Bicep. O resultado das alterações que você fez no código Bicep foi que os seus colegas conseguiram usar o modelo e cumpriram o prazo final.
Quando você trabalha individualmente, é fácil esquecer de estruturar o código Bicep para que ele seja compreensível para outras pessoas. Porém, ao estabelecer bons hábitos, aplicar as melhores práticas e investir um pouco de tempo, você pode facilitar para seus colegas implantar o modelo e continuar seu trabalho.
Você também facilitará o trabalho para você mesmo quando precisar usar o código Bicep no futuro.
Dica
Quanto mais você usa o Bicep, melhor será sua compreensão dos padrões do Bicep. Os padrões fornecem soluções comprovadas para alguns dos cenários comuns que os usuários do Bicep enfrentam.
Você também deve ter familiaridade com os cenários Bicep, que fornecem orientações sobre como criar arquivos Bicep para tipos específicos de recursos do Azure.
Referências
- Melhores práticas para o Bicep
- Diretrizes do Cloud Adoption Framework sobre nomenclatura e marcação
- Regras de nomes de recursos do Azure