Megosztás a következőn keresztül:


Azure Developer CLI-sablonok létrehozása – áttekintés

Az Azure Developer CLI (azd) sablonokkal épít ki és helyez üzembe alkalmazás-erőforrásokat a felhőben. A fejlesztők az alkalmazások sablonokká alakításával adhatnak támogatást a azd parancsokhoz és szolgáltatásokhoz. Ez a cikk környezetfüggő áttekintést nyújt a sablonok készítésének azd különböző lehetőségeiről. A cikkben szereplő fogalmak megismerése után a következő forrásokban talál részletesebb megvalósítási útmutatókat:

Feljegyzés

Ez a cikk feltételezi a sablonok általános megértését azd . A sablonokkal kapcsolatos további információkért látogasson el a sablon áttekintési dokumentumára.

Sablonkészítési fogalmak

A sablon létrehozásához azd adott konfigurációs és infrastruktúra-eszközöket kell hozzáadni a meglévő kódbázishoz, vagy új alkalmazást kell elindítani egy meglévő sablonból ugyanezekkel az eszközökvel. Mindkét munkafolyamatot a későbbi szakaszokban ismertetjük. Minden azd sablon hasonló fájlstruktúrát használ a konvenciók alapján azd . Az alábbi diagram gyors áttekintést nyújt a sablon létrehozásának azd folyamatáról:

Az Azure Developer CLI-sablon munkafolyamatának diagramja.

Minden azd sablonhoz a következő minimális erőforrások szükségesek:

  • Egy infra mappa, amely kódfájlként (Bicep vagy Terraform) tárolja az infrastruktúrát.
  • Egy azure.yaml konfigurációs fájl, amely leképozza az alkalmazásszolgáltatásokat a kiépített infrastruktúra-erőforrásokhoz.

A ci/CD-folyamat létrehozásához gyakran más opcionális könyvtárakat is tartalmaz, például egy .github objektumokat tartalmazó mappát. A sablonokkal kapcsolatos további információkért látogasson el a sablon áttekintési dokumentumára.

Fontolja meg a következő mintaalkalmazás-adattárat:

Képernyőkép a mintaalkalmazás szerkezetéről.

Miután sablonná konvertálta ezt a mintaalkalmazást azd , ugyanaz az alkalmazástár a következőket tartalmazza:

Képernyőkép az azd-sablon kész szerkezetéről.

Az eredeti alkalmazáserőforrások változatlanok, de olyan új eszközök lettek hozzáadva, amelyek azd a következő parancsoktól függenek azd up:

  • Hozzáadtunk egy infra mappát, amely Bicep-fájlokat tartalmaz az Azure-erőforrások létrehozásához.
  • Hozzá lett adva egy azure.yaml konfigurációs fájl, amely megfelelteti a src címtárban lévő alkalmazáskódot a kiépítési Azure-erőforrásoknak.
  • Létrehoztunk egy .azure mappát a környezeti változók tárolására azd .
  • Egy .github mappa (nem kötelező) lett hozzáadva a CI/CD-folyamatok GitHub-műveleteken keresztüli támogatásához.

Sablonlétrehozás munkafolyamatai

A azd init parancs egy azd sablon inicializálására szolgál az alkalmazáserőforrások üzembe helyezéséhez és üzembe helyezéséhez az Azure-ban. A parancssor két különböző munkafolyamat közül választva inicializálja a következő szakaszokban ismertetett sablonokat – Kód használata az aktuális könyvtárban és Meglévő sablon használata.

Futtassa a azd init parancsot az átalakítani azd templatekívánt könyvtár gyökerében:

azd init

Képernyőkép a sablon inicializálási folyamatról.

Kód használata az aktuális könyvtárban

Ez a beállítás arra utasítja azd , hogy elemezze a címtárban lévő kódot, hogy azonosítsa az általa használt technológiákat, például a programozási nyelvet, a keretrendszert és az adatbázisrendszert. azd automatikusan létrehozza a sablonelemeket, például a azure.yaml szolgáltatásdefiníciós fájlt és a infra kódként használt infrastruktúrafájlokat tartalmazó mappát. A létrehozott eszközök a további módosítások kiindulópontjai. Ezt a módszert akkor használja, ha az állványzati funkciók által azd támogatott gyakori Azure-szolgáltatásokat szeretné használni.

A Start with your app code webhelyen sablon-oktatóanyagot hozhat létre a megközelítés implementálásának részleteiről, és további információt arról, hogy az Azure-erőforrások mely erőforrások támogatják az automatikus észlelést és az állványzatkészítést.

Sablon választása

Ezt a lehetőséget választva egy meglévő sablont használhat, amely kiindulópontként számos Azure-erőforrást és architekturális célt határoz meg. azd A rendszer kérni fogja, hogy válasszon egy kezdősablont vagy egy másik sablont a fantasztikus azd katalógusból. Amikor kiválaszt egy sablont, a rendszer hozzáadja a sablon eszközeit a meglévő projektkönyvtárhoz, hogy kiindulási pontként használhassa. Egyes sablonok mintaalkalmazás-kódot tartalmaznak, amelyeket lecserélhet a sajátjaira, míg egyes (kezdősablonoknak nevezett) csak infrastruktúra.

azd init A parancs segítségével lekérhet egy meglévő sablont egy üres könyvtárba, és kiindulási pontként használhatja a saját alkalmazásához. Ha a sablon alkalmazás-forráskódot tartalmaz, létrehozhatja a kódot, vagy lecserélheti a forráskód könyvtárát a sajátjára.

A megközelítés implementálásával kapcsolatos részletekért tekintse meg a start with a existing template tutorial(Start with a existing template tutorial) című témakört.

Lásd még

Segítség kérése

Ha tudni szeretné, hogyan nyújthat be hibát, kérhet segítséget, vagy javasolhat új funkciót az Azure Developer CLI-hez, látogasson el a hibaelhárítási és támogatási oldalra.

Következő lépések