Comience con una nueva plantilla de la CLI para desarrolladores de Azure (azd)

Puede usar diferentes métodos de creación para compilar los archivos estándar en una nueva plantilla de la CLI para desarrolladores de Azure (azd):

Usa la integración de GitHub Copilot en azd init. El flujo de trabajo integrado analiza los archivos de proyecto existentes o le ayuda a planear un nuevo proyecto, crea los recursos de plantilla y ejecuta la validación de la implementación previa.
Use otro asistente de codificación de IA. Pida al asistente que cree los mismos azure.yaml, la infraestructura como código, la aplicación y los archivos auxiliares sin integrarse directamente con azd init.
Cree los archivos directamente. Cree y edite los recursos de plantilla usted mismo cuando desee un control completo o no use un asistente de codificación de IA.

Este artículo se centra principalmente en el flujo de trabajo integrado de GitHub Copilot porque proporciona una experiencia guiada integrada con azd. Independientemente del método de creación, revise y valide cada archivo antes de la implementación.

Importante

La integración de GitHub Copilot en azd init está en versión preliminar. Las características de vista previa pueden cambiar antes de la disponibilidad general. Para obtener más información, consulte la azd estrategia de control de versiones de características y de lanzamiento.

Los recursos generados son archivos de plantilla estándar y editables azd . Después de la inicialización, puede actualizarlas directamente o con cualquier asistente de codificación de IA.

Requisitos previos para GitHub Copilot

Para usar el flujo de trabajo integrado de Copilot, necesita lo siguiente:

Azure CLI para desarrolladores 1.23.11 o posterior.
Una suscripción de GitHub Copilot activa.
Git, que azd init usa para inspeccionar el árbol de trabajo antes de modificar los archivos.
Una sesión de terminal interactiva.

Si aún no está autenticado con GitHub Copilot, azd le pedirá que inicie sesión.

Ejecute azd version para comprobar la versión de la CLI de desarrollador de Azure instalada.

Note

El flujo de trabajo azd init inicia una sesión dedicada del agente de GitHub Copilot en la terminal. No usa ni continúa una sesión activa de GitHub Copilot Chat en Visual Studio Code.

Compilación con GitHub Copilot

Abra un terminal en el directorio donde desea compilar la plantilla.

Note

El directorio puede contener una aplicación existente, un proyecto de infraestructura o los archivos iniciales de una nueva solución. Si el directorio contiene cambios no confirmados, azd le pide que confirme antes de continuar. Confirme o guarde primero los cambios importantes.
Ejecuta azd init:
```
azd init
```

Seleccione Configurar con gitHub Copilot (versión preliminar).

La solicitud de inicialización es similar al ejemplo siguiente:

? How do you want to initialize your app?
   Scan current directory
   Select a template
> Set up with GitHub Copilot (Preview)

Revise el acceso solicitado a las herramientas y conceda acceso a las herramientas necesarias para el flujo de trabajo. Copilot usa azd y Azure funcionalidades de desarrollo para inspeccionar el proyecto, crear archivos y validar el resultado.
Seleccione un modelo y un nivel de razonamiento si azd le pide que los configure.

En la primera ejecución, las indicaciones usan las etiquetas siguientes. Las opciones de modelo y razonamiento disponibles dependen de la cuenta de GitHub Copilot y del modelo seleccionado:
```
? Select AI model
? Select reasoning effort level
```
Describe lo que quieres crear. Incluya los requisitos pertinentes, como:
- Si la plantilla incluye código de aplicación, solo infraestructura o ambos.
- Los lenguajes y marcos de la aplicación, si se conocen.
- Los servicios Azure y la plataforma de hospedaje que se van a usar.
- Si usar Bicep o Terraform.
- Requisitos de seguridad, redes, escalado y región.
Por ejemplo:
```
Build an infrastructure-only azd template that provisions an Azure Container Apps
environment, Azure Container Registry, and Log Analytics workspace with Bicep.
Use managed identity and least-privilege role assignments. Parameterize the location
and environment name so the template can be reused.
```
Responda a cualquier pregunta de arquitectura o configuración de Copilot. El agente prepara el proyecto para Azure, genera los recursos de plantilla y ejecuta la validación previa a la implementación.
Revise la estructura general de los archivos que Copilot creó o cambió. Confirme que la plantilla incluye la configuración esperada del proyecto, el directorio de infraestructura, el origen de la aplicación y los recursos auxiliares de la solución.

Por ejemplo, una plantilla solo de infraestructura generada podría contener los siguientes archivos de clave:
```
azure.yaml
infra/
├── main.bicep
├── main.parameters.json
└── modules/
   ├── container-apps-environment.bicep
   └── container-registry.bicep
```
Para obtener instrucciones detalladas sobre cómo revisar el contenido de la configuración y la infraestructura, consulte Exploración y edición de archivos de plantilla.

Aprovisionamiento e implementación de la plantilla

Después de aprobar los archivos generados, ejecute el siguiente comando:

azd up

El comando crea o selecciona un azd entorno, aprovisiona los recursos Azure, empaqueta todos los servicios de aplicación e los implementa. Para obtener un desglose detallado de comandos, consulte Exploración del flujo de azd up trabajo.

Uso de otro método de creación

Otros asistentes de codificación de IA no están conectados directamente al azd init flujo de trabajo, pero pueden crear los mismos recursos de plantilla estándar. También puede crear directamente cada recurso.

Cree estos recursos usted mismo o pida a otro asistente de codificación que analice sus requisitos y créelos:

Archivo azure.yaml que define el proyecto y los servicios que se pueden implementar.
Bicep o archivos de Terraform que aprovisionan los recursos Azure necesarios.
Salidas de recursos y variables de entorno de aplicación.
Dockerfiles, configuración de implementación y scripts auxiliares cuando sea necesario.

Para proporcionar un punto de partida mínimo antes de usar otro agente, ejecute:

azd init --minimal

Si usa otro asistente de codificación, indíquele que siga el azure.yaml esquema, las prácticas de seguridad de la infraestructura de Azure y las convenciones de plantilla descritas en las plantillas de Azure Developer CLI. Si crea los archivos directamente, use las mismas referencias que la guía de implementación. Revise y valide todos los archivos antes de ejecutar azd up.

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.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2026-09-16