Megosztás:

A Python webes azd-sablonok áttekintése

A Python webes Azure Developer CLI -sablonokazd a leggyorsabb és legegyszerűbb módja a Python-webalkalmazások Azure-ban történő összeállításának, konfigurálásának és üzembe helyezésének. Ez a cikk környezeti háttérinformációkat tartalmaz, amelyek segítenek megérteni az érintett összetevőket, és hogy a sablonok hogyan egyszerűsítik az üzembe helyezést.

Első lépésként kövesse az első Python-webalkalmazás létrehozásához és az Azure-ban történő üzembe helyezéséhez szükséges rövid útmutatót sablonokkal azd , percek alatt. Ha nem szeretne helyi fejlesztési környezetet beállítani, a GitHub Codespaces használatával követheti a rövid útmutatót , hogy teljes mértékben felhőalapú élményt nyújtson az összes előre konfigurált eszközzel.

Milyen azd-sablonok léteznek a Python webes fejlesztésben?

A azd sablonok olyan tapasztalt Python-webfejlesztők számára lettek kialakítva, akik skálázható, felhőalapú alkalmazásokat szeretnének üzembe helyezni az Azure-ban minimális beállítási idő mellett.

Ezek a sablonok a legegyszerűbb kiindulópontot kínálják a Python-webalkalmazások létrehozásához és üzembe helyezéséhez:

  • Gyorsan beállíthat egy teljes helyi fejlesztési és üzemeltetési környezetet.
  • Egy megfelelő Azure-beli üzembehelyezési környezet létrehozásának automatizálása.
  • Egyszerű és emlékezetes parancssori felületi munkafolyamat használata.

A környezetek beállítása után a sablonok biztosítják a leggyorsabb módot a Python-webalkalmazás létrehozásának megkezdésére. Ön megteheti:

  • Módosítsa a megadott kódfájlokat az alkalmazás követelményeinek megfelelően.
  • A frissítések üzembe helyezése minimális erőfeszítéssel azd parancsok használatával.
  • Terjessze ki a sablont az architektúrájához.

Ezek a sablonok bevált tervezési mintákat és ajánlott eljárásokat tükröznek, ezáltal lehetővé téve Ön számára, hogy:

  • Építs magabiztosan egy szilárd architekturális alapra.
  • Kövesse a Pythonban és az Azure-ban mély tapasztalattal rendelkező iparági szakértők által kifejlesztett útmutatást.
  • A karbantartást, a méretezhetőséget és a biztonságot a kezdetektől fogva biztosítani kell.

Milyen feladatokat végezhetek a sablonokkal?

Python webes azd-sablon futtatásakor gyorsan elvégezhet több feladatot:

  • Kezdőalkalmazás létrehozása. Egy Relecloud nevű fiktív vállalat webhelyét hozhatja létre. Ez a kezdőprojekt a következőket tartalmazza:

    • Jól szervezett, üzemkész kód
    • Ajánlott eljárások Python webes keretrendszerekhez (például Flask, Django).
    • A függőségek, a konfiguráció és a struktúra megfelelő használata.

    A sablon kiindulópontként lett kialakítva – szabadon testre szabhatja a logikát, és kibonthatja vagy eltávolíthatja az Azure-erőforrásokat a projektnek megfelelően.

  • Azure-erőforrások kiépítése. A Bicep, egy modern infrastrukturális (IaC) nyelv használatával a sablon az összes szükséges Azure-erőforrást a következőkhöz biztosítja:

    • Webalkalmazás üzemeltetése (például App Service, Container Apps)
    • Csatlakozás adatbázisokhoz (például PostgreSQL, Cosmos DB)

    A Bicep-fájlok teljes mértékben szerkeszthetők – az alkalmazás fejlődésével azure-szolgáltatásokat adhat hozzá vagy szabhat testre. Az előző feladathoz hasonlóan a Bicep-sablonokat módosíthatja további Azure-szolgáltatások igény szerinti hozzáadásához.

  • Kezdőalkalmazás üzembe helyezése kiépített Azure-erőforrásokon. Az erőforrások kiépítése után az alkalmazás automatikusan üzembe lesz helyezve az Azure-környezetben. Most már lehetősége van:

    • Az alkalmazás percek alatt fut a felhőben.
    • Tesztelje a viselkedését.
    • Döntse el, hogy milyen funkciókat vagy konfigurációt kell frissítenie.

  • (nem kötelező) A GitHub-adattár és a CI/CD-folyamatbeállítása. A GitHub-adattárakat igény szerint inicializálhatja egy GitHub Actions folyamatos integrációs/folyamatos kézbesítési (CI/CD) folyamattal a következőre:

    • A kódváltozások telepítésének automatizálása.
    • Együttműködés a csapattagokkal.
    • Frissítések leküldése az Azure-ba a fő ágba való egyesítéssel.

    Ez az integráció segít a DevOps ajánlott eljárásainak bevezetésében.

