Generación de Bicep mediante la característica de redacción

La característica de redacción de la CLIazd para desarrolladores de Azure () simplifica el proceso de compilación, implementación y administración de aplicaciones en la nube. Gracias a azd compose, puede definir y gestionar la infraestructura y el código de la aplicación de su proyecto de forma unificada. En esta guía se explica cómo generar código de Bicep a partir de la azd compose característica, lo que le permite personalizar la infraestructura en la nube para satisfacer sus requisitos específicos.

Cómo azd compose gestiona el estado de la infraestructura

La azd compose característica realiza un seguimiento del estado de la infraestructura en memoria durante el proceso de composición. Este enfoque permite definir y refinar de forma iterativa la aplicación y la infraestructura sin generar archivos ni modificar inmediatamente el directorio del proyecto.

Al ejecutar el azd infra synth comando, el estado en memoria se convierte en archivos de Bicep en la infra carpeta . En este momento, el estado de la infraestructura pasa de administrarse en memoria a representarse como código, lo que permite una mayor personalización.

Generación del código de Bicep

Para explorar o personalizar el código de Bicep usado internamente por azd para aprovisionar recursos creados por azd add, ejecute el siguiente comando:

azd infra gen

Este comando genera los archivos de Bicep correspondientes en la carpeta de la infra aplicación.

Administración de actualizaciones con la generación de Bicep

Al ejecutar el comando azd infra gen, sale del flujo de trabajo azd compose y el proceso de inicialización simplificado. A partir de este punto, ya no se realiza un control de los cambios realizados en los archivos Bicep generados por azd compose. Si usted modifica los archivos de Bicep y al volver a ejecutar azd infra gen más adelante, el código recién generado sobrescribirá sus cambios manuales.

Este es el aspecto de un flujo de trabajo típico:

1. Usas azd add para agregar nuevos recursos de Azure a tu proyecto. Estos recursos se administran internamente mediante azd.
2. Una vez que haya terminado de agregar recursos, ejecute azd infra gen para generar archivos de Bicep para esos recursos en la carpeta de proyecto infra. En esta fase, los recursos ya no son administrados por el flujo de trabajo azd compose.
3. Ahora puede actualizar manualmente los archivos de Bicep a medida que continúa desarrollando la aplicación.
4. Si agrega más recursos o vuelve a ejecutarse azd infra gen , se volverá a generar el contenido de la infra carpeta y se perderán los cambios manuales.

Por este motivo, la función de composición es más idónea para los escenarios siguientes:

• Crear un conjunto inicial de recursos de Azure para el proyecto y, a continuación, administrar más actualizaciones usted mismo editando los archivos de Bicep.
• Administrar los recursos de Azure por completo a través de la función de composición sin ejecutar azd infra gen.

Pasos siguientes