Vytvoření minimální šablony pomocí funkce vytváření v Azure Developer CLI

Funkce kompozability (compose) vazd Azure Developer CLI umožňuje postupně vytvářet prostředky Azure potřebné pro vaši aplikaci bez ručního psaní kódu Bicep. V tomto článku se dozvíte, jak pracovat s funkcí pro psaní zpráv, abyste vytvořili minimální šablonu. Prozkoumejte článek o přehledu azd komponování pro více koncepčních informací o této funkci.

Poznámka:

Funkce azd pro psaní zpráv je aktuálně alfa a neměla by se používat v produkčních aplikacích. Změny funkcí alfa v následných verzích můžou vést k zásadním změnám. Další informace najdete na stránkách správy verzí funkcí a strategie vydávání verzí a fází funkcí. Pomocí tlačítka Váš názor v pravém horním rohu můžete sdílet zpětnou vazbu o compose funkci a tomto článku.

Práce s funkcí pro psaní zpráv

Přistupujte k funkcím psaní zpráv azd prostřednictvím příkazu azd add. Příkaz azd add funguje se šablonami vytvořenými pomocí následujících azd init pracovních postupů:

• Použití kódu v aktuálním adresáři (pro aplikace, které cílí na Azure Container Apps pro hostování)
• Vytvoření minimálního projektu

Šablony inicializované prostřednictvím toku vybrat šablonu se v současné době nepodporují. Funkce azd compose spravuje infrastrukturu za vás a není kompatibilní se šablonami, které mají existující infra soubory složek. Navštivte článek Generování kódu Bicep a stránku workflows pro vytváření šablon pro více informací.

Pokud chcete do šablony přidat nové prostředky, aniž byste museli psát kód, proveďte následující kroky:

1. V okně terminálu přejděte do kořenového azd adresáře šablony.

2. Spusťte příkaz azd add pro přidání nového prostředku a spuštění komponovaného pracovního postupu.

   azd add
   

3. Vyberte jeden z podporovaných prostředků, které chcete přidat do aplikace. V tomto příkladu vyberte 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. Jako typ databáze vyberte PostgreSQL.

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

5. Zadejte název nového prostředku, například azddb.

   ? Input the name of the app database (PostgreSQL)
   

6. Pokud vaše aplikace obsahuje služby, azd vyzve vás k výběru služby, která tento prostředek používá.

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

7. azd vygeneruje náhled požadovaných změn azure.yaml souboru. Stisknutím klávesy Enter změny přijměte a použijte.

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

8. Spuštěním azd up příkazu zřiďte všechny změny provedené příkazem azd add . V tomto příkladu azd zřídí databázi PostgreSQL v Azure.

9. Spuštěním azd add příkazu znovu přidejte další prostředky, například službu OpenAI.

Prozkoumejte soubor azure.yaml

azure.yaml je konfigurační soubor, který azd používá ke správě vaší aplikace. azd spravuje služby a prostředky složené pomocí azd add příkazu pomocí odpovídajících services a resources uzlů. Podívejte se na následující příklad azure.yaml souboru, který byl zcela aktualizován prostřednictvím 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"

• Uzel services deklaruje:
  • Mapování nasazení pojmenované webfrontend mezi webovou aplikací .NET nacházející se v adresáři src a Azure Container Apps.
• Uzel resources deklaruje:
  • Aplikace kontejneru Azure a odpovídající mapování závislostí pojmenované webfrontend mezi hostovaným kontejnerovou aplikací .NET a databází a službou AI, na které závisí. Uzel uses mapuje aplikaci na ostatní prostředky, na které závisí.
  • Prostředek Azure Database pro PostgreSQL pojmenovaný azdsql.
  • Prostředek Azure OpenAI s názvem azdchat.

Další kroky

Generování kódu Bicep pomocí funkce pro psaní zpráv