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

Az Azure Developer CLI-sablonok áttekintése

  • Cikk

Az Azure Developer CLI -azdsablonok olyan szabványos kódtárak, amelyek mintaalkalmazás-kódot, valamint azd konfigurációs és infrastruktúrafájlokat tartalmaznak. azd A sablonok lehetővé teszik Az Azure-erőforrások kiépítését, az alkalmazás üzembe helyezését, a CI-/CD-folyamatok konfigurálását stb. Létrehozhat saját sablonokat, vagy megkezdheti egy meglévő sablon használatát egy sablontárból, például az Awesome AZD-ből. Ebben a cikkben a következő fogalmakat ismerheti meg:

  • Hogyan azd teszik lehetővé a sablonok az alkalmazáserőforrások kiépítését és üzembe helyezését?
  • Sablonok azd strukturált felépítése
  • Annak eldöntése, hogy meglévő sablont használ-e, vagy hozzon létre egyet?
  • Meglévő azd kezdősablonok felfedezése

Miért érdemes Azure Developer CLI-sablonokat használni?

A fejlesztők gyakran szembesülnek sok időt és kihívást jelentő feladatokkal, amikor megfelelően strukturált és konfigurált környezeti alkalmazásokat építenek a felhőbe. A teamsnek számos különböző szempontot kell figyelembe vennie ezekben a környezetekben, például erőforrásokat kell létrehoznia, konfigurációkat kell alkalmaznia, monitorozást és naplózást kell beállítania, CI-/CD-folyamatokat kell létrehoznia, és egyéb feladatokat kell elvégeznie. azd A sablonok csökkentik és egyszerűsítik ezeket a feladatokat, hogy segítsenek a fejlesztőnek a helyi fejlesztéstől a sikeresen üzembe helyezett Azure-alkalmazásokig vezető úton.

Tegyük fel például, hogy egy olyan vállalatnál dolgozik, amely egy jegykezelési és ügyfélkommunikációs platformot üzemeltet, amelyhez a következő Azure-erőforrások szükségesek:

  • Két App Service-példány és egy App Service-csomag egy előtér-webalkalmazás és egy háttér API üzemeltetéséhez
  • Key Vault-példány biztonságos alkalmazáskulcsok tárolására
  • Cosmos DB-adatbázis az alkalmazásadatok végleges tárolásához
  • Azure Monitor-erőforrások, például Application Insights-irányítópultok
  • Service Bus a méretezhető üzenetkezeléshez
  • CI-/CD-folyamatok, hogy a módosítások megbízhatóan üzembe helyezhetők legyenek egy automatizált, megismételhető folyamaton keresztül.

Az alapoktól kezdve a meglévő architektúrasablonok azd használatával kiépítheti és üzembe helyezheti a legtöbb erőforrást. A fejlesztői csapat ezután az alkalmazás létrehozására és a sablonarchitektúra kisebb módosításaira összpontosíthat.

Az Azure Developer CLI-sablonok működése

Az Azure Developer CLI-sablonok olyan parancsokkal azd működnek, mint a azd init .azd up A sablonok olyan konfigurációs és IaC-fájlokat tartalmaznak, amelyeket a parancsok olyan feladatok végrehajtására használnak, mint az Azure-erőforrások kiépítése és az alkalmazáskód üzembe helyezése.

Egy meglévő sablont használó tipikus azd munkafolyamat például a következő lépéseket tartalmazza:

  1. Futtassa a azd init parancsot a --template paraméterrel egy meglévő sablon gitHubról való klónozásához.

    azd init --template todo-nodejs-mongo

  2. Futtassa a parancsot az azd auth login Azure-előfizetés hitelesítéséhez.

    azd auth login

  3. Futtassa a parancsot a azd up sablonerőforrások Azure-ban való kiépítéséhez és üzembe helyezéséhez. A azd up parancs a sablon konfigurációs és infrastrukturális (IaC) fájljait használja az Azure-erőforrások kiépítéséhez és az alkalmazás ezen erőforrásokon való üzembe helyezéséhez.

    azd up

  4. Miután beállította a környezetét az Azure-ban, helyileg módosíthatja az alkalmazásfunkciókat vagy az Azure-erőforrássablonokat, majd újra futtathatja azd up a módosításokat.

Az Azure Developer CLI-sablonstruktúra ismertetése

Minden azd sablon hasonló fájlstruktúrát használ a konvenciók alapján azd . A minimálisan szükséges eszközök általában a következőket tartalmazzák:

  • infra mappa – Az összes Bicep- vagy Terraform-infrastruktúrát tartalmazza a azd sablon kódfájljaként. azd végrehajtja ezeket a fájlokat az alkalmazás üzemeltetéséhez szükséges Azure-erőforrások létrehozásához.

  • azure.yaml fájl – Egy konfigurációs fájl, amely meghatároz egy vagy több szolgáltatást a projektben, és leképozza őket az infra üzembe helyezési mappában meghatározott Azure-erőforrásokra. Meghatározhat például egy API-szolgáltatást és egy webes előtér-szolgáltatást, és leképezheti őket különböző Azure-erőforrásokra az üzembe helyezéshez.

  • .azure mappa – Alapvető Azure-konfigurációkat és környezeti változókat tartalmaz, például az erőforrások üzembe helyezésének helyét vagy más előfizetési információkat.

  • src mappa – Az összes üzembe helyezhető alkalmazás forráskódját tartalmazza. Egyes azd sablonok kizárják a src mappát, és csak infrastruktúra-eszközöket biztosítanak, így saját alkalmazáskódot adhat hozzá.

    Feljegyzés

    A mappát kizáró src sablonok általában infrastruktúra-kezdősablonokként vannak kialakítva.

