Exploración de los flujos de trabajo de inicialización de la CLI para desarrolladores de Azure

La CLI para desarrolladores de Azure (azd) proporciona un conjunto de comandos para simplificar el desarrollo, el aprovisionamiento y la implementación de aplicaciones en Azure. El azd init comando le ayuda a configurar proyectos nuevos o existentes mediante la generación de los archivos y configuraciones necesarios para trabajar con azd. En este artículo se explican los distintos flujos de trabajo de inicialización disponibles y cómo seleccionar la mejor opción para su escenario de desarrollo.

Flujos de trabajo de inicialización

El azd init comando admite varios flujos de trabajo para preparar la aplicación para que funcione con azd:

Examinar el directorio actual: analiza un código base de aplicación existente para generar los archivos y recursos de configuración adecuados azd .
Seleccione una plantilla: clone e inicialice una plantilla desde una azdgalería de plantillas.
Crear un proyecto mínimo: inicializa un archivo básico azure.yaml como punto de partida para crear su propia azd plantilla desde cero.

Elija el enfoque que mejor se adapte al proyecto. Todos estos flujos se describen con más detalle en los artículos de información general sobre creación de plantillas y relacionados. En las secciones siguientes se proporciona información general conceptual de cada flujo.

Examen del directorio actual

Use este flujo de trabajo cuando tenga un código base de aplicación existente y quiera prepararlo para su implementación en Azure mediante azd.

Vaya al directorio raíz del proyecto.
Ejecute el comando azd init:
```
azd init
```

Seleccione Examinar el directorio actual. azd:

Examine el directorio para determinar el lenguaje o el marco que usa la aplicación.
Seleccione una plataforma de hospedaje adecuada, como Azure Container Apps.
Si es necesario, pida que agregue o quite los servicios detectados.

? How do you want to initialize your app? Scan current directory

  (✓) Done: Scanning app code in current directory

Detected services:

  .NET
  Detected in: src

azd will generate the files necessary to host your app on Azure using Azure Container Apps.

? Select an option  [Use arrows to move, type to filter]
> Confirm and continue initializing my app
  Remove a detected service
  Add an undetected service

Seleccione Confirmar y continuar inicializando mi aplicación para completar el flujo de trabajo. azd crea lo siguiente en el directorio de la aplicación:
- Un azure.yaml archivo que define los servicios de aplicaciones y los asigna a los recursos de hospedaje.
- Una .azure carpeta que contiene valores de configuración como el nombre del entorno.
- Un .gitignore archivo configurado para el idioma de la aplicación y la plataforma de hospedaje.
Opcionalmente, ejecute azd up para crear los recursos de Azure Container Apps e implementar la aplicación.

La aplicación ahora está estructurada como una azd plantilla que puede seguir desarrollando y expandiendo con más recursos y servicios de Azure.

Seleccione una plantilla:

Este flujo de trabajo le permite empezar con una plantilla precompilada azd que normalmente incluye código de aplicación y las definiciones de infraestructura de Azure necesarias.

Ejecute el comando azd init:
```
azd init
```
Nota:

También puede ejecutar azd init con el --template parámetro para inicializar directamente una plantilla por nombre y omitir la selección del flujo de trabajo.

Elija Seleccionar una plantilla. azd muestra una lista de plantillas disponibles de los orígenes de plantilla configurados.

? How do you want to initialize your app? Select a template
? Select a project template:  [Use arrows to move, type to filter]
> Deploy Phoenix to Azure
  (Arize-ai/phoenix-on-azure)

  API Center Reference Sample
  (Azure-Samples/APICenter-Reference)

  Event Driven Java Application with Azure Service Bus on Azure Spring Apps
  (Azure-Samples/ASA-Samples-Event-Driven-Application)

  Static React Web App with Java API and PostgreSQL
  (Azure-Samples/ASA-Samples-Web-Application)

Escriba para filtrar los resultados y buscar la Hello AZD plantilla. Presione Entrar para clonar e inicializar la plantilla.
De manera opcional, ejecute azd up para proveer e implementar la plantilla de recursos en Azure.

También puede usar la plantilla inicializada como punto de partida para el desarrollo posterior.

Creación de un proyecto mínimo

Para los usuarios avanzados que quieren empezar con una configuración mínima y personalizar todo manualmente, esta opción proporciona solo la configuración esencial.

Ejecute el azd init comando con la --minimal marca :
```
azd init --minimal
```
Cuando se le solicite, escriba un nombre para la azd plantilla y presione Entrar.
```
? How do you want to initialize your app? Create a minimal project
? What is the name of your project? (empty) hello-azd
? What is the name of your project? hello-azd

SUCCESS: Generated azure.yaml project file.
Run azd add to add new Azure components to your project.
```
La --minimal marca crea solo lo siguiente:
- Un archivo básico azure.yaml con solo el nombre del proyecto y schemaVersion
- Un .azure directorio para la configuración del entorno
- Un .gitignore archivo con entradas adecuadas para la CLI para desarrolladores de Azure
Esta inicialización simplificada es ideal cuando:
- Quiere compilar la infraestructura desde cero
- Necesidad de integrar azd con un proyecto complejo existente
- Planee usar el comando para compilar incrementalmente la azd add arquitectura.
- Preferir el control total sobre la estructura del proyecto
Después de la inicialización, puede hacer lo siguiente:
- Crear manualmente los archivos de infraestructura en una infra carpeta
- Uso de la azd addcaracterística de redacción para empezar a agregar recursos de Azure a la aplicación
- Personalización del azure.yaml archivo para definir los servicios y los recursos

Nomenclatura de recursos de Project y Azure

Al inicializar un proyecto nuevo o existente, el nombre del proyecto se establece en azure.yaml. El nombre del proyecto actúa como prefijo para los nombres de recursos de Azure creados durante el proceso de aprovisionamiento. Al cumplir las reglas de validación, asegúrese de que los nombres de recursos de Azure generados también serán válidos.

En las plantillas de Bicep o Terraform, el nombre del proyecto se usa a menudo como base para construir nombres de recursos, combinados con el nombre del entorno y otros elementos. Por ejemplo:

var resourceToken = '${name}-${environmentName}'

Donde name hace referencia al nombre del proyecto y environmentName es el nombre del azd entorno.

Reglas de validación de nombres de proyecto

Cuando se usa azd init para inicializar un proyecto o al crear un nuevo nombre de proyecto en el azure.yaml archivo, se aplican las siguientes reglas de validación:

Regla	Description
Caracteres permitidos	Los nombres de proyecto solo pueden incluir letras minúsculas, números y guiones.
Carácter inicial	Los nombres de proyecto deben comenzar con una letra.
Carácter final	Los nombres de proyecto no deben terminar con un guión.
Largura	Los nombres de proyecto deben tener entre 2 y 63 caracteres.
Sin guiones consecutivos	Los nombres de proyecto no pueden contener guiones consecutivos.

Estas reglas de validación garantizan que el nombre del proyecto será compatible con los requisitos de nomenclatura de los recursos de Azure y evitar errores de empaquetado del servicio durante la implementación.

Pasos siguientes

Después de inicializar el proyecto con azd init, puede hacer lo siguiente:

Modifique los archivos de infraestructura generados para personalizar los recursos de Azure.
Use azd provision para crear los recursos necesarios en Azure.
Use azd deploy para implementar el código de la aplicación en los recursos aprovisionados.
Obtenga información sobre el flujo de trabajo de la CLI para desarrolladores de Azure para combinar el aprovisionamiento y la implementación en un solo comando.

Comentarios

¿Le ha resultado útil esta página?

Last updated on 2025-08-15