Introducción
Una de las ventajas de implementar la infraestructura como código es que las plantillas se pueden compartir, lo que permite colaborar en el código de Bicep con otros miembros del equipo. Es importante que el código de Bicep sea fácil de leer y de utilizar.
En este módulo, veremos algunas formas de estructurar y dar estilo al código de Bicep para que los demás puedan entenderlo, modificarlo e implementarlo fácilmente.
Escenario de ejemplo
Supongamos que somos administradores de infraestructuras de Azure en una empresa de juguetes. En nuestro equipo se ha estandarizado el uso de Bicep en implementaciones de Azure, y para ello hemos creado una biblioteca de plantillas reutilizables.
Dos miembros del equipo de control de calidad han recibido el encargo de realizar una encuesta entre los clientes. Para ello, deben poner en marcha una base de datos y un sitio web nuevos. El plazo de tiempo es ajustado, y prefieren no tener que crear una plantilla completa desde cero si no es estrictamente necesario. Después de hablar con ellos sobre los requisitos, nos acordamos de que ya existe una plantilla bastante parecida a la que buscan.
Dicha plantilla es uno de los primeros archivos de Bicep que escribimos, de modo que nos preocupa que no esté lista para que puedan usarla. La pregunta es: ¿cómo podemos revisar la plantilla para asegurarnos de que es correcta, fácil de entender, fácil de leer y fácil de modificar?
¿Qué hará?
En este módulo, aprenderemos a mejorar y refactorizar archivos de Bicep para que otros puedan usar nuestro código más fácilmente. Veremos cómo los parámetros y los nombres son parte esencial para que el código de Bicep y las implementaciones de Azure sean útiles para los demás. También aprenderemos a definir la estructura de la plantilla, a mantener un estilo coherente y a incluir comentarios que ayuden a nuestros compañeros a comprender cómo funciona la plantilla.
¿Cuál es el objetivo principal?
Al término de este módulo, sabremos crear plantillas de Bicep claras, reutilizables y bien documentadas.
Requisitos previos
Debe estar familiarizado con la estructura y la sintaxis de Bicep (parámetros, bucles, condiciones y módulos incluidos).
Para seguir los ejercicios del módulo, necesitará lo siguiente:
- Visual Studio Code instalado localmente
- La extensión Bicep para Visual Studio Code instalada localmente