Hol érhetem el a sablonokat?

Számos azd sablon érhető el az Félelmetes Azure Developer CLI-sablonok gyűjteményében. Ezek a sablonok olyan használatra kész Python-webalkalmazás-projekteket biztosítanak, amely funkcióparitást biztosít az Azure-szolgáltatások és a Python webes keretrendszerek népszerű kombinációi között.

Minden sablon a következőket tartalmazza:

  • Mintaalkalmazás tiszta, karbantartható kóddal.
  • Előre konfigurált infrastruktúra kódként a Bicep használatával.
  • Zökkenőmentes üzembehelyezési munkafolyamatok az Azure Developer CLI használatával.
  • Nem kötelező CI/CD-integráció a GitHub Actions használatával

Az alábbi táblázatok felsorolják a Python webes azd sablon monikereket, amelyek az azd init paranccsal használhatók. A táblák azonosítják az egyes sablonokban implementált technológiákat, és hivatkozást biztosítanak a megfelelő GitHub-adattárra, ahol módosításokat végezhet.

Az alábbi azd sablonok érhetők el a Django webes keretrendszerhez.

Sablon Adatbázis Üzemeltetési platform GitHub-adattár
azure-django-postgres-flexible-aca rugalmas Azure Database for PostgreSQL-kiszolgáló Azure Konténer Alkalmazások https://github.com/Azure-Samples/azure-django-postgres-flexible-aca
azure-django-postgres-rugalmas-alkalmazásszolgáltatás Azure Database for PostgreSQL rugalmas kiszolgáló. Azure App Service https://github.com/Azure-Samples/azure-django-postgres-flexible-appservice
azure-django-cosmos-postgres-aca Azure Cosmos DB az Azure Database for PostgreSQL-hez Azure Container Apps (Azure Konténer Alkalmazások) https://github.com/Azure-Samples/azure-django-cosmos-postgres-aca
Azure Django Cosmos Postgres AppService Azure Cosmos DB az Azure Database for PostgreSQL számára Azure App Service https://github.com/Azure-Samples/azure-django-cosmos-postgres-appservice
azure-django-postgres-addon-aca Azure Container Apps és az Azure Database for PostgreSQL Azure Container Apps (Azure Konténer Alkalmazások) https://github.com/Azure-Samples/azure-django-postgres-addon-aca

Hogyan használhatom a sablonokat?

Minden azd-sablon egy GitHub-adattárból áll, amely tartalmazza az alkalmazáskódot (egy népszerű webes keretrendszert használó Python-kódot) és az Azure-erőforrások létrehozásához szükséges infrastruktúra-fájlokat (nevezetesen Bicep) fájlokat. A sablon tartalmazza a GitHub-adattár CI/CD-folyamattal való beállításához szükséges konfigurációt is.

