Rövid útmutató: Python-webalkalmazás létrehozása és üzembe helyezése a GitHub Codespaces-ből az Azure-ra egy Azure Developer CLI-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 Azure fejlesztői cli (azd) sablont a Python webes keretrendszer, Azure adatbázisplatform és Azure építeni kívánt web hosting platform alapján.
  • Hozzon létre egy új GitHub kódteret, amely a kiválasztott azd sablonból létrehozott kódot tartalmazza.
  • Használja GitHub Codespace-eket és az online Visual Studio Code Bash-terminálját. A terminál lehetővé teszi, hogy Azure fejlesztői parancssori felület parancsaival azd sablont futtathasson 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, majd a minta webalkalmazás üzembe helyezéséhez Azure.
  • Szerkessze a webalkalmazást egy GitHub Codespace-ben, és használjon egy azd parancsot az újbóli üzembe helyezéshez.
  • Egy azd paranccsal törölheti Azure erőforrásokat.
  • Zárja be és nyissa meg újra a GitHub Codespace-t.
  • Tegye közzé az új kódot egy GitHub-adattárban.

Az oktatóanyag elvégzése kevesebb, mint 25 percet vesz igénybe. A befejezés után 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

Fontos

A GitHub Codespaces és a Azure is fizetős előfizetés-alapú szolgáltatások. Néhány ingyenes kikötés után előfordulhat, hogy a szolgáltatások használatáért díjat számítunk fel. Ennek a gyorsútmutatónak a követése hatással lehet ezekre a kiosztásokra vagy a számlázásra. Ha lehetséges, a sablonok a azd legkevésbé költséges beállítási szintet használják, néhány azonban nem feltétlenül ingyenes. A költségek jobb megértéséhez használja a Azure tarifakalkulátort. További információ: GitHub Codespaces díjszabása.

Sablon kiválasztása és kódtér létrehozása

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

  1. Az alábbi sablonok listájából válasszon egyet, amely az új webalkalmazásban használni kívánt technológiákat használja.

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

  1. Az ön kényelme érdekében az egyes táblák utolsó oszlopa tartalmaz egy hivatkozást, amely létrehoz egy új Codespace-t, és inicializálja a azd sablont a GitHub-fiókban. Kattintson a jobb gombbal a kiválasztott sablonnév melletti Új kódtér hivatkozásra, és válassza a Megnyitás új lapon lehetőséget a beállítási folyamat elindításához.

    A folyamat során előfordulhat, hogy a rendszer arra kéri, hogy jelentkezzen be a GitHub fiókjába. A rendszer azt is kéri, hogy erősítse meg, hogy létre szeretné hozni a Codespace-t. Kattintson a Kódtér létrehozása gombra a Kódtér beállítása lap megjelenítéséhez.

  2. Néhány perc múlva a Visual Studio Code webalapú verziója betöltődik egy új böngészőlapra, amelyen a Python websablon betöltődik munkaterületként az Explorer nézetben.

Hitelesítés Azure és az azd-sablon üzembe helyezése

Most, hogy már rendelkezik az újonnan létrehozott kódot tartalmazó GitHub Codespace-vel, használja a azd segédprogramot a Codespace-ben, hogy közzétegye a kódot Azure.

  1. A webes Visual Studio Code-ban a terminál alapértelmezés szerint meg van nyitva. Ha nem, a tilde ~ kulccsal nyissa meg a terminált. Alapértelmezés szerint a terminál egy bash terminál. Ha nem, váltson bash-re a terminál ablakának jobb felső sarkában.

  2. A bash terminálban adja meg a következő parancsot:

    azd auth login

    azd auth login megkezdi a Codespace hitelesítését a Azure-fiókjába.

    Start by copying the next code: XXXXXXXXX
Then press enter and continue to log in from your browser...

Waiting for you to complete authentication in the browser...

  3. Kövesse az alábbi utasításokat:

    • Létrehozott kód másolása
    • Új böngészőlap megnyitásához és a kód szövegdobozba való beillesztéséhez az Enter billentyűt választva
    • A Azure-fiók kiválasztása listából
    • Annak megerősítése, hogy be szeretne jelentkezni a Microsoft Azure CLI

  4. Sikeresség esetén a következő üzenet jelenik meg a terminál Codespaces lapján:

    Device code authentication completed.
Logged in to Azure.

  5. Helyezze üzembe az új alkalmazást a Azure a következő paranccsal:

    azd up

    A folyamat során a rendszer a következőt kéri:

    • Adjon meg egy új környezetnevet
    • Válasszon egy Azure előfizetést [Nyilakkal mozoghat, írással szűrhet]
    • Válassza ki az Azure használni kívánt helyszínt: [Nyilakkal mozgasson, írjon a szűréshez]

    Miután megválaszolta ezeket a kérdéseket, a kimenet azd azt jelzi, hogy az üzembe helyezés folyamatban van.

    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. 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.

    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 hibákat lát, tekintse meg a dokumentum alján található Hibaelhárítás szakaszt.

  6. Ha azd up sikeresen befejeződött, hasonló kimenet jelenik meg:

    (✓) Done: Deploying service web
