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

A Python Web azd Templates áttekintése

  • Cikk

A Python webes Azure Developer CLI (azd) sablonjai a leggyorsabb és legegyszerűbb módszer a Python-webalkalmazások Azure-ban való létrehozásának és üzembe helyezésének megkezdésére. Ez a cikk az első lépések során környezeti háttérinformációkat tartalmaz.

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 . Ha nem szeretne helyi fejlesztési környezetet beállítani, a GitHub Codespaces használatával továbbra is követheti a rövid útmutatót.

Mik a Python webes azd-sablonok?

Az Awesome AZD Templates katalógusban számos azd sablon érhető el. Ez a Python-websablonok azd gyűjteménye azonban egyedi, mivel szolgáltatásparitást biztosító minta webalkalmazást biztosítanak az Azure-erőforrások és a Python webes keretrendszerek számos népszerű kombinációjában.

Python-websablon azd futtatásakor a következőt fogja:

  • Hozzon létre egy kezdőalkalmazást – pontosabban egy Relecloud nevű fiktív vállalat webhelyét. A projektkód számos ajánlott eljárást tartalmaz az adott Python-keretrendszerekhez és -csomagokhoz, amelyek az adott technológiakészlethez szükségesek. A sablon célja, hogy kiindulópontként szolgáljon az alkalmazás számára. Szükség szerint hozzáadhat vagy eltávolíthat alkalmazáslogikát és Azure-erőforrásokat.
  • Azure-erőforrások kiépítése – A sablon Azure-erőforrásokat biztosít a webalkalmazás és az adatbázis üzemeltetéséhez a Bicep, egy népszerű infrastruktúra-kód eszköz használatával. Ha további Azure-szolgáltatásokat szeretne hozzáadni, módosítsa a Bicep-sablonokat .
  • A kezdőalkalmazás üzembe helyezése az újonnan kiépített Azure-erőforrásokon – A rendszer automatikusan telepíti a kezdőalkalmazást, így percek alatt láthatja az összes alkalmazást, és eldöntheti, hogy mit szeretne módosítani.
  • Nem kötelező: GitHub-adattár és CI/CD-folyamat beállítása – Ha szeretné, a sablon tartalmazza a GitHub-adattár beállításának logikáját, beleértve a GitHub Actions CI/CD-folyamatot is. Percek alatt módosíthatja a webes projektkódot. Amikor egyesíti ezeket a módosításokat a GitHub-adattár fő ágában, a CI/CD-folyamat közzéteszi őket az új Azure-beli üzemeltetési környezetben.

Kinek szól ez?

A sablonokat tapasztalt Python-webfejlesztők használhatják, akik új Python-webalkalmazást szeretnének létrehozni az Azure üzembe helyezésére.

Miért használnám ezt?

A azd sablonok használata számos előnnyel jár:

  • A lehető leggyorsabb kezdés – A helyi fejlesztési környezet és a környezet beállításainak az útból való üzemeltetésével az alkalmazás perceken belül történő létrehozására összpontosíthat.
  • A legegyszerűbb kezdés – Csak néhány parancssori utasítás végrehajtása egy teljes helyi fejlesztési, üzemeltetési és üzembehelyezési környezet létrehozásához. A munkafolyamat könnyen használható és könnyen megjegyezhető.
  • Az ajánlott eljárásokra építhet – Minden sablont a Python készít és tart karban az Azure-iparági veteránok számára. Adja hozzá a kódot a tervezési megközelítéseik alapján, hogy egy szilárd alapra építkezzen.

Sablonok indexe

Az alábbi táblázat felsorolja a parancshoz azd init használható Python-websablon-monikereketazd, az egyes sablonokban implementált technológiákat, valamint a GitHub-adattárra mutató hivatkozást, ha módosításokat szeretne végezni.

