Resumen

  • 1 minuto

Tras acordar compartir la plantilla de Bicep con nuestros compañeros, cuando empezamos a revisarla con ellos quedó patente que estaban confusos con lo que hacía, así que decidimos refactorizarla para que pudieran entenderla, reutilizarla y modificarla con mayor facilidad.

En este módulo, hemos aprendido a escribir y estructurar el código de Bicep para fomentar la colaboración. Hemos refactorizado la plantilla para mejorar los parámetros y los nombres de los recursos. También la hemos reestructurado para que sea más fácil de entender y usar. Por último, hemos incluido en ella documentación explicativa en forma de comentarios y metadatos.

A lo largo del proceso, hemos visto cómo la extensión de Bicep para Visual Studio Code puede ayudarnos a refactorizar y reorganizar el código de Bicep. Gracias a los cambios que efectuamos en el código de Bicep, nuestros compañeros pudieron usar la plantilla y cumplir con el plazo de entrega.

Cuando trabajamos solos, es fácil olvidarse de estructurar el código de Bicep para que sea comprensible para otros usuarios. Pero si adquirimos buenos hábitos, usamos los procedimientos recomendados y dedicamos tan solo un poco de tiempo, lograremos que nuestros compañeros implementen la plantilla y tengan nuestro trabajo como referencia.

Y también será más fácil para nosotros, cuando tengamos que usar el código de Bicep posteriormente.

Sugerencia

A medida que siga usando Bicep, obtendrá las ventajas de comprender los patrones de Bicep. Los patrones proporcionan soluciones probadas a algunos de los escenarios comunes a los que se enfrentan los usuarios de Bicep.

También debe estar familiarizado con los escenarios de Bicep que proporcionan instrucciones sobre cómo compilar archivos Bicep para tipos específicos de recursos de Azure.

Referencias