Az egyes sablonok fő összetevői a következők:

  • Alkalmazáskód: Pythonban íródott, és egy népszerű webes keretrendszer (például Flask, Django, FastAPI) használatával készült. A mintaalkalmazás bemutatja az útválasztás, az adathozzáférés és a konfiguráció ajánlott eljárásait.

  • Infrastruktúra kódként (IaC):: Bicep-fájlokon keresztül biztosítva a szükséges Azure-erőforrások definiálásához és kiépítéséhez, például:

    • Alkalmazásszolgáltatás vagy Konténeralkalmazások
    • Azure-adatbázisok (például PostgreSQL, Cosmos DB)
    • Azure AI-szolgáltatások, Storage és egyebek

  • CI/CD-konfiguráció (nem kötelező):: A GitHub-adattár GitHub Actions CI/CD-folyamattal való beállításához szükséges fájlokat tartalmazza, amelyek lehetővé teszik a következőket:

    • Automatikus üzembe helyezés az Azure-ban a főágba irányuló leküldéses vagy lekéréses kérelmek esetén.
    • Zökkenőmentes integráció a DevOps-munkafolyamatba

    Ezek a sablonok teljes mértékben testreszabhatók, így erős alapot biztosít a projekt egyedi igényeire való építéshez és az ahhoz való alkalmazkodáshoz.

A azd webes sablon által meghatározott feladatok elvégzéséhez különböző Python-azd parancsokat kell használnia. A parancsok részletes leírását a rövid útmutatóban találja: Azure Developer CLI-sablon üzembe helyezése. A rövid útmutató végigvezeti egy adott azd-sablon használatának lépésein. Csak öt alapvető parancssori utasítást kell futtatnia az éles üzemeltetésű környezethez és a helyi fejlesztési környezethez.

Az alábbi táblázat az öt alapvető parancsot foglalja össze:

Parancs Tevékenység leírása
azd init --template <template name> Hozzon létre egy új projektet egy sablonból, és hozzon létre egy másolatot az alkalmazáskódról a helyi számítógépen. A parancssor arra kéri, hogy adjon meg egy környezetnevet (például "myapp"), amelyet előtagként használnak az üzembe helyezett erőforrások elnevezésében.
azd auth login Jelentkezzen be az Azure-ba. A parancs megnyitja a böngészőablakot, ahol bejelentkezhet az Azure-ba. A bejelentkezés után a böngészőablak bezárul, és a parancs befejeződik. A azd auth login parancs csak akkor szükséges, amikor először használja az Azure Developer CLI-t (azd) munkamenetenként.
azd up A felhőbeli erőforrások kiépítése és az alkalmazás üzembe helyezése ezeken az erőforrásokon.
azd deploy Az alkalmazás forráskódjának módosításainak üzembe helyezése az azd up parancs által már kiépített erőforrásokra.
azd down Ha használták, törölje az Azure-erőforrásokat és a CI/CD-folyamatot.

Borravaló

Ha a azd parancsokkal dolgozik, tekintse meg a további információk megadására vonatkozó utasításokat. A azd up parancs végrehajtása után előfordulhat, hogy a rendszer arra kéri, hogy válasszon ki egy előfizetést, ha több előfizetéssel rendelkezik. Előfordulhat, hogy a rendszer kérni fogja a régió megadását is. A kérdésekre adott válaszokat a sablon /.azure/ mappájában tárolt környezeti változók szerkesztésével módosíthatja.

A sablon által azd biztosított alapvető feladatok elvégzése után rendelkezik az eredeti sablon személyes másolatával, ahol szükség szerint módosíthatja a fájlokat.

  • Alkalmazáskód: A Python-projektkód testreszabása saját tervezés, útvonalak és üzleti logika implementálásához.
  • Infrastruktúra kódként (Bicep): Frissítse a Bicep-fájlokat további Azure-szolgáltatások kiépítéséhez, konfigurációk módosításához vagy szükségtelen erőforrások eltávolításához.

Ez a rugalmas kiindulási pont lehetővé teszi, hogy egy jól strukturált alapra építsen, miközben az alkalmazást a valós használati esethez igazítja.

Ha módosítania kell az Azure-erőforrásokat, módosíthatja az infrastruktúra kódként való konfigurációját. További információért lásd a Mit szerkeszthetek vagy törölhetek szakaszt a cikk későbbi részében.

