Megosztás:

Rövid útmutató: Python-webalkalmazás létrehozása és üzembe helyezése a GitHub Codespacesből az Azure-ba egy Azure Developer CLI-sablon használatával

Ez a rövid útmutató végigvezeti a Python-web- és adatbázismegoldások Azure-ban történő 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 fogja elvégezni:

  • Válasszon egy Azure Developer CLI -(azd) sablont a Python webes keretrendszer, az Azure adatbázisplatform és az Azure web hosting platform alapján, amelyre építeni szeretne.
  • Hozzon létre egy új GitHub Codespace-t, amely a azd kiválasztott sablonból létrehozott kódot tartalmazza.
  • Használja a GitHub Codespacest és az online Visual Studio Code bash-terminálját. A terminál lehetővé teszi az Azure Developer CLI-parancsok használatával egy azd sablon futtatását 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 az Azure-ban.
  • Szerkessze a webalkalmazást egy GitHub Codespace-ben, és használjon egy azd parancsot az újbóli üzembe helyezéshez.
  • Az Azure-erőforrások törléséhez használjon parancsot azd .
  • 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.

További információ a Python-webalkalmazás-fejlesztéshez azd készült sablonokról:

Előfeltételek

Fontos

Mind a GitHub Codespaces, mind az Azure fizetős előfizetés-alapú szolgáltatások. Néhány ingyenes kikötés után 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 szinttel készültek, néhány azonban nem feltétlenül ingyenes. Az Azure Díjszabás kalkulátorával jobban megértheti a költségeket. További információkért lásd a GitHub Codespaces díjszabását .

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

Válasszon egy sablont azd a Python-web keretrendszer, az Azure web hosting platform és az Azure-adatbázisplatform alapján, amelyre építeni szeretne.

  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 Új kódtér
    azure-django-postgres-rugalmas-alkalmazásszolgáltatás Django Rugalmas PostgreSQL-kiszolgáló Azure App Service Új kódtér
    azure-django-cosmos-postgres-aca Django Cosmos DB (PostgreSQL-adapter) Azure Container Apps Új kódtér
    Azure Django Cosmos Postgres AppService Django Cosmos DB (PostgreSQL-adapter) Azure App Service Új kódtér
    azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL bővítmény Azure Container Apps Új kódtér

  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 sablont a azd GitHub-fiókjában. Kattintson a jobb gombbal, és válassza a "Megnyitás új lapon" lehetőséget az "Új kódtér" hivatkozáson a kiválasztott sablonnév mellett a beállítási folyamat elindításához.

    A folyamat során előfordulhat, hogy a rendszer kérni fogja, hogy jelentkezzen be a GitHub-fiókjába, és a rendszer kérni fogja, hogy erősítse meg, hogy létre szeretné hozni a Codespace-t. Válassza a "Kódtér létrehozása" gombot 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, és a Python-websablon betöltődik munkaterületként az Explorer nézetben.

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

Most, hogy már rendelkezik az újonnan létrehozott kódot tartalmazó GitHub Codespace-sel, a azd Codespace-ben található segédprogrammal közzéteheti a kódot az Azure-ban.

  1. A webes Visual Studio Code-ban a terminálnak alapértelmezés szerint nyitva kell lennie. Ha nem, a tilde ~ kulccsal nyissa meg a terminált. Ezenkívül alapértelmezés szerint a terminálnak bash terminálnak kell lennie. 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 Azure-fiókba való hitelesítését.

    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
    • Azure-fiók kiválasztása listából
    • Annak megerősítése, hogy be szeretne jelentkezni a Microsoft Azure CLI-be

  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 az Azure-ban 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 ki egy Azure-előfizetést [Nyilakkal mozoghat, szűréshez írjon be]
    • Válassza ki a használni kívánt Azure-helyet: [Mozgáshoz nyilakkal, szűréshez írja be]

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

    Fontos

    Miután azd up sikeresen befejeződött, a minta webalkalmazás elérhető lesz a nyilvános interneten, és az Azure-előfizetés megkezdi a létrehozott erőforrások 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ással, az összes, azd down által létrehozott szolgáltatást távolítsa el azd up.

    Kövesse az utasításokat, amikor a rendszer arra kéri, hogy válassza ki a fizetéshez használni kívánt Azure-előfizetést, 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 végrehajtás azd up 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.

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

  7. A Ctrl + kattintással az előző lépés második URL-címére kattintva megtekintheti a kiépített erőforrásokat az Azure Portalon.

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

A következő lépés a webalkalmazás kis mértékű módosítása, majd ismételt üzembe helyezése.

  1. Térjen vissza a Visual Studio Code-ot tartalmazó böngészőlapra, és a Visual Studio Code Explorer nézetével lépjen az src/templates mappába, és nyissa meg a index.html fájlt. Keresse meg a következő kódsort:

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

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

    <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. A parancs befejeződése után frissítse a böngészőlapot a ReleCloud webhelyére 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 láthatók lesznek.

    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 az 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, hogy a kód (ideiglenesen) hogyan fut és őrizhető meg rövid távon a Codespace-ben. Ha folytatni szeretné a kódot, közzé kell tennie 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 következőre: https://github.com/codespaces

  3. Az alul megjelenik a legutóbbi Codespaces-ek listája. Keresse meg az "Azure-Samples tulajdona" című szakaszban az Ön által 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-szel, amely egy tároló, amelyet a GitHub üzemeltet, és amely a Visual Studio Code fejlesztői környezetét futtatja az Ön új, egy azd sablonból létrehozott kódjával. A kód azonban nem gitHub-adattárban van tárolva. Ha továbbra is dolgozni szeretne a kódon, ezt prioritásként kell kezelnie.

  1. A kódtér helyi menüjében válassza a "Közzététel új adattárban" lehetőséget.
  2. A "Közzététel új adattárban" párbeszédpanelen nevezze át az új adattárat, és adja meg, hogy nyilvános vagy privát adattárként szeretné-e használni. Válassza az "Adattár létrehozása" lehetőséget.
  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 adattárhoz való navigáláshoz válassza a "Tárház 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. Most vissza kell térnie a Codespace Visual Studio Code fejlesztési környezetébe.
  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 hibákat észlel a(z) azd up közben, próbálkozz a következőkkel:

  • Futtassa azd down annak érdekében, hogy eltávolítson minden esetleg létrehozott erőforrást. Másik lehetőségként törölheti az Azure Portalon létrehozott erőforráscsoportot.
  • Nyissa meg a GitHub-fiókja Codespaces oldalát, keresse meg a gyors kezdési útmutató során létrehozott Codespace-et, kattintson a jobb oldali három pontra, és válassza a "Törlés" opciót a helyi menüben.
  • Az Azure Portalon keresse meg a Key Vaultokat. Válassza ki a Törölt tárolók kezelése, válassza ki az előfizetését, jelölje ki az összes olyan kulcstartót, amely az azdtest nevet vagy a környezetének adott nevet tartalmazza, majd válassza a Végleges 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áért tekintse meg a gyakori kérdéseket .

Kapcsolódó tartalom

  • Last updated on