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

Azure Developer CLI-támogatás hozzáadása az alkalmazáshoz az alkalmazáskönyvtárban lévő kód használatával

  • Cikk

Az Azure Developer CLI (azd) két különböző munkafolyamatot biztosít az alkalmazáshoz 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 módszert az Azure Developer CLI-sablonok létrehozása áttekintő dokumentum ismerteti.

Ebből a cikkből megtudhatja, hogyan adhat támogatást az Azure Developer CLI (azd) alkalmazásához az aktuális címtárhasználati módszer kódjának használatával. Az alternatív megközelítéssel kapcsolatos további információkért látogasson el az Alkalmazás támogatásának hozzáadása azd meglévő sablontitkot használva. A sablonok készítéséről azd további információt a Betanítás – sablonok létrehozása és üzembe helyezése azd című témakörben 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 összefoglalja az észlelt szolgáltatásokat és a javasolt Azure-üzemeltetési erőforrásokat.

  5. Válassza a Megerősítés és az alkalmazás inicializálá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.
    • A infra projekt üzembe helyezéséhez és az Azure-ban való üzembe helyezéséhez szükséges infrastruktúra-kódfájlokat tartalmazó mappa.
    • 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 a megadott mintaalkalmazáshoz hasonlóan működnek, és a saját alkalmazásaihoz is használhatók. 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 az azure-erőforrásokra támaszkodik az általuk azdazonosítottakon túl.

  7. Futtassa a parancsot az azd up alkalmazás üzembe helyezéséhez és üzembe helyezéséhez az Azure-ban.

    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.

Észlelé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
  • Python és JavaScript/TypeScript esetén 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.

Generáció

Miután megerősítette az észlelt összetevőket, azd init létrehozza az alkalmazás Azure-ban 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: Rugalmas Azure Database for PostgreSQL-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 az Azure-gazdagép háttérszolgáltatásokhoz készült CORS-konfigurációja frissül, hogy engedélyezve legyen az előtérbeli 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 ci/CD támogatását a sablonban a GitHub-műveletek vagy az Azure DevOps használatával is hozzáadhatja a következő lépések végrehajtásával:

  1. Adjon hozzá egy .github mappát a GitHub-műveletekhez vagy egy .ado Azure DevOps-mappát a projekt gyökeréhez.

  2. Vegyen fel egy munkafolyamat-fájlt az új mappába. A azd kezdősablon egy GitHub Actions-mintafájlt és Azure DevOps Pipelines-mintafájlt biztosít minden olyan platformhoz, amelyet átmásolhat 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.