azd A sablonok opcionálisan az alábbi mappák egyikét is tartalmazzák:

  • .github mappa – A GitHub Actions, az azd alapértelmezett CI/CD-szolgáltatójának CI-/CD-munkafolyamat-fájljait tartalmazza.
  • .azdo mappa – Ha úgy dönt, hogy az Azure Pipelines for CI/CD-t használja, adja meg a munkafolyamat konfigurációs fájljait ebben a mappában.
  • .devcontainer mappa – Lehetővé teszi egy Dev Container-környezet beállítását az alkalmazáshoz.

Egy gyakori azd sablon például megfelelhet a következő mappastruktúrának:

Képernyőkép egy Azure Developer CLI-sablonstruktúráról.

Kezdje egy meglévő sablonnal, vagy hozza létre a sajátját

A sablonok használatának azd két fő megközelítése van:

  • Kezdje egy meglévő azd sablonnal.
    • Ez akkor jó választás, ha még csak most kezdi el az azd első lépéseket, vagy ha olyan sablont keres, amely hasonló architektúrával és keretrendszerekkel rendelkező új alkalmazásra épül.
  • Meglévő projekt átalakítása sablonná azd .
    • Ez akkor jó választás, ha már rendelkezik egy meglévő alkalmazással, de kompatibilissé szeretné tenni a képességekkel azd .

A következő szakaszok további információt nyújtanak a két lehetőségről.

Kezdés meglévő sablonnal

A sablonok széles választéka azd elérhető a fantasztikus azd sablongyűjteményben. Ezek a sablonok infrastruktúrát és alkalmazáskódot biztosítanak a különböző fejlesztési forgatókönyvekhez, nyelvi keretrendszerekhez és Azure-szolgáltatásokhoz. Ha olyan sablont talál, amely megfelel a helyi alkalmazásveremnek vagy a kívánt architektúrának, kiterjesztheti és lecserélheti a sablonkódot a saját

Az alábbi azd sablonok például kiindulópontot biztosítanak a gyakori alkalmazásarchitektúrákhoz és -keretrendszerekhez:

Sablon Alkalmazásgazda Technikai verem
React Web App c# API-val és MongoDB-vel az Azure-ban Azure App Service Azure Cosmos DB for NoSQL, Bicep
React Web App c# API-val és SQL Database-sel az Azure-ban Azure App Service Azure SQL Database, Bicep
Static React Web App + Functions with C# API és SQL Database on Azure Azure Static Web Apps, Azure Functions Azure SQL Database, Bicep

Új azd sablon létrehozása az alkalmazáshoz

A meglévő alkalmazásokat sablonná azd is konvertálhatja, hogy az adattárat kiépítési és üzembehelyezési képességekkel bővítse. Ez a megközelítés lehetővé teszi a legnagyobb vezérlést, és újrafelhasználható megoldást hoz létre az alkalmazás jövőbeli fejlesztési munkáihoz. A saját sablon létrehozásához szükséges magas szintű lépések a következők:

  • A projektsablon inicializálása a következővel azd init: .
  • Hozza létre a Bicep- vagy Terraform-infrastruktúrát kódfájlokként a infra mappában.
  • Frissítse a fájlt, azure.yaml hogy összekösse az alkalmazásszolgáltatásokat az Azure-erőforrásokkal.
  • Kiépítés és üzembe helyezés a azd up.

Az alábbi források további információt nyújtanak a saját sablonok létrehozásáról:

Sablonok használatának azd irányelvei

Vegye figyelembe, hogy az Azure Developer CLI-vel használt összes sablont a megfelelő tulajdonos licenceli (amely lehet, hogy nem a Microsoft) a sablont kísérő szerződés alapján. Az Ön felelőssége annak meghatározása, hogy milyen licenc vonatkozik a használni kívánt sablonra.

A Microsoft nem felelős semmilyen nem Microsoft-sablonért, és nem jeleníti meg ezeket a sablonokat biztonsági, adatvédelmi, kompatibilitási vagy teljesítményproblémák miatt. Az Azure Developer CLI-vel használt sablonokat, beleértve a Microsofttól kapott sablonokat, a Microsoft egyik támogatási programja vagy szolgáltatása sem támogatja. A Microsoft által biztosított sablonok bármilyen garancia nélkül, AS IS-ként vannak megadva.

Következő lépések

Sablon kiválasztása és üzembe helyezése