Creación de una plantilla mínima con la característica de redacción de la CLI para desarrolladores de Azure

La característica de composición (compose) de la CLIazd para desarrolladores de Azure permite redactar progresivamente los recursos de Azure necesarios para la aplicación sin escribir manualmente código de Bicep. En este artículo, aprenderás a trabajar con la función de redacción para crear una plantilla mínima. Visita el artículo de información general deazd redacción para obtener más información conceptual sobre esta característica.

Nota:

La azd función de composición está actualmente en fase alfa y no debería utilizarse en aplicaciones de producción. Los cambios en las características alfa de las versiones posteriores pueden dar lugar a cambios importantes. Visite las páginas azd feature versioning and release strategy and feature stages (Azd feature versioning and release strategy and feature stages ) para obtener más información. Use el botón Comentarios en la esquina superior derecha para compartir comentarios sobre la compose característica y este artículo.

Trabajar con la función de redacción

Acceda a azd las funciones de redacción a través del azd add comando. El azd add comando funciona con plantillas creadas mediante los siguientes azd init flujos de trabajo:

• Uso de código en el directorio actual (para aplicaciones destinadas a Azure Container Apps para hospedaje)
• Crear un proyecto mínimo

Actualmente no se admiten las plantillas inicializadas a través del flujo Seleccionar una plantilla . La azd función de redacción administra la infraestructura por ti y no es compatible con las plantillas que tienen recursos de carpeta existentes infra . Para obtener más información, visite el artículo Generar el código de Bicep y la página de flujos de trabajo de creación de plantillas .

Complete los siguientes pasos para agregar nuevos recursos a su plantilla sin escribir ningún código:

1. En una ventana de terminal, navegue hasta la raíz de su azd plantilla.

2. Ejecuta el azd add comando para agregar un nuevo recurso e iniciar el flujo de trabajo de redacción:

   azd add
   

3. Seleccione uno de los recursos admitidos para agregarlo a la aplicación. En este ejemplo, seleccione Database.

   ? What would you like to add? [Use arrows to move, type to filter]
   > AI
     Database
     Host service
     Key Vault
     Messaging
     Storage account
     ~Existing resource
   

4. Para el tipo de base de datos, seleccione PostgreSQL.

   ? Which type of database?  [Use arrows to move, type to filter]
     MongoDB
   > PostgreSQL
     Redis
   

5. Escriba un nombre para el nuevo recurso, como azddb.

   ? Input the name of the app database (PostgreSQL)
   

6. Si la aplicación contiene servicios, azd se te pide que selecciones el servicio que usa este recurso.

   ? Select the service(s) that uses this resource
   > [✓]  webfrontend
   

7. azd Genera una vista previa de los cambios necesarios en el azure.yaml archivo. Pulse Intro para aceptar y aplicar los cambios.

   Previewing changes to azure.yaml:
   
   +  azddata:
   +      type: db.postgres
   
      webfrontend:
          type: host.containerapp
          uses:
              - azddb
   +          - azddata
          port: 80
   

8. Ejecute el azd up comando para aprovisionar los cambios realizados a través del azd add comando. En este ejemplo, azd aprovisiona una base de datos PostgreSQL en Azure.

9. Vuelva a ejecutar el azd add comando para agregar otros recursos, como un servicio de OpenAI.

Exploración del archivo azure.yaml

azure.yaml es el archivo de configuración que azd se usa para administrar la aplicación. azdAdministra los servicios y recursos compuestos a través del azd add comando utilizando los nodos and resources correspondientesservices. Considere el siguiente ejemplo de un azure.yaml archivo actualizado completamente a través azd addde :

name: azdcomposesample
metadata:
  template: azd-init@1.11.0
services:
  webfrontend:
    project: src
    host: containerapp
    language: dotnet
resources:
  webfrontend:
    type: host.containerapp
    port: 80
    uses:
      - azdsql
      - azdchat
  azdsql:
    type: db.postgres
  azdchat:
    type: ai.openai.model
    model:
      name: gpt-4o
      version: "2024-08-06"

• El services nodo declara:
  • Una asignación de implementación con nombre webfrontend entre una aplicación web de .NET en el src directorio y Azure Container Apps.
• El resources nodo declara:
  • Una aplicación de contenedor de Azure y una asignación de dependencias coincidente con nombre webfrontend entre la aplicación de contenedor de .NET hospedada y la base de datos y el servicio de inteligencia artificial del que depende. El uses nodo asigna la aplicación a los demás recursos de los que depende.
  • Un recurso de Azure Database for PostgreSQL denominado azdsql.
  • Un recurso de Azure OpenAI denominado azdchat.

Pasos siguientes

Generar código Bicep mediante la función de redacción