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


Rövid útmutató: Python-webalkalmazás létrehozása és üzembe helyezése Azure azd-sablon használatával

Ez a rövid útmutató végigvezeti a Python webes és adatbázismegoldások Azure való létrehozásának és üzembe helyezésének legegyszerűbb és leggyorsabb módján. A rövid útmutató utasításait követve a következőket érheti el:

  • Válasszon egy azd sablont a Python webes keretrendszer, Azure adatbázisplatform és Azure web hosting platform alapján, amelyre építeni szeretne.
  • Cli-parancsokkal futtathat egy azd-sablont egy minta webalkalmazás és adatbázis létrehozásához, valamint a szükséges Azure erőforrások létrehozásához és konfigurálásához. Ezután helyezze üzembe a minta webalkalmazást a Azure.
  • Szerkessze a webalkalmazást a helyi számítógépen, és használjon egy azd parancsot az újbóli üzembe helyezéshez.
  • Egy azd paranccsal törölheti Azure erőforrásokat.

Az oktatóanyag elvégzése kevesebb, mint 15 percet vesz igénybe. Ha végzett, megkezdheti az új projekt módosítását az egyéni kóddal.

Ha többet szeretne megtudni ezekről a azd sablonokról Python webalkalmazás-fejlesztéshez, tekintse meg a következőt:

Előfeltételek

Egy Azure-előfizetés – A előfizetés létrehozása ingyenesen

Telepítse a következő eszközöket a helyi számítógépre:

Válasszon sablont

Válasszon egy azd sablont a Python webes keretrendszer, Azure web hosting platform és Azure adatbázisplatform alapján.

  1. Válasszon egy sablonnevet (első oszlopot) az alábbi táblák sablonlistájából. Használja a sablon nevét a azd init következő szakaszban található lépés során.

    Sablon Webes keretrendszer Adatbázis Üzemeltetési platform GitHub adattár
    azure-django-postgres-flexible-aca Django Rugalmas PostgreSQL-kiszolgáló Azure Container Apps repo
    azure-django-postgres-rugalmas-alkalmazásszolgáltatás Django Rugalmas PostgreSQL-kiszolgáló Azure App Service repo
    azure-django-cosmos-postgres-aca Django Cosmos DB (PostgreSQL-adapter) Azure Container Apps repo
    Azure Django Cosmos Postgres AppService Django Cosmos DB (PostgreSQL-adapter) Azure App Service repo
    azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL bővítmény Azure Container Apps repo

A sablon futtatása

A azd sablonok futtatása azonos a nyelvek és keretrendszerek között. Ugyanezek az alapvető lépések vonatkoznak az összes sablonra. A lépések a következők:

  1. A terminálon keresse meg a helyi számítógép egyik mappáját, ahol általában a helyi Git-adattárakat tárolja. Hozzon létre egy új, azdtest nevű mappát. Ezután váltson a könyvtárra a cd parancs használatával.

    mkdir azdtest
    cd azdtest
    

    Ehhez a rövid útmutatóhoz ne használja Visual Studio Code terminálját.

  2. A helyi fejlesztési környezet beállításához írja be a következő parancsokat a terminálba, és válaszoljon az esetleges kérdésekre:

    azd init --template <template name>
    

    Helyettesítse be <template name> az előző lépésben kiválasztott táblák egyik sablonját, például az azure-django-postgres-aca-t .

    Amikor a rendszer környezeti nevet kér, használja az azdtest vagy bármely más nevet. A környezet neve Azure erőforráscsoportok és erőforrások elnevezésekor használatos. A legjobb eredmény érdekében használjon rövid nevet, kisbetűket, és ne használjon speciális karaktereket.

  3. Ha hitelesíteni szeretné azd Azure fiókjában, írja be a következő parancsokat a terminálba, és kövesse a következő utasításokat:

    azd auth login
    

    Kövesse az utasításokat, amikor a rendszer a "Fiók kiválasztása" vagy a Azure-fiókba való bejelentkezést kéri. A sikeres hitelesítés után a következő üzenet jelenik meg egy weblapon: "A hitelesítés befejeződött. Visszatérhet az alkalmazáshoz. Nyugodtan zárja be ezt a böngészőlapot."

    A lap bezárásakor a rendszerhéj megjeleníti az üzenetet:

    Logged in to Azure.
    
  4. A következő lépés megkísérlése előtt győződjön meg arról, hogy a Docker Desktop nyitva van és fut a háttérben.

  5. A szükséges Azure erőforrások létrehozásához írja be a következő parancsokat a terminálba, és válaszoljon az esetleges kérdésekre:

    azd up
    

    Fontos

    A azd up sikeres befejezését követően a minta webalkalmazás elérhető a nyilvános interneten, és a Azure-előfizetés megkezdi az összes létrehozott erőforrás díjának felszámítását. A sablonok létrehozói azd szándékosan olcsó, de nem feltétlenül ingyenes szinteket választottak, mivel az ingyenes szintek gyakran korlátozott rendelkezésre állásúak.

    Kövesse az utasításokat, amikor a rendszer arra kéri, hogy válassza ki Azure előfizetést a fizetéshez, majd válassza ki a használni kívánt Azure helyet. Válasszon egy földrajzilag Önhöz közel álló régiót.

    A azd up végrehajtása több percet is igénybe vehet, mivel több Azure szolgáltatást épít ki és helyez üzembe. A folyamat előrehaladása közben figyelje a hibákat. Ha hibaüzenetet lát, próbálja meg az alábbiakat a probléma megoldásához:

    • Törölje az azd-quickstart mappát és a rövid útmutató utasításait az elejétől kezdve.
    • Amikor a rendszer kéri, válasszon egy egyszerűbb nevet a környezetnek. Csak kisbetűket és kötőjeleket használjon. Nincsenek számok, nagybetűk vagy speciális karakterek.
    • Válasszon másik helyet.

    Ha továbbra is problémákat tapasztal, tekintse meg a dokumentum alján található Hibaelhárítás szakaszt.

    Fontos

    Ha végzett a minta webalkalmazás használatával, használja a azd down a azd up által létrehozott összes szolgáltatás eltávolításához.

  6. Ha azd up sikeresen befejeződött, a következő kimenet jelenik meg:

    Az azd parancssori felület sikeres kimenetének képernyőképe, amelyen a végpont URL-je is látható, hogy megtekintse a működő Relecloud alkalmazást, ami az Azure-ban van üzembe helyezve.

    Másolja ki az első URL-címet a - Endpoint: szó után, és illessze be egy webböngésző helysávjába, hogy láthassa a Azure élőben futó webalkalmazás-mintaprojektet.

  7. Nyisson meg egy új lapot a webböngészőben.

    1. Másolja ki a második URL-címet az előző lépésből, és illessze be a helysávba.
    2. A Azure portál megjeleníti az új erőforráscsoport összes olyan szolgáltatását, amely a minta webalkalmazás-projekt üzemeltetésére van üzembe helyezve.

