Een minimale sjabloon bouwen met behulp van de azure Developer CLI-functie voor opstellen

Met de composabiliteitsfunctie van Azure Developer CLI (azd) kunt u de Azure-resources die nodig zijn voor uw app geleidelijk samenstellen zonder bicep-code handmatig te schrijven. In dit artikel leert u hoe u met de functie opstellen kunt werken om een minimale sjabloon te maken. Ga naar het azd overzichtsartikel opstellen voor meer conceptuele informatie over deze functie.

Opmerking

De azd functie compose is momenteel in alfa en mag niet worden gebruikt in productie-apps. Wijzigingen in alfafuncties in volgende releases kunnen leiden tot ingrijpende wijzigingen. Ga naar de pagina's over azd functieversiebeheer en release-strategieën en functiefases voor meer informatie. Gebruik de knop Feedback in de rechterbovenhoek om feedback te delen over de compose functie en dit artikel.

Werken met de functie Opstellen

Toegang tot azd functies voor opstellen via de azd add opdracht. De azd add opdracht werkt met sjablonen die zijn gemaakt met behulp van de volgende azd init werkstromen:

Code gebruiken in de huidige map (voor apps die zijn gericht op Azure Container Apps voor hosting)
Een minimaal project maken

Sjablonen die zijn geïnitialiseerd via de sjabloonstroom Selecteren , worden momenteel niet ondersteund. De azd functie Opstellen beheert de infrastructuur voor u en is niet compatibel met sjablonen met bestaande infra mapassets. Ga naar het artikel Bicep-code genereren en sjabloon creatiewerkstromen voor meer informatie.

Voer de volgende stappen uit om nieuwe resources toe te voegen aan uw sjabloon zonder code te schrijven:

Navigeer in een terminalvenster naar de hoofdmap van uw azd sjabloon.
Voer het azd add commando uit om een nieuwe resource toe te voegen en de compose workflow te starten.
```
azd add
```

Selecteer een van de ondersteunde resources die u aan uw app wilt toevoegen. Voor dit voorbeeld selecteert u 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

Selecteer voor het type database de optie PostgreSQL.

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

Voer een naam in voor de nieuwe resource, zoals azddb.
```
? Input the name of the app database (PostgreSQL)
```
Als uw app services bevat, azd wordt u gevraagd de service te selecteren die deze resource gebruikt.
```
? Select the service(s) that uses this resource
> [✓]  webfrontend
```

azd genereert een voorbeeld van de vereiste wijzigingen in het azure.yaml bestand. Druk op Enter om de wijzigingen te accepteren en toe te passen.

Previewing changes to azure.yaml:

+  azddata:
+      type: db.postgres

   webfrontend:
       type: host.containerapp
       uses:
           - azddb
+          - azddata
       port: 80

Voer de azd up opdracht uit om wijzigingen in te richten die zijn aangebracht via de azd add opdracht. In dit voorbeeld azd richt u een PostgreSQL-database in Azure in.
Voer de azd add opdracht opnieuw uit om andere resources toe te voegen, zoals een OpenAI-service.

Het azure.yaml-bestand onderzoeken.

azure.yaml is het configuratiebestand dat azd wordt gebruikt om uw app te beheren. azd beheert de services en resources die zijn samengesteld via de azd add opdracht met behulp van de bijbehorende services en resources knooppunten. Bekijk het volgende voorbeeld van een azure.yaml bestand dat volledig is bijgewerkt 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"

Het services knooppunt declareert:
- Een implementatietoewijzing met de naam webfrontend tussen een .NET-web-app in de src map en Azure Container Apps.
Het resources knooppunt declareert:
- Een Azure-container-app en een overeenkomende afhankelijkheidstoewijzing met de naam webfrontend tussen de gehoste .NET-container-app en de database en AI-service die ervan afhankelijk zijn. Het uses knooppunt wijst de app toe aan de andere resources waarop deze afhankelijk is.
- Een Azure Database for PostgreSQL-resource met de naam azdsql.
- Een Azure OpenAI-resource met de naam azdchat.

Volgende stappen

Bicep-code genereren met behulp van de compose-functie

Feedback

Is deze pagina nuttig?

Last updated on 2025-04-30