Compartir vía


Introducción a la creación de plantillas de la CLI para desarrolladores de Azure

La CLI para desarrolladores de Azure (azd) utiliza plantillas para aprovisionar e implementar recursos de aplicación en la nube. Los desarrolladores pueden agregar compatibilidad con azd comandos y características convirtiendo sus aplicaciones en plantillas. En este artículo se proporciona información general contextual de las distintas opciones para crear azd plantillas. Una vez que comprenda los conceptos de este artículo, visite los siguientes recursos para obtener guías de implementación más detalladas:

Nota:

En este artículo se da por supuesto un conocimiento general de las azd plantillas. Consulte la documentación de información general sobre plantillas para obtener más información sobre las plantillas.

Conceptos de creación de plantillas

La creación de una azd plantilla requiere agregar recursos de infraestructura y configuración específicos a la base de código existente o iniciar una nueva aplicación desde una plantilla existente esos mismos recursos. Ambos flujos de trabajo se explican en secciones posteriores. Todas las azd plantillas comparten una estructura de archivos similar basada en azd convenciones. En el diagrama siguiente se proporciona información general rápida sobre el proceso para crear una azd plantilla:

Diagrama del flujo de trabajo de plantilla de la CLI para desarrolladores de Azure.

Cada azd plantilla requiere los siguientes recursos mínimos:

  • Carpeta infra que contiene la infraestructura como archivos de código (Bicep o Terraform).
  • Un azure.yaml archivo de configuración que asigna los servicios de aplicación a los recursos de infraestructura aprovisionados.

También se incluyen otros directorios opcionales, como una .github carpeta con recursos para crear una canalización de CI/CD. Consulte la documentación de información general sobre plantillas para obtener más información sobre las plantillas.

Tenga en cuenta el siguiente repositorio de aplicaciones de ejemplo:

Captura de pantalla que muestra la estructura de la aplicación de ejemplo.

Después de convertir esta aplicación de ejemplo en una azd plantilla, el mismo repositorio de aplicaciones contiene lo siguiente:

Captura de pantalla que muestra la estructura completada de la plantilla azd.

Los recursos originales de la aplicación no se modifican, pero se agregaron nuevos recursos que azd dependen de para comandos como azd up:

  • Se agregó una infra carpeta que incluye archivos de Bicep para crear recursos de Azure.
  • Se agregó un azure.yaml archivo de configuración para asignar el código de la aplicación en el src directorio a los recursos de Azure de aprovisionamiento.
  • Se creó una .azure carpeta para contener azd variables de entorno.
  • Se ha agregado una .github carpeta (opcional) para admitir canalizaciones de CI/CD a través de acciones de GitHub.

Flujos de trabajo de creación de plantillas

El azd init comando se usa para inicializar una azd plantilla para aprovisionar e implementar los recursos de la aplicación en Azure. El comando le pide que elija entre dos flujos de trabajo diferentes para inicializar una plantilla que se describe en las secciones siguientes: use código en el directorio actual y Use an existing template (Usar una plantilla existente).

Ejecute el azd init comando en la raíz del directorio que desea convertir en :azd template

azd init

Captura de pantalla que muestra el proceso de inicialización de plantilla.

Usar código en el directorio actual

Esta opción indica azd a analizar el código del directorio para identificar qué tecnologías usa, como el lenguaje de programación, el marco de trabajo y el sistema de base de datos. azd genera automáticamente recursos de plantilla, como el archivo de definición de azure.yaml servicio y la infra carpeta con archivos de infraestructura como código. Los recursos generados son un punto de partida para modificaciones adicionales. Use este enfoque si planea usar los servicios comunes de Azure admitidos por azd las características de scaffolding.

Visite el tutorial Inicio con el código de la aplicación para crear una plantilla para más información sobre cómo implementar este enfoque y más información sobre qué recursos de Azure admiten la detección automática y scaffolding.

Seleccione una plantilla

Seleccione esta opción para usar una plantilla existente que defina muchos de los recursos de Azure y los objetivos arquitectónicos como punto de partida. azd le pedirá que seleccione una plantilla de inicio u otra plantilla de la galería awesome-azd . Al seleccionar una plantilla, los recursos de esa plantilla se agregan al directorio de proyecto existente para usarlo como punto de partida. Algunas plantillas incluyen código de aplicación de ejemplo que puede reemplazar por el suyo propio, mientras que algunos (denominados "plantillas de inicio") son solo infraestructura.

Use el azd init comando para extraer una plantilla existente en un directorio vacío y úsela como punto de partida para su propia aplicación. Si la plantilla incluye código fuente de la aplicación, puede compilarse fuera de ese código o reemplazar el directorio de código fuente por el suyo propio.

Visite el tutorial Inicio con una plantilla existente para obtener más información sobre cómo implementar este enfoque.

Consulte también

Solicitar ayuda

Para obtener información sobre cómo archivar un error, solicitar ayuda o proponer una nueva característica para la CLI para desarrolladores de Azure, visite la página de solución de problemas y soporte técnico .

Pasos siguientes