Créer un modèle minimal à l’aide de la fonctionnalité de composition de l’interface de ligne de commande Azure Developer

La fonctionnalité cli pour développeurs Azure () (azdcomposer) vous permet de composer progressivement les ressources Azure requises pour votre application sans écrire manuellement du code Bicep. Dans cet article, vous allez apprendre à utiliser la fonctionnalité de composition pour créer un modèle minimal. Consultez l’article Vue d’ensemble de laazd composition pour plus d’informations conceptuelles sur cette fonctionnalité.

Remarque

La azd fonctionnalité de composition est actuellement en alpha et ne doit pas être utilisée dans les applications de production. Les modifications apportées aux fonctionnalités alpha dans les versions suivantes peuvent entraîner des changements majeurs. Pour plus d’informations, consultez les pages de version et de mise en production des fonctionnalités et de version azd. Utilisez le bouton Commentaires en haut à droite pour partager des commentaires sur la compose fonctionnalité et cet article.

Utiliser la fonction de composition

Accédez aux azd fonctionnalités de composition via la azd add commande. La azd add commande fonctionne avec des modèles créés à l’aide des flux de travail suivants azd init :

• Utiliser du code dans le répertoire actuel (pour les applications qui ciblent Azure Container Apps pour l’hébergement)
• Créer un projet minimal

Les modèles initialisés via le flux Sélectionner un modèle ne sont actuellement pas pris en charge. La azd fonctionnalité de composition gère l’infrastructure pour vous et n’est pas compatible avec les modèles qui ont des ressources de dossier existantes infra . Pour plus d’informations, consultez la page Générer le code Bicep et les flux de travail de création de modèle .

Procédez comme suit pour ajouter de nouvelles ressources à votre modèle sans écrire de code :

1. Dans une fenêtre de terminal, accédez à la racine de votre azd modèle.

2. Exécutez la azd add commande pour ajouter une nouvelle ressource et démarrer le flux de travail de composition :

   azd add
   

3. Sélectionnez l’une des ressources prises en charge à ajouter à votre application. Pour cet exemple, sélectionnez 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. Pour le type de base de données, sélectionnez PostgreSQL.

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

5. Entrez un nom pour la nouvelle ressource, par exemple azddb.

   ? Input the name of the app database (PostgreSQL)
   

6. Si votre application contient des services, azd vous invite à sélectionner le service qui utilise cette ressource.

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

7. azd génère un aperçu des modifications requises apportées au azure.yaml fichier. Appuyez sur Entrée pour accepter et appliquer les modifications.

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

8. Exécutez la azd up commande pour provisionner les modifications apportées par le biais de la azd add commande. Dans cet exemple, azd provisionne une base de données PostgreSQL dans Azure.

9. Exécutez à nouveau la azd add commande pour ajouter d’autres ressources, telles qu’un service OpenAI.

Explorer le fichier azure.yaml

azure.yaml est le fichier de configuration utilisé azd pour gérer votre application. azdGère les services et les ressources composés à l’aide de la azd add commande à l’aide des nœuds et services correspondantsresources. Prenons l’exemple suivant d’un azure.yaml fichier entièrement mis à jour via 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"

• Le services nœud déclare :
  • Mappage de déploiement nommé webfrontend entre une application web .NET dans l’annuaire src et Azure Container Apps.
• Le resources nœud déclare :
  • Une application conteneur Azure et un mappage de dépendances correspondant nommé webfrontend entre l’application conteneur .NET hébergée et le service de base de données et d’IA dont elle dépend. Le uses nœud mappe l’application aux autres ressources dont elle dépend.
  • Une ressource Azure Database pour PostgreSQL nommée azdsql.
  • Une ressource Azure OpenAI nommée azdchat.

Étapes suivantes

Générer du code Bicep à l’aide de la fonction compose