Minimális sablon létrehozása az Azure Developer CLI összeállítási funkciójával

Az Azure Developer CLI (azd) összeállítási (compose) funkciója lehetővé teszi az alkalmazáshoz szükséges Azure-erőforrások fokozatos összeállítását a Bicep-kód manuális írása nélkül. Ebből a cikkből megtudhatja, hogyan használhatja a szövegírási funkciót egy minimális sablon létrehozásához. A funkcióval kapcsolatos elméleti információkért látogasson el a azd compose áttekintési cikkére.

Megjegyzés:

A azd komponáló funkció jelenleg alfa fázisban van, ezért nem használható éles alkalmazásokban. Az alfa funkciók későbbi kiadásokban történő módosítása kompatibilitástörő változásokat eredményezhet. További információért látogasson el az azd-funkciók verziószámozási és kiadási stratégiájára , valamint a funkciószakaszokra vonatkozó oldalakra. A jobb felső sarokban található Visszajelzés gombbal megoszthatja a funkcióval és a compose jelen cikkel kapcsolatos visszajelzéseket.

A levélírási funkcióval végzett munka

A parancson keresztül hozzáférhet azd a levélírási funkciókhoz azd add . A azd add parancs a következő azd init munkafolyamatok használatával létrehozott sablonokkal működik:

• Kód használata az aktuális könyvtárban (az Azure Container Apps-et üzemeltető alkalmazásokhoz)
• Minimális projekt létrehozása

A Sablon kiválasztása folyamaton keresztül inicializált sablonok jelenleg nem támogatottak. A azd összeállítási funkció kezeli az infrastruktúrát, és nem kompatibilis a meglévő infra mappaegységekkel rendelkező sablonokkal. További információért látogasson el a Bicep-kódcikk és a sablonlétrehozás munkafolyamatainak lapjára.

Az alábbi lépések végrehajtásával új erőforrásokat adhat hozzá a sablonhoz kód írása nélkül:

1. Nyisson meg egy terminálablakot, és navigáljon a azd sablon gyökeréhez.

2. Futtassa a azd add parancsot egy új erőforrás hozzáadásához és a összeállítási munkafolyamat elindításához:

   azd add
   

3. Válassza ki az alkalmazáshoz hozzáadni kívánt támogatott erőforrások egyikét. Ebben a példában válassza a lehetőséget 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. Az adatbázis típusához válassza a lehetőséget PostgreSQL.

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

5. Adja meg az új erőforrás nevét, például azddb.

   ? Input the name of the app database (PostgreSQL)
   

6. Ha az alkalmazás tartalmaz szolgáltatásokat, azd megkéri, hogy válassza ki az erőforrást használó szolgáltatást.

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

7. azd A fájl szükséges módosításainak előnézetét azure.yaml hozza létre. A módosítások elfogadásához és alkalmazásához nyomja le az Enter billentyűt .

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

8. Futtassa a azd up parancsot a azd add parancson keresztül végrehajtott változtatások alkalmazásához. Ebben a példában azd kiépítünk egy PostgreSQL-adatbázist az Azure-ban.

9. Futtassa újra a azd add parancsot más erőforrások, például openAI-szolgáltatás hozzáadásához.

Az azure.yaml fájl felfedezése

azure.yaml az a konfigurációs fájl, amelyet azd az alkalmazás kezeléséhez használ. azd a megfelelő azd add és services csomópontokat használva kezeli a resources parancs révén összetevőként összeállított szolgáltatásokat és erőforrásokat. Tekintse meg az alábbi példát egy azure.yaml fájlra, amelyet teljes egészében azd add frissítettek.

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"

• A services csomópont a következőt deklarálja:
  • A webfrontend könyvtárban lévő .NET-webalkalmazás és az Azure Container Apps közötti, src nevű üzembe helyezési leképezés.
• A resources csomópont a következőt deklarálja:
  • Egy Azure-tárolóalkalmazás és egy webfrontend névvel rendelkező függőségi leképezés az üzemeltetett .NET-tárolóalkalmazás, valamint az adatbázis- és AI-szolgáltatás között. A uses csomópont leképozza az alkalmazást a többi erőforrásra, amelyektől függ.
  • Egy PostgreSQL Azure adatbázis erőforrás neve azdsql.
  • Egy Azure OpenAI-erőforrás neve azdchat.

Következő lépések

Bicep-kód generálása a kompozíciós funkció használatával