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:
- Használjon meglévő sablont az alkalmazáshoz.
- Sablon létrehozása az alkalmazáskódból
- Oktatás – sablonok létrehozása és üzembe helyezése
azd
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:
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:
Miután sablonná konvertálta ezt a mintaalkalmazást azd
, ugyanaz az alkalmazástár a következőket tartalmazza:
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 asrc
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áraazd
. - 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 template
kívánt könyvtár gyökerében:
azd init
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.