Szerkesztés és ismételt üzembe helyezés

Ezután módosítsa a webalkalmazást, majd telepítse újra.

  1. Nyissa meg Visual Studio Code, és nyissa meg a azdtest mappát.

  2. Ez a sablon a Dev Containers opcionális használatára van konfigurálva. Amikor megjelenik a Dev Container értesítés a Visual Studio Code, válassza a Reopen in Container gombot.

  3. A Visual Studio Code Explorer nézetével lépjen src/templates mappába, és nyissa meg a index.html fájlt. Keresse meg a következő kódsort:

    <h1 id="pagte-title">Welcome to ReleCloud</h1>
    

    A H1 szövegének módosítása:

    <h1 id="pagte-title">Welcome to ReleCloud - UPDATED</h1>
    

    Mentse a módosításokat.

  4. Az alkalmazás újbóli üzembe helyezéséhez a változtatásoddal futtasd a következő parancsot a terminálban:

    azd deploy
    

    Mivel Dev Containerst használ, és távolról csatlakozik a tároló felületéhez, ne használja Visual Studio Code terminálpaneljét azd parancsok futtatásához.

  5. Amikor a parancs befejeződik, frissítse a webböngészőt a frissítés megtekintéséhez. A használt webes üzemeltetési platformtól függően eltarthat néhány percig, amíg a módosítások megjelennek.

    Most már készen áll a sablonban lévő fájlok szerkesztésére és törlésére. További információ: Mit szerkeszthetek vagy törölhetek a sablonban?

Erőforrások tisztítása

  1. Törölje a sablon által létrehozott erőforrásokat a azd down parancs futtatásával.

    azd down
    

    A azd down parancs törli a Azure erőforrásokat és a GitHub Actions munkafolyamatot. Amikor a rendszer kéri, fogadja el, hogy törli az erőforráscsoporthoz társított összes erőforrást.

    A projekt fájljainak módosításával törölheti az azdtest mappát, vagy használhatja azt saját alkalmazásának alapjaként.

Hibaelhárítás

Ha hibaüzenetek jelennek meg a folyamat során azd up, próbálkozzon a következő lépésekkel:

  • Futtassa a azd down parancsot az általa létrehozott erőforrások eltávolításához. Másik lehetőségként törölheti a Azure portálon létrehozott erőforráscsoportot.
  • Törölje az azdtest mappát a helyi számítógépen.
  • A Azure portálon keresse meg a Key Vaultokat. Válassza a Törölt tárolók kezelése lehetőséget, válassza ki az előfizetését, válassza ki az összes olyan kulcstartót, amely tartalmazza az azdtest nevet vagy bármit, amit a környezetének elnevezett, majd válassza a Törlés lehetőséget.
  • Próbálkozzon újra a rövid útmutató lépéseivel. Amikor a rendszer kéri, válasszon egyszerűbb nevet a környezetéhez. Próbáljon ki rövid nevet, kisbetűket, számok, nagybetűk és speciális karakterek nélkül.
  • A rövid útmutató lépéseinek újrapróbálkozásakor válasszon egy másik helyet.

A lehetséges problémák és megoldások átfogóbb listáját a gyakori kérdések között találja.