- Endpoint: https://xxxxx-xxxxxxxxxxxxx-ca.example-xxxxxxxx.westus.azurecontainerapps.io/

SUCCESS: Your application was provisioned and deployed to Azure in 11 minutes 44 seconds.
You can view the resources created under the resource group xxxxx-rg in Azure portal:
https://portal.azure.com/#@/resource/subscriptions/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/resourceGroups/xxxxx-rg/overview

    Ha egy alapértelmezett képernyő vagy hibaképernyő jelenik meg, előfordulhat, hogy az alkalmazás elindul. Várjon 5–10 percet, és ellenőrizze, hogy a probléma megoldódott-e a hibaelhárítás előtt.

    1. Ctrl + kattintson az első URL-címre a - Endpoint: szó után a Azure élőben futó minta webalkalmazás-projekt megtekintéséhez.

  7. Ctrl + kattintson az előző lépés második URL-címére a kiépített erőforrások megtekintéséhez a Azure portálon.

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

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

  1. Lépjen vissza a Visual Studio Code tartalmazó böngészőlapra. A Visual Studio Code Explorer nézetével lépjen a src/templates mappába. Nyissa meg a index.html fájlt. Keresse meg a következő kódsort:

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

    Módosítsa a H1 szövegét:

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

    A kód mentésre kerül, miközben gépelsz.

  2. Ha újra szeretné üzembe helyezni az alkalmazást a módosítással, futtassa a következő parancsot a terminálban:

    azd deploy

  3. Amikor a parancs befejeződik, frissítse a böngészőlapot a ReleCloud webhelyre 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

Törölje a sablon által létrehozott erőforrásokat az 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.

Nem kötelező: A kódtér megkeresése

Ez a szakasz bemutatja, hogyan fut a kód ideiglenesen, és hogyan őrizhető meg rövid távon a Codespace-ben. Ha folytatni szeretné a kódot, tegye közzé a kódot egy új adattárban.

  1. Zárja be a rövid útmutatóval kapcsolatos összes lapot, vagy állítsa le teljesen a webböngészőt.

  2. Nyissa meg a webböngészőt és egy új lapot, és lépjen a lapra https://github.com/codespaces.

  3. Az alján megjelenik a legutóbbi Codespaces listája. Keresse meg a "Azure-Samples tulajdonában" című szakaszban létrehozottat.

  4. A kódtér jobb oldalán található három pontra kattintva tekintheti meg a helyi menüt. Innen átnevezheti a kódteret, közzéteheti egy új adattárban, módosíthatja a gép típusát, leállíthatja a kódteret stb.

Nem kötelező: GitHub-adattár közzététele a Codespacesből

Ezen a ponton rendelkezik egy Codespace-nel, amely egy tároló, amelyet GitHub futtat a Visual Studio Code fejlesztési környezetében egy azd sablonból létrehozott új kóddal. A kód azonban nem GitHub adattárban van tárolva. Ha továbbra is dolgozni szeretne a kódon, elsődlegesen tárolja azt egy tárhelyen.

  1. A kódtér helyi menüjében válassza a Közzététel új adattárba lehetőséget.
  2. A Közzététel új adattárba párbeszédpanelen nevezze át az új adattárat, és adja meg, hogy nyilvános vagy privát tárházként szeretné-e használni. Válassza a Create repository (Adattár létrehozása) gombot.
  3. Néhány pillanat múlva létrejön az adattár, és a rövid útmutatóban korábban létrehozott kód le lesz küldve az új adattárba. Az új tárházhoz való ugráshoz válassza az Adattár megtekintése gombot.
  4. A kód újbóli megnyitásához és szerkesztésének folytatásához válassza a zöld "<> Kód" legördülő menüt, váltson a Codespaces lapra, és válassza ki a korábban használt kódtér nevét. Visszatér a Codespace Visual Studio Code fejlesztői környezethez.
  5. A Forrásvezérlő panelen új ágakat hozhat létre, és szakaszokat hozhat létre, és véglegesítse a kód új módosításait.

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.
  • Nyissa meg a GitHub-fiókjához tartozó Codespaces oldalt, keresse meg a Quickstart során létrehozott kódteret, válassza a jobb oldalon a hárompont menüt, majd a helyi menüben válassza a Delete lehetőséget.
  • 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.

Kapcsolódó tartalom

  • Last updated on