Creación de la estructura de la plantilla

Completado

Azure Developer CLI (azd) le ayuda a crear nuevas plantillas para las aplicaciones mediante el comando azd init y las plantillas de inicio. En esta unidad, creará el scaffolding básico o la estructura de una nueva plantilla en la que se basará en el resto del módulo.

1. En un directorio vacío de la máquina local, ejecute el comando azd init.

   azd init
   

2. La salida del comando muestra una lista de plantillas de inicio y opciones completas de la aplicación de ejemplo. Las plantillas de inicio incluyen la estructura de carpetas esencial, los archivos de inicio de infraestructura como código y otros archivos de configuración reutilizables para empezar a crear plantillas. Las plantillas de ejemplo completas también incluyen código de aplicación de marcador de posición y los archivos necesarios para implementarlas. En este módulo, aprenderá a crear su propia plantilla en lugar de modificar el código de aplicación existente, por lo que elegirá la opción Starter - Bicep de la lista. Azure Developer CLI también admite el uso de Terraform si prefiere esa opción. La compatibilidad con Terraform está actualmente en fase alfa y debe habilitarse manualmente.

3. Cuando se le solicite un nombre de entorno, escriba azdlearn o un nombre de su elección. El nombre del entorno influye en la nomenclatura de los recursos aprovisionados en Azure.

4. Se crea un conjunto de carpetas dentro del directorio actual:

   

Nota:

Es posible que haya observado que el comando azd init también proporciona una plantilla de proyecto denominada Minimal, que contiene la estructura de plantilla más sencilla posible. Sin embargo, la plantilla Starter - Bicep que seleccionó incluye código de scaffolding adicional que es muy útil pero todavía independiente de la tecnología, por lo que a menudo es una excelente opción para empezar.

Las carpetas generadas proporcionan todos los bloques de creación esenciales de una plantilla azd:

• .azdo: carpeta que contiene los archivos de configuración .yml de inicio para CI/CD con Azure Pipelines.
• .azure: una carpeta que contiene la configuración esencial del entorno de Azure de la plantilla, como el nombre del entorno.
• .devcontainer: carpeta que contiene los archivos de configuración que se usan para ejecutar la plantilla en un entorno de contenedor de desarrollo.
• .github: una carpeta que contiene una plantilla de configuración .yml de inicio para configurar una canalización de CI/CD mediante acciones de GitHub.
• infra: una carpeta que contiene archivos de Bicep de inicio para la infraestructura como código de la plantilla. Si seleccionó la plantilla de inicio de Terraform, esta carpeta contiene archivos de Terraform en su lugar.
• azure.yaml: un archivo que describe cómo las partes de la aplicación se asignan a los servicios de Azure.

Esta plantilla de inicio contiene la mayoría de lo que necesita para crear su propia plantilla azd. En las siguientes unidades, aprenderá a actualizar estos archivos existentes y a agregar nuevos recursos para crear una plantilla completa.