Az Azure Developer CLI-sablonok áttekintése

Az Azure Developer CLI-sablonokazd rendszeres 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örnyezettudatos 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.

Ahelyett, hogy az alapoktól kezdene, a meglévő architektúrasablonok azd használatával kiépítheti és üzembe helyezheti a legtöbb erőforrást az Ön számára. 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 azd up parancsot a sablonerőforrások üzembe helyezéséhez és az Azure-ban való ü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 a azd up a módosítások kiépítéséhez.

Az Azure Developer CLI-sablonstruktúra megismerése

azd A sablonok standard kódtárak, amelyek további eszközöket is tartalmaznak. Minden azd sablon hasonló fájlstruktúrával rendelkezik a konvenciók alapján azd :

  • 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 – Konfigurációs fájl, amely leképozza a projekt forráskódmappáit 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 külön mappákban, é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á.

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

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

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.

Kezdje egy meglévő sablonnal, vagy hozzon létre egy saját sablont

A azd-sablonok használatának 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

Az azd sablon galériában elérhető egy széles választék sablonokból. 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
Statikus React webalkalmazás + függvények C# API-val és SQL adatbázissal az Azure-on 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 azd init.
  • Hozza létre a Bicep- vagy Terraform-infrastruktúrát kódfájlokként a infra mappában.
  • Frissítse a azure.yaml fájlt, hogy összekösse az alkalmazásszolgáltatásokat az Azure-erőforrásokkal.
  • Az & üzembe helyezése a azd up-gyel.

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

  • Last updated on