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

A Azure fejlesztői parancssori felület (azd) templates használatával épít ki és helyez üzembe alkalmazáserő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örnyezetbe ágyazottan nyújt áttekintést a azd sablonok készítésének 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:

Megjegyzé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 azd konvenciók alapján. Az alábbi diagram gyors áttekintést nyújt a sablon létrehozásának azd folyamatáról:

 A Azure Developer CLI-sablon munkafolyamat.

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 Azure erőforrások létrehozásához.
  • Egy azure.yaml konfigurációs fájl lett hozzáadva, amely megfelelteti az alkalmazáskódot a src könyvtárban a kiépítési Azure erőforrásokhoz.
  • 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ás erőforrások Azure környezetben történő rendelkezésre bocsátásához és üzembe helyezéséhez. 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 annak a könyvtárnak a gyökerében, amelyet azd template kíván átalakítani.

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 a azd állványozási funkciók által támogatott gyakori Azure szolgáltatásokat szeretné használni.

Látogasson el a Start with your app code to create a template oktatóanyagra, hogy részletes információkat szerezzen arról, hogyan implementálhatja ezt a megközelítést, valamint további információkat arról, hogy mely Azure erőforrások támogatják az automatikus észlelést és sablonkészítést.

Sablon kiválasztása

Ezt a lehetőséget választva egy meglévő sablont használhat, amely kiindulópontként definiálja a Azure számos erőforrását és architekturális célját. azd A rendszer kérni fogja, hogy válasszon egy kezdősablont vagy egy másik sablont az awesome-azd fantasztikus galériábó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 tartalmazhatnak mintaalkalmazás-kódot, amelyet lecserélhet a sajátjára, míg mások, úgynevezett 'kezdősablonok', csak infrastruktúrából állnak.

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, továbbfejlesztheti azt, vagy lecserélheti a forráskód könyvtárát a sajátjára.

Az Indítás meglévő sablonnal című útmutatóban talál részleteket ennek a megközelítésnek az alkalmazásáról.

Lásd még

Segítség kérése

Ha további információt szeretne megtudni arról, hogyan nyújthat be hibát, kérhet segítséget vagy javasolhat új funkciót a Azure fejlesztői parancssori felületéhez, látogasson el a troubleshooting és támogatás oldalra.

Következő lépések