Azure fejlesztői parancssori felület támogatásának hozzáadása az alkalmazáshoz az alkalmazáskönyvtárban lévő kód használatával

A Azure fejlesztői parancssori felület (azdCLI) két különböző munkafolyamatot biztosít az alkalmazással használandó sablon inicializálásához, amelyek a következők:

  • Kód használata az aktuális könyvtárban: Ez a módszer elemzi az alkalmazást, és automatikusan létrehozza a támogatott infrastruktúrát és konfigurációs erőforrásokat.
  • Sablon kiválasztása: Ezzel a módszerrel integrálhat egy meglévő sablont az alkalmazással, vagy használhat egy meglévő sablont egy új alkalmazás kiindulópontjaként.

Mindkét megközelítést a Create Azure Developer CLI templates overview dokumentum ismerteti.

Ebből a cikkből megtudhatja, hogyan adhat Azure Developer CLI-támogatást az alkalmazásához a azd módszerrel (). Az alternatív megközelítéssel kapcsolatos további információkért tekintse meg a Támogatás hozzáadása az alkalmazáshoz egy meglévő sablon használatávalazd című dokumentumot. A sablonok készítéséről azd további információt a talál.

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

  1. A következő lépéseket saját projektje segítségével követheti. Ha azonban szeretne követni egy mintaalkalmazást, klónozza a következő kezdő adattárat egy üres könyvtárba a számítógépen:

    git clone https://github.com/Azure-Samples/msdocs-python-flask-webapp-quickstart

  2. Nyisson meg egy terminált a projekt gyökérkönyvtárához.

  3. Futtassa a azd init parancsot a sablon inicializálásához.

    azd init

  4. Amikor a rendszer kéri, válassza a Kód használata az aktuális könyvtárban lehetőséget. azd elemzi a projektet, és összefoglalót nyújt az észlelt szolgáltatásokról és az ajánlott Azure-beli üzemeltetési erőforrásokról.

  5. Válassza a Megerősítés és a saját alkalmazásom inicializálásának folytatása lehetőséget. azd A projekt gyökérkönyvtárában a következő objektumokat hozza létre:

    • Megfelelő azure.yaml szolgáltatásdefiníciókkal rendelkező fájl.
    • Egy infra mappa, amely a projekt Azure-ba történő kiépítéséhez és telepítéséhez szükséges infrastruktúra mint kód fájlokat tartalmazza.
    • Egy .azure fájlban .env beállított környezeti változókat tartalmazó mappa.

    Erről az észlelési és létrehozási folyamatról a cikk későbbi részében olvashat bővebben.

  6. A létrehozott fájlok változtatás nélkül működnek a megadott mintaalkalmazással, és az Ön saját alkalmazásaival is működhetnek. Szükség esetén a létrehozott fájlok az igényeinek megfelelően módosíthatók. Előfordulhat például, hogy tovább kell módosítania a mappában lévő infra infrastruktúra-kódfájlokat, ha az alkalmazás Azure erőforrásokra támaszkodik az általuk azdazonosítottakon túl.

  7. Futtassa a(z) azd up parancsot az alkalmazás Azure-ban való kiépítéséhez és üzembe helyezéséhez.

    azd up

  8. Amikor a rendszer kéri, válassza ki a kívánt előfizetést és helyet a kiépítési és üzembe helyezési folyamat megkezdéséhez.

  9. Ha a folyamat befejeződött, kattintson a kimenetben található azd hivatkozásra az alkalmazás böngészőben való megnyitásához.

Az inicializálás lépéseinek megismerése

Amikor kiválasztja a Kód használata lehetőséget az aktuális címtár-munkafolyamatban , a azd init parancs elemzi a projektet, és automatikusan létrehozza a kódot a felderített adatok alapján. Az alábbi szakaszok ismertetik a folyamat működésének és a jelenleg támogatott technológiáknak a részleteit.

Detektálás

A azd init parancs észleli a projektkönyvtárban és alkönyvtárakban található támogatott nyelvek projektfájljait. azd A csomagfüggőségeket is megvizsgálja, hogy információkat gyűjtsön az alkalmazás által használt webes keretrendszerekről vagy adatbázisokról. Szükség esetén manuálisan is hozzáadhatja vagy szerkesztheti az észlelt összetevőket a megerősítést kérő összefoglaló üzenetben leírtak szerint.