Választható sablonfeladatok

Az öt alapvető parancs mellett választható feladatok is elvégezhetők a azd sablonokkal.

Azure-erőforrások újbóli létrehozása és módosítása

Miután azure-erőforrásokat kiépített egy azd sablonnal, módosíthatja és újra létrehozhat egy erőforrást.

  • A kiépített erőforrások módosításához szerkeszteni a sablonban megfelelő Bicep-fájlokat.
  • Az újraépítési feladat elindításához használja a azd provision parancsot.

CI/CD-folyamatlánc beállítása

Az Azure Developer CLI (azd) egyszerű módot kínál egy CI/CD-folyamat beállítására az új Python-webalkalmazáshoz. Amikor véglegesítéseket vagy lekéréses kérelmeket egyesít a főágban, a folyamat automatikusan létrehozza és közzéteszi a módosításokat az Azure-erőforrásokban.

  • A CI/CD-folyamat beállításához meg kell adnia a GitHub-adattárat és a kívánt beállításokat a folyamat engedélyezéséhez.
  • A pipeline létrehozásához használja a azd pipeline config parancsot.

A folyamat konfigurálása után minden alkalommal, amikor a kódmódosítások egyesülnek az adattár fő ágával, a folyamat üzembe helyezi a módosításokat a kiépített Azure-szolgáltatásokban.

A sablonok alternatívái

Ha inkább nem szeretné használni a Python webes azd-sablonokat, vannak alternatív módszerek a Python-webalkalmazások Azure-ban való üzembe helyezésére és Azure-erőforrások kiépítésére.

Számos erőforrást hozhat létre, és több eszközzel elvégezheti az üzembe helyezés lépéseit:

Megtekinthet egy teljes oktatóanyagot is, amely Python webfejlesztési keretrendszereket tartalmaz.

Gyakori kérdések

Az alábbi szakaszok a Python-azd-sablonok használatával kapcsolatos gyakori kérdésekre adott válaszokat foglalják össze.

Dev-tárolókat kell használnom?

Nem. A Python webes azd-sablonok alapértelmezés szerint Visual Studio Code Dev Containers használnak. A Dev Containers számos előnnyel jár, de előfeltételként szükséges ismereteket és szoftvereket igényelnek. Ha inkább nem a Dev Containerst szeretné használni, hanem a helyi fejlesztési környezetet használja, tekintse meg a README.md fájlt a mintaalkalmazás gyökérkönyvtárában a környezetbeállítási utasításokért.

Mit szerkeszthetek vagy törölhetek?

Az egyes Python-azd-sablonok tartalma a projekt típusától és az alapul szolgáló technológiai veremtől függően változhat. A cikkben azonosított sablonok egy közös mappa- és fájlkonvenciát követnek, az alábbi táblázatban leírtak szerint.

