Creare un modello minimo usando la funzionalità di composizione dell'interfaccia della riga di comando per sviluppatori di Azure

La funzionalità componibilità (azdcompose) dell'interfaccia della riga di comando per sviluppatori di Azure consente di comporre progressivamente le risorse di Azure necessarie per l'app senza scrivere manualmente codice Bicep. Questo articolo illustra come usare la funzionalità compose per creare un modello minimo. Per ulteriori informazioni concettuali su questa funzionalità, visita l'articolo azd panoramica sulla composizione.

Annotazioni

La azd funzionalità di composizione è attualmente in alfa e non deve essere usata nelle app di produzione. Le modifiche apportate alle funzionalità alfa nelle versioni successive possono comportare modifiche di rilievo. Per altre informazioni, visitare le pagine azd feature versioning and release strategy and feature stages (Fasi di rilascio e strategia di rilascio e fasi delle funzionalità azd). Usare il pulsante Feedback in alto a destra per condividere commenti e suggerimenti sulla compose funzionalità e questo articolo.

Usare la funzionalità di composizione

Accedere alle azd funzionalità di composizione tramite il azd add comando . Il azd add comando funziona con i modelli creati usando i flussi di lavoro seguenti azd init :

• Usare il codice nella directory corrente (per le app destinate ad App contenitore di Azure per l'hosting)
• Creare un progetto minimo

I modelli inizializzati tramite il flusso Selezionare un modello non sono attualmente supportati. La funzione azd compose gestisce l'infrastruttura per te e non è compatibile con modelli che hanno risorse di cartelle già esistenti infra. Per altre informazioni, vedere la pagina Generare il codice Bicep e i flussi di lavoro per la creazione di modelli .

Completare i passaggi seguenti per aggiungere nuove risorse al modello senza scrivere codice:

1. In una finestra del terminale, vai alla radice del template azd.

2. Eseguire il azd add comando per aggiungere una nuova risorsa e avviare il flusso di lavoro compose:

   azd add
   

3. Selezionare una delle risorse supportate da aggiungere all'app. Per questo esempio, selezionare 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. Per il tipo di database selezionare PostgreSQL.

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

5. Immettere un nome per la nuova risorsa, ad esempio azddb.

   ? Input the name of the app database (PostgreSQL)
   

6. Se l'app contiene servizi, azd chiede di selezionare il servizio che usa questa risorsa.

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

7. azd genera un'anteprima delle modifiche necessarie al azure.yaml file. Premere INVIO per accettare e applicare le modifiche.

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

8. Esegui il comando azd up per effettuare il provisioning delle modifiche apportate tramite il comando azd add. In questo esempio, azd viene creato un database PostgreSQL in Azure.

9. Eseguire di nuovo il azd add comando per aggiungere altre risorse, ad esempio un servizio OpenAI.

Esplorare il file azure.yaml

azure.yaml è il file di configurazione che azd usa per gestire l'app. azd gestisce i servizi e le risorse composti tramite il comando azd add usando i nodi services e resources corrispondenti. Si consideri l'esempio seguente di un azure.yaml file aggiornato interamente tramite azd add:

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"

• Il services nodo dichiara:
  • Una mappatura di distribuzione denominata webfrontend tra un'app Web .NET nella directory src e Azure Container Apps.
• Il resources nodo dichiara:
  • Un'app contenitore di Azure e un mapping delle dipendenze corrispondente denominato webfrontend tra l'app contenitore .NET ospitata e il database e il servizio di intelligenza artificiale da cui dipende. Il uses nodo esegue il mapping dell'app alle altre risorse da cui dipende.
  • Una risorsa di Database di Azure per PostgreSQL denominata azdsql.
  • Una risorsa OpenAI di Azure denominata azdchat.

Passaggi successivi

Generare codice Bicep usando la funzionalità compose