Az aktuális észlelési logika a következő:

  • Támogatott nyelvek:
    • Python
    • JavaScript/TypeScript
    • .NET
    • Java
  • Támogatott adatbázisok:
    • MongoDB
    • PostgreSQL
  • A Python és a JavaScript/TypeScript esetében a rendszer automatikusan észleli a webes keretrendszereket és adatbázisokat.
  • Ha egy JavaScript/TypeScript-projekt előtérbeli (vagy ügyféloldali) webes keretrendszert használ, az előtér-szolgáltatásként van besorolva. Ha a szolgáltatás egy jelenleg nem észlelt előtér-webes keretrendszert használ, a JQuery kiválasztásával egyenértékű előtér-szolgáltatásbesorolást és -viselkedést biztosíthat.

Generation

Miután megerősítette az észlelt összetevőket, azd init létrehozza az alkalmazás Azure való üzembe helyezéséhez szükséges infrastruktúra-kódfájlokat.

A létrehozási logika a következő:

  • Támogatott gazdagépek:
    • Azure Container Apps.
  • Adatbázisok esetében az adatbázis-technológia és a használt szolgáltatás közötti támogatott leképezés:
    • MongoDB: Azure CosmosDB API a MongoDB-hez
    • PostgreSQL: Azure Database for PostgreSQL rugalmas kiszolgáló
    • Redis: Azure Container Apps Redis bővítmény
  • Az adatbázisokat használó szolgáltatások környezeti változókkal rendelkeznek, amelyek alapértelmezés szerint előre konfigurált kapcsolatot biztosítanak az adatbázissal.
  • Az előtér- és háttérszolgáltatások észlelésekor a háttérszolgáltatásokhoz tartozó Azure gazdagép CORS-konfigurációja frissül, hogy engedélyezve legyen az előtér-szolgáltatások alapértelmezett üzemeltetési tartománya. Ez szükség szerint módosítható vagy eltávolítható az infrastruktúra kódkonfigurációs fájljaiban.

Fejlesztői tárolók támogatásának hozzáadása

A sablont a fejlesztői tárolókkal és a Codespace-ekkel is kompatibilissé teheti. A fejlesztői tárolók lehetővé teszik a tárolók teljes körű fejlesztési környezetként való használatát. Alkalmazás futtatására, a kódbázis használatához szükséges eszközök, kódtárak és futtatókörnyezetek elkülönítésére, valamint a folyamatos integráció és tesztelés elősegítésére használható. A fejlesztői tárolók helyileg vagy távolról is futtathatók privát vagy nyilvános felhőben. (Forrás: https://containers.dev/)

Fejlesztői tárolók támogatásának hozzáadása:

  1. Hozzon létre egy .devcontainer mappát a projekt gyökerénél.

  2. Hozzon létre egy devcontainer.json fájlt a .devcontainer mappában a kívánt konfigurációkkal. A azd kezdősablon egy mintafájlt devcontainer.json biztosít, amelyet átmásolhat a projektbe, és szükség szerint módosíthatja azt.

További információ a fejlesztői tárolókról a Visual Studio Code dokumentációjában.

CI/CD folyamat támogatásának hozzáadása

A következő lépésekkel GitHub Actions vagy Azure DevOps használatával CI/CD-támogatást is hozzáadhat a sablonhoz:

  1. Vegyen fel egy .github mappát GitHub műveletekhez, vagy adjon hozzá egy .ado mappát Azure DevOps a projekt gyökeréhez.

  2. Vegyen fel egy munkafolyamat-fájlt az új mappába. A azd kezdősablon egy minta GitHub Actions munkafolyamatfájlt és minta Azure DevOps Pipelines-fájlt biztosít minden platformhoz. Ezeket a fájlokat átmásolhatja a projektbe, és szükség szerint módosíthatja őket.

  3. Előfordulhat, hogy frissítenie kell a main.parameters.json mappában lévő infra fájlt a munkafolyamat futtatásához szükséges környezeti változókkal.

  • Last updated on