Mappa/fájl(ok) Cél Leírás
/ Gyökérkönyvtár Az egyes sablonok gyökérmappája számos különböző típusú fájlt és mappát tartalmaz különböző célokra.
/.azure konfigurációs fájlok azd Az .azure mappa a azd init parancs futtatása után jön létre. A mappa a azd parancsok által használt környezeti változók konfigurációs fájljait tárolja. A környezeti változók értékeit módosíthatja az alkalmazás és az Azure-erőforrások testreszabásához. További információ: környezetspecifikus .env fájl.
/.devcontainer Fejlesztői tároló konfigurációs fájljai A Dev Containers lehetővé teszi egy tárolóalapú fejlesztési környezet létrehozását, amely a Visual Studio Code szoftverfejlesztéséhez szükséges összes erőforrással együtt rendelkezik. A .devcontainer mappa azután jön létre, hogy a Visual Studio Code létrehoz egy Dev Container konfigurációs fájlt egy sablonparancsra válaszul.
/.github GitHub Actions konfigurációs fájlok Ez a mappa konfigurációs beállításokat tartalmaz az opcionális GitHub Actions CI/CD-folyamathoz, a lintinghez és a tesztekhez. Ha nem szeretné beállítani a GitHub Actions-folyamatot azd pipeline config paranccsal, módosíthatja vagy törölheti az azure-dev.yaml fájlt.
/infra Bicep-fájlok Az infra mappában találhatók a Bicep konfigurációs fájljai. A Bicep lehetővé teszi, hogy deklarálja a környezetében üzembe helyezni kívánt Azure-erőforrásokat. Csak a main.bicep és web.bicep fájlokat kell módosítania. További információ: Rövid útmutató: Az azd Python-websablonokkal üzembe helyezett skálázási szolgáltatások a Bicephasználatával.
/Src Kezdőprojekt-kódfájlok Az src mappa a kezdőprojekt előkészítéséhez szükséges különböző kódfájlokat tartalmazza. Ilyenek például a webes keretrendszerhez szükséges sablonok, statikus fájlok, a kódlogikához és adatmodellekhez tartozó Python-fájlok (.py), egy requirements.txt-fájl stb. Az adott fájlok a webes keretrendszertől, az adatelérési keretrendszertől és így tovább függnek. Ezeket a fájlokat a projekt követelményeinek megfelelően módosíthatja.
/.cruft.json Sablongenerálási fájl A .cruft JSON-fájl belsőleg használatos a Python webes azd-sablonok létrehozásához. Szükség esetén biztonságosan törölheti ezt a fájlt.
/.gitattributes A git attribútumbeállításait tartalmazó fájl Ez a fájl fontos konfigurációs beállításokat biztosít a git számára a fájlok és mappák kezeléséhez. Szükség szerint módosíthatja ezt a fájlt.
/.gitignore A git figyelmen kívül hagyott elemeit tartalmazó fájl A .gitignore fájl tájékoztatja a gitet azokról a fájlokról és mappákról, amelyek kihagyják (figyelmen kívül hagyják) a sablon GitHub-adattárába való íráskor. Szükség szerint módosíthatja ezt a fájlt.
/azure.yaml azd up konfigurációs fájl Ez a konfigurációs fájl tartalmazza a azd up parancs konfigurációs beállításait. Meghatározza az üzembe helyezendő szolgáltatásokat és projektmappákat. Fontos: Ezt a fájlt nem szabad törölni.
/*.Md Markdown-formátumfájlok A sablonok különböző Markdown-fájlokat (.md) is tartalmazhatnak különböző célokra. A Markdown-fájlokat biztonságosan törölheti.
/docker-compose.yml Docker-összeállítási beállítások Ez az YML-fájl létrehozza a Python-webalkalmazás tárolócsomagját, mielőtt az alkalmazás üzembe helyezené az Azure-ban.
/pyproject.toml A Python buildbeállítások fájlja A TOML-fájl a Python-projektek buildelési rendszerkövetelményeit tartalmazza. Ezt a fájlt úgy módosíthatja, hogy azonosítsa az eszköz beállításait, például egy adott lintert vagy egységtesztelési keretrendszert.
/requirements-dev.in pip követelményfájl Ez a fájl a követelmények fejlesztői környezetbeli verziójának létrehozásához használható a pip install -r paranccsal. Szükség szerint módosíthatja ezt a fájlt úgy, hogy más csomagokat is tartalmazzon.

Borravaló

A program sablonfájljainak módosításakor mindenképpen gyakorolja a megfelelő verziókövetést. Ez a módszer segíthet visszaállítani az adattárat egy korábbi működő verzióra, ha az új módosítások programproblémákat okoznak.

Hogyan kezelhetők a sablonhibák?

Ha azd-sablon használatakor hibaüzenetet kap, tekintse át a Azure Developer CLI hibaelhárításáról szóló cikkben ismertetett lehetőségeket. A azd sablonhoz kapcsolódó GitHub-tárhelyen is jelenthetsz további problémákat.

Kapcsolódó tartalom

  • Last updated on