Sablon Webes keretrendszer Database Üzemeltetési platform GitHub-adattár
azure-django-postgres-flexible-aca Django Rugalmas PostgreSQL-kiszolgáló Azure Container-alkalmazások adattár
azure-django-postgres-flexible-appservice Django Rugalmas PostgreSQL-kiszolgáló Azure App Service adattár
azure-django-cosmos-postgres-aca Django Cosmos DB (PostgreSQL-adapter) Azure Container-alkalmazások adattár
azure-django-cosmos-postgres-appservice Django Cosmos DB (PostgreSQL-adapter) Azure App Service adattár
azure-django-postgres-addon-aca Django Azure Container Apps PostgreSQL bővítmény Azure Container-alkalmazások adattár

Hogyan működnek a sablonok?

Különböző azd parancsokkal hajthatja végre a azd sablon által meghatározott feladatokat. Ezeket a parancsokat az Azure Developer CLI használatának első lépéseiben ismertetjük részletesen.

A 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-kódfájlokat (nevezetesen Bicep-fájlokat). Emellett tartalmazza a GitHub-adattár CI/CD-folyamattal való beállításához szükséges konfigurációt is.

A rövid útmutató végigvezeti egy adott azd sablon használatának lépésein. Ehhez csak öt parancssori utasítást kell végrehajtania az éles üzemeltetési környezethez és a helyi fejlesztési környezethez:

  1. azd init --template <template name> - létrehoz egy új projektet egy sablonból, és létrehozza az alkalmazáskód másolatát a helyi számítógépen. A parancssor arra kéri, hogy adjon meg egy környezetnevet (például "myapp"), amelyet az üzembe helyezett erőforrások elnevezése előtagként használ.
  2. azd auth login - bejelentkezik 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 parancsra csak akkor van szükség, amikor először használja az Azure Developer CLI-t (azd) munkamenetenként.
  3. azd up - kiépítheti a felhőbeli erőforrásokat, és üzembe helyezi az alkalmazást ezeken az erőforrásokon.
  4. azd deploy - az alkalmazás forráskódjának módosításait telepíti a már kiépített azd uperőforrásokra.
  5. azd down - törli az Azure-erőforrásokat és a CI/CD-folyamatot, ha használták.

Tipp.

Figyelje meg a választ igénylő kérdések kimenetét azd . A parancs végrehajtása azd up után például előfordulhat, hogy a rendszer arra kéri, hogy válasszon ki egy előfizetést, ha több felhasználóhoz tartozik. Ezenkívül a rendszer kérni fogja, hogy válasszon ki egy régiót. 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.

Miután a sablon elkészült, rendelkezik az eredeti sablon személyes másolatával, ahol szükség szerint módosíthatja az összes fájlt. Legalább úgy módosíthatja a Python-projektkódot, hogy a projekt a saját tervezési és alkalmazáslogikájával rendelkezik. Az infrastruktúra kódként való konfigurációját is módosíthatja, ha módosítania kell az Azure-erőforrásokat. Lásd a Mit szerkeszthetek vagy törölhetek című szakaszt ?

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

Ha módosítani szeretné a kiépített Azure-erőforrásokat, szerkesztheti a megfelelő Bicep-fájlokat a sablonban, és használhatja a következőt:

  1. azd provision - az Azure-erőforrásokat a Bicep-fájlokban definiált kívánt állapotba viszi át.

CI/CD-folyamat 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. Minden alkalommal, amikor véglegesítéseket vagy lekéréses kérelmeket egyesít a főágban, a CI/CD-folyamat automatikusan létrehozza és közzéteszi a módosításokat az Azure-erőforrásokban.

Nem kötelező: A GitHub Actions CI/CD-folyamat automatikus beállítása

Ha a GitHub Actions CI/CD-folyamat funkcióit szeretné implementálni, használja a következő parancsot:

  1. azd pipeline config – Lehetővé teszi egy GitHub-adattár és -beállítások kijelölését a CI\CD-folyamat engedélyezéséhez. A konfigurálás 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.

Mik a többi lehetőségem?

Ha nem szeretne sablonokat használni azd , üzembe helyezheti a Python-alkalmazást az Azure-ban, és számos módon létrehozhat Azure-erőforrásokat.

Az alábbi eszközök egyikével számos erőforrás-létrehozási és üzembe helyezési lépést hajthat végre:

Vagy ha egy Python-webfejlesztési keretrendszereket tartalmazó, végpontok közötti oktatóanyagot keres, tekintse meg a következőket:

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

Nem. A Python-websablonok azd alapértelmezés szerint Dev Containers-tárolókat használnak. A Dev Containers számos előnnyel jár, de előfeltételként szükséges ismereteket és szoftvereket igényel. Ha nem szeretné a Dev Containerst használni, és inkább a helyi fejlesztési környezetet szeretné használni, tekintse meg a README.md fájlt a mintaalkalmazás gyökérkönyvtárában a környezet beállítási utasításaiért.

Mit szerkeszthetek vagy törölhetek?

Az egyes azd sablonok tartalma a projekt típusától és az alkalmazott technológiai veremtől függően változhat. A cikkben felsorolt sablonok egy gyakori konvenciót követnek:

Mappa/fájlok Cél Leírás
/ gyökérkönyvtár A gyökérkönyvtár számos különböző típusú fájlt és mappát tartalmaz különböző célokra.
/.Azure azd konfigurációs fájlok Az Azure Developer CLI (azd) parancsai által használt környezeti változókat tartalmazza. Ez a mappa a azd init parancs futtatása után jön létre. 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.
/.Github A GitHub Actions konfigurálása Tartalmazza az opcionális GitHub Actions CI/CD-folyamat konfigurációs beállításait, valamint a linting és a tesztek beállításait. Az azure-dev.yaml fájl módosítható vagy törölhető, ha nem szeretné beállítani a GitHub Actions-folyamatot parancs használatával azd pipeline config .
/Infra Bicep-fájlok 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 a web.bicep fájlokat módosítsa. Lásd : Rövid útmutató: A Python-websablonokkal üzembe helyezett skálázási szolgáltatások a azd Bicep használatával.
/Src kezdő projektkódfájlok Tartalmazza a webes keretrendszer által igényelt sablonokat, statikus fájlokat, .py fájlokat a kódlogikához és adatmodellekhez, a requirements.txtstb. 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 Belsőleg használják a azd sablonok létrehozásához. Ezt a fájlt biztonságosan törölheti.
/.gitattributes git-attribútumok Fontos konfigurációt biztosít a git számára a fájlok és mappák kezelésével kapcsolatban. Szükség szerint módosíthatja ezt a fájlt.
/.gitignore git figyelmen kívül hagyása Arra utasítja a Gitet, hogy hagyja figyelmen kívül a fájlokat és mappákat az adattárban. Szükség szerint módosíthatja ezt a fájlt.
/azure.yaml azd konfigurációs fájl A konfigurációs beállításokat tartalmazza annak deklarálásához azd up , hogy mely szolgáltatások és projektmappák lesznek üzembe helyezve. Ezt a fájlt NEM szabad törölni.
/*.Md Markdown-fájlok Több Markdown-fájl is létezik különböző célokra. Ezeket a fájlokat biztonságosan törölheti.
/docker-compose.yml Docker Compose Létrehozza az alkalmazás tárolócsomagját az Azure-ban való üzembe helyezés előtt.
/pyproject.toml Python-buildrendszer A Python-projektek buildelési rendszerkövetelményeit tartalmazza. Ezt a fájlt úgy módosíthatja, hogy tartalmazza az előnyben részesített eszközöket (például linter és unit testing framework használatára).
/requirements-dev.in pip requirements file A követelmények fejlesztői környezetbeli verziójának parancs használatával pip install -r történő létrehozására szolgál. Ezt a fájlt szükség szerint módosíthatja úgy, hogy más csomagokat is tartalmazzon.

Tipp.

Használjon megfelelő verziókövetési eljárásokat, hogy visszatérhessen egy olyan időponthoz, amikor a projekt működött, ha megmagyarázhatatlanul megszakít valamit.

Gyakori kérdések

K: Hibaüzenetet kaptam egy azd sablon használatakor. Mit tehetek?

Válasz: Tekintse meg az Azure Developer CLI hibaelhárítását. A problémákat a megfelelő azd sablon GitHub-adattárában is jelentheti.