Información general sobre el desarrollo de plantillas de la CLI para desarrolladores de Azure (azd)

Las plantillas de Azure Developer CLI (azd) incluyen la configuración, la infraestructura y el código de aplicación opcional necesarios para aprovisionar e implementar una solución en Azure. Puede usar una plantilla para una aplicación, un proyecto de solo infraestructura o un punto de partida reutilizable para proyectos futuros.

Note

Antes de empezar, lea las plantillas de Azure Developer CLI para obtener una descripción completa de la estructura de las plantillas, los recursos obligatorios y opcionales, las asociaciones entre servicios y recursos, y cómo los comandos azd usan cada archivo.

Flujo de trabajo de desarrollo de plantillas

El siguiente flujo de trabajo se aplica si crea una plantilla o inicializa una que ya existe:

Diagrama del flujo de trabajo de desarrollo de plantillas de la CLI para desarrolladores de Azure. A la izquierda, un cuadro con la etiqueta "Elegir un punto de partida" contiene dos opciones: "Empezar con una nueva plantilla" y "Iniciar desde una plantilla existente". Ambas opciones conducen a "Explorar y editar los archivos de plantilla". Desde allí, una ruta opcional lleva a «Extender la plantilla», y la ruta principal continúa hasta «Ejecutar `azd up`». El paso "Extender la plantilla" también conduce a "Ejecutar azd up". Por último, "Run azd up" lleva a "Mantener o compartir la plantilla".

• Elija un punto de partida:Comience con una nueva plantilla con la integración de GitHub Copilot, otro asistente de codificación de IA o creación directa. Como alternativa, comience desde una plantilla existente desde Microsoft, su organización o la comunidad de desarrolladores.
• Explore y edite los archivos: Revise cómo azure.yamlfuncionan conjuntamente los archivos , Bicep o Terraform, el código de la aplicación y la configuración compatible. Consulte Exploración y edición de archivos de plantilla.
• Amplíe y evolucione según sea necesario: Agregue, reemplace, quite o rediseñe los componentes de la aplicación y la infraestructura. Siga Ampliar una plantilla para ver un ejemplo completo que agrega un recurso de Azure y lo conecta a una aplicación.
• Aprovisionamiento e implementación: Ejecute azd up para aprovisionar la infraestructura e implementar cualquier servicio de aplicaciones. Para obtener más información, consulte Exploración del flujo de azd up trabajo.
• Mantener o compartir: Siga editando la plantilla a medida que evoluciona el proyecto. Si planea compartirlo, pruébelo primero en un directorio limpio y con un entorno azd nuevo.

Note

A lo largo de este flujo de trabajo, puede crear, editar o reemplazar archivos de plantilla usted mismo o con ayuda de un asistente de codificación de IA. El resultado es el mismo conjunto de recursos estándar y editables azd .

Bloques de creación de plantillas

Cada azd plantilla admite una solución diferente, pero la mayoría de las plantillas combinan los mismos tipos de recursos:

• Configuración del proyecto: El archivo azure.yaml identifica el proyecto, los servicios desplegables, los directorios de origen, los destinos de alojamiento y los hooks o flujos de trabajo opcionales.
• Infraestructura como código: Bicep o archivos de Terraform definen los recursos de Azure, las asignaciones de roles, las redes y la configuración de la aplicación que requiere la solución.
• Origen de la aplicación: Una plantilla puede incluir una o varias aplicaciones que se pueden implementar o solo puede contener infraestructura.
• Configuración del entorno: Los parámetros pasan valores específicos del entorno a implementaciones y las salidas de infraestructura se convierten en valores en el entorno activo azd .

Una plantilla para una aplicación puede usar la siguiente estructura de carpetas:

.
├── azure.yaml                # Project configuration
├── infra/                    # Infrastructure as code
│   ├── main.bicep
│   ├── main.parameters.json
│   └── modules/
├── src/                      # Application source
│   ├── api/
│   └── web/
├── .github/                  # Pipeline workflows
│   └── workflows/
└── README.md

La estructura exacta varía según el proyecto. El origen de la aplicación, los módulos de infraestructura y los archivos de canalización son opcionales e azure.yaml identifica las rutas de acceso que azd usa. Estos recursos funcionan juntos a lo largo del ciclo de vida de desarrollo de plantillas.

Pasos siguientes

Empezar con una nueva plantilla

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 troubleshooting and support.