Sdílet prostřednictvím

Přehled šablon webu azd v Pythonu

Šablony Azure Developer CLI (azd) v Pythonu jsou nejrychlejším a nejsnadnějším způsobem, jak sestavovat, konfigurovat a nasazovat webové aplikace Pythonu do Azure. Tento článek obsahuje kontextové informace, které vám pomůžou pochopit zahrnuté součásti a jak šablony zjednodušují nasazení.

Nejlepší způsob, jak začít, je postupovat podle rychlého startu a vytvořit první webovou aplikaci v Pythonu a nasadit ji do Azure během několika minut pomocí azd šablon. Pokud nechcete nastavit místní vývojové prostředí, můžete postupovat podle rychlého startu pomocí GitHub Codespaces pro plně cloudové prostředí s předkonfigurovanými nástroji.

Co jsou webové šablony Python azd?

Šablony azd jsou navržené pro zkušené webové vývojáře v Pythonu, kteří chtějí nasadit škálovatelné aplikace připravené pro cloud v Azure s minimální dobou instalace.

Tyto šablony nabízejí nejjednodušší možný výchozí bod pro vytváření a nasazování webových aplikací Pythonu:

  • Rychlé nastavení kompletního místního vývojového a hostitelského prostředí
  • Automatizace vytváření odpovídajícího prostředí nasazení Azure
  • Použití jednoduchého a zapamatovatelného pracovního postupu rozhraní příkazového řádku

Po nastavení prostředí vám šablony poskytnou nejrychlejší způsob, jak začít vytvářet webovou aplikaci v Pythonu. Můžete:

  • Upravte poskytnuté soubory kódu tak, aby odpovídaly požadavkům vaší aplikace.
  • Nasaďte aktualizace s minimálním úsilím pomocí příkazů azd.
  • Rozšiřte šablonu tak, aby vyhovovala vaší architektuře.

Tyto šablony odrážejí osvědčené vzory návrhu a osvědčené postupy, které vám umožní:

  • Zabudujte s jistotou na pevných základech architektury.
  • Postupujte podle pokynů vyvinutých odborníky z oboru s hlubokými zkušenostmi v Pythonu a Azure.
  • Zajištění udržovatelnosti, škálovatelnosti a zabezpečení od začátku

Jaké úkoly můžu se šablonami dělat?

Při spuštění webové azd šablony Pythonu rychle dokončíte několik úloh:

  • Vytvořit úvodní aplikaci. Vytvoříte web pro fiktivní společnost s názvem Relecloud. Tento úvodní projekt zahrnuje:

    • Dobře uspořádaný kód připravený pro produkční prostředí
    • Osvědčené postupy pro webové architektury Pythonu (například Flask, Django).
    • Správné použití závislostí, konfigurace a struktury

    Šablona je navržená tak, aby byla výchozím bodem – logiku můžete volně přizpůsobit a rozšířit nebo odebrat prostředky Azure tak, aby vyhovovaly vašemu projektu.

  • zřízení prostředků Azure. Pomocí Bicep, moderního jazyka IaC (infrastructure-as-code), šablona zřídí všechny nezbytné prostředky Azure pro:

    • Hostování webové aplikace (například App Service, Container Apps)
    • Připojení k databázím (například PostgreSQL, Cosmos DB)

    Soubory Bicep jsou plně upravitelné – můžete přidávat nebo přizpůsobovat služby Azure při vývoji vaší aplikace. Podobně jako v předchozím úkolu můžete šablony Bicep upravit, abyste podle potřeby přidali další služby Azure.

  • Nasadit úvodní aplikaci do zřízených prostředků Azure. Po zřízení prostředků se vaše aplikace automaticky nasadí do prostředí Azure. Teď můžete:

    • Podívejte se, jak vaše aplikace běží v cloudu během několika minut.
    • Otestujte jeho chování.
    • Rozhodněte se, jaké funkce nebo konfiguraci chcete aktualizovat.

  • (volitelné) Nastavení úložiště GitHub a kanálu CI/CD. Můžete volitelně inicializovat úložiště GitHub pomocí GitHub Actions pipeline kontinuální integrace/průběžného doručování (CI/CD) k:

    • Automatizujte nasazení změn kódu.
    • Spolupracujte s členy týmu.
    • Nasazujte aktualizace do Azure sloučením do hlavní větve

    Tato integrace vám pomůže přijmout osvědčené postupy DevOps od začátku.

Kde se dostanu k šablonám?

Mnoho azd šablon je k dispozici v galerii šablon Awesome Azure Developer CLI. Tyto šablony poskytují projekty webových aplikací v Pythonu připravené k použití s paritou funkcí napříč oblíbenými kombinacemi služeb Azure a webových architektur Pythonu.

Každá šablona zahrnuje:

  • Ukázková aplikace s čistým a udržovatelným kódem
  • Předkonfigurovaná infrastruktura jako kód pomocí Bicep.
  • Pracovní postupy bezproblémového nasazení pomocí Azure Developer CLI
  • Volitelná integrace CI/CD prostřednictvím GitHub Actions

Následující tabulky uvádějí webové azd šablony Pythonu, které jsou k dispozici pro použití s příkazem azd init. Tabulky identifikují technologie implementované v každé šabloně a poskytují odkaz na odpovídající úložiště GitHub, kde můžete přispívat změnami.

Následující šablony jsou k dispozici pro webové rozhraníDjango .

Šablona Databáze Platforma pro hostování Úložiště GitHub
azure-django-postgres-flexible-aca flexibilního serveru Azure Database for PostgreSQL Azure Container Apps https://github.com/Azure-Samples/azure-django-postgres-flexible-aca
azure-django-postgres-flexible-appservice Flexibilní server Azure Database pro PostgreSQL Azure App Service https://github.com/Azure-Samples/azure-django-postgres-flexible-appservice
azure-django-cosmos-postgres-aca azure Cosmos DB for Azure Database for PostgreSQL Azure Container Apps (aplikace pro kontejnery) https://github.com/Azure-Samples/azure-django-cosmos-postgres-aca
azure-django-cosmos-postgres-appservice Azure Cosmos DB pro Azure Database pro PostgreSQL Azure App Service https://github.com/Azure-Samples/azure-django-cosmos-postgres-appservice
Azure Django Postgres Addon ACA Azure Container Apps se službou Azure Database for PostgreSQL Azure Container Apps (aplikace pro kontejnery) https://github.com/Azure-Samples/azure-django-postgres-addon-aca

Jak mám šablony používat?

Každá šablona azd obsahuje úložiště GitHubu, které obsahuje kód aplikace (kód Pythonu, který využívá oblíbenou webovou architekturu) a soubory infrastruktury jako kódu (konkrétně Bicep) k vytvoření prostředků Azure. Šablona obsahuje také konfiguraci potřebnou k nastavení úložiště GitHub s kanálem CI/CD.

Mezi klíčové součásti každé šablony patří:

  • Kód aplikace: Napsaný v Pythonu a sestavený pomocí oblíbené webové architektury (například Flask, Django, FastAPI). Ukázková aplikace ukazuje osvědčené postupy při směrování, přístupu k datům a konfiguraci.

  • Infrastruktura jako kód (IaC): Poskytuje se prostřednictvím souborů Bicep pro definování a zřízení požadovaných prostředků Azure, například:

    • App Service nebo Container Apps
    • Databáze Azure (například PostgreSQL, Cosmos DB)
    • Služby Azure AI, Úložiště a další

  • Konfigurace CI/CD (volitelné):: Zahrnuje soubory pro nastavení úložiště GitHub s kanálem CI/CD GitHub Actions, který umožňuje:

    • Automatické nasazení do Azure při každém pushi nebo pull requestu do hlavní větve.
    • Bezproblémová integrace do pracovního postupu DevOps

    Tyto šablony jsou plně přizpůsobitelné a poskytují silný základ pro vytváření a přizpůsobení konkrétních potřeb projektu.

K provádění úloh definovaných webovou šablonou azd použijete různé příkazy azd Pythonu. Podrobné popisy těchto příkazů najdete v tématu Rychlý start: Nasazení šablony Azure Developer CLI. Rychlý start vás provede postupem použití konkrétní šablony azd. Do produkčního hostitelského prostředí a místního vývojového prostředí stačí spustit pět základních instrukcí příkazového řádku.

Následující tabulka shrnuje pět základních příkazů:

Příkaz Popis úkolu
azd init --template <template name> Vytvořte nový projekt ze šablony a vytvořte kopii kódu aplikace v místním počítači. Příkaz vás vyzve k zadání názvu prostředí (například myapp), který se používá jako předpona v pojmenování nasazených prostředků.
azd auth login Přihlaste se k Azure. Příkaz otevře okno prohlížeče, ve kterém se můžete přihlásit k Azure. Po přihlášení se okno prohlížeče zavře a příkaz se dokončí. Příkaz azd auth login se vyžaduje jenom při prvním použití Azure Developer CLI (azd) za relaci.
azd up Zřiďte cloudové zdroje a nasaďte aplikaci na ně.
azd deploy Nasaďte změny zdrojového kódu aplikace do prostředků, které už příkaz azd up zřídil.
azd down Odstraňte prostředky Azure a kanál CI/CD, pokud se použil.

There are no changes required, as the original translation is already optimal.

Při práci s příkazy azd sledujte výzvy k zadání dalších informací. Po spuštění příkazu azd up se může zobrazit výzva k výběru předplatného, pokud jich máte víc. Může se také zobrazit výzva k zadání oblasti. Odpovědi na výzvy můžete změnit úpravou proměnných prostředí uložených ve složce /.azure/ šablony.

Po dokončení základních úkolů poskytovaných azd šablonou máte osobní kopii původní šablony, kde můžete podle potřeby upravit libovolný soubor.

  • Kód aplikace: Přizpůsobte si kód projektu Pythonu tak, aby implementovali vlastní návrh, trasy a obchodní logiku.
  • Infrastruktura jako kód (Bicep):: Aktualizujte soubory Bicep tak, aby zřídily další služby Azure, změnily konfigurace nebo odebraly nepotřebné prostředky.

Tento flexibilní výchozí bod vám umožňuje přizpůsobit aplikaci vašemu skutečnému případu použití tím, že stavíte na dobře strukturovaném základu.

Pokud potřebujete změnit prostředky Azure, můžete také upravit konfiguraci infrastruktury jako kódu. Další informace najdete v části Co můžu upravit nebo odstranit později v tomto článku.

Volitelné úkoly v rámci šablony

Kromě pěti základních příkazů jsou k dispozici i volitelné úkoly, které můžete dokončit pomocí šablon azd.

Přepříprava a úprava prostředků Azure

Po zřízení prostředků Azure pomocí šablony azd můžete prostředek upravit a znovu zřídit.

  • Pokud chcete upravovat zřízený prostředek, upravte správné soubory Bicep v šabloně.
  • K zahájení úlohy přeprovisionování použijte příkaz azd provision.

Nastavení kanálu CI/CD

Azure Developer CLI (azd) poskytuje snadný způsob nastavení kanálu CI/CD pro novou webovou aplikaci v Pythonu. Když sloučíte commity nebo pull requesty do hlavní větve, pipeline automaticky sestaví a publikuje změny ve vašich prostředcích Azure.

  • Pokud chcete nastavit kanál CI/CD, určíte úložiště GitHub a požadovaná nastavení pro povolení kanálu.
  • K vytvoření kanálu použijte příkaz azd pipeline config.

Jakmile kanál nakonfigurujete, pokaždé, když se změny kódu sloučí do hlavní větve úložiště, kanál nasadí změny do zřízených služeb Azure.

Alternativy k šabloně

Pokud raději nepoužíváte webové azd šablony Pythonu, existují alternativní metody nasazení webových aplikací v Pythonu do Azure a zřizování prostředků Azure.

Pomocí několika nástrojů můžete vytvořit mnoho prostředků a dokončit kroky nasazení:

Můžete také postupovat podle kompletního kurzu, který obsahuje architektury vývoje pro web v Pythonu:

Nejčastější dotazy

Následující části shrnují odpovědi na nejčastější dotazy týkající se práce s šablonami webových azd Pythonu.

Musím používat Dev Containers?

Ne. Webové azd šablony Pythonu ve výchozím nastavení používají Visual Studio Code Dev Containers. Dev Containers nabízí mnoho výhod, ale vyžadují určité požadované znalosti a software. Pokud raději nepoužíváte Dev Containers a místo toho používáte místní vývojové prostředí, projděte si README.md soubor v kořenovém adresáři ukázkové aplikace a pokyny k nastavení prostředí.

Co můžu upravit nebo odstranit?

Obsah každé webové azd šablony Pythonu se může lišit v závislosti na typu projektu a použitém podkladovém zásobníku technologií. Šablony popsané v tomto článku se řídí běžnou konvencí složek a souborů, jak je popsáno v následující tabulce.

Složky nebo soubory Účel Popis
/ Kořenový adresář Kořenová složka pro každou šablonu obsahuje mnoho různých druhů souborů a složek pro různé účely.
/.azure konfigurační soubory azd Po spuštění příkazu se vytvoří složka azd init. Složka ukládá konfigurační soubory pro proměnné prostředí používané příkazy azd. Můžete změnit hodnoty proměnných prostředí a přizpůsobit aplikaci a prostředky Azure. Další informace naleznete v části Soubor .env specifický pro prostředí.
/.devcontainer Konfigurační soubory vývojového kontejneru Dev Containers umožňuje vytvořit vývojové prostředí založené na kontejnerech s veškerými prostředky, které potřebujete pro vývoj softwaru v editoru Visual Studio Code. Složka .devcontainer se vytvoří poté, co Visual Studio Code vygeneruje konfigurační soubor vývojového kontejneru v reakci na příkaz šablony.
/.github Konfigurační soubory GitHub Actions Tato složka obsahuje konfiguraci pro volitelný CI/CD kanál GitHub Actions, linting a testy. Pokud nechcete nastavit kanál GitHub Actions pomocí příkazu azd pipeline config, můžete upravit nebo odstranit soubor azure-dev.yaml.
/infra Soubory Bicep Složka infra obsahuje konfigurační soubory Bicep. Bicep umožňuje deklarovat prostředky Azure, které chcete nasadit do svého prostředí. Měli byste upravit jenom soubory main.bicep a web.bicep. Další informace najdete v tématu Rychlý start: Škálování služeb nasazených pomocí webových šablon Pythonu azd pomocí bicep.
/Src Počáteční soubory kódu projektu Složka src obsahuje různé soubory kódu potřebné k přípravě počátečního projektu. Mezi příklady souborů patří šablony vyžadované webovou architekturou, statickými soubory, soubory Pythonu (.py) pro logiku kódu a datové modely, requirements.txt soubor a další. Konkrétní soubory závisí na webovém rozhraní, rozhraní pro přístup k datům atd. Tyto soubory můžete upravit tak, aby vyhovovaly požadavkům projektu.
/.cruft.json Soubor generování šablon Soubor JSON .cruft se interně používá k vygenerování šablon webových azd Pythonu. Podle potřeby můžete tento soubor bezpečně odstranit.
/.gitattributes Soubor s nastavením atributu pro Git Tento soubor obsahuje důležitá konfigurační nastavení pro Git, která slouží ke zpracování souborů a složek. Podle potřeby můžete tento soubor upravit.
/.gitignore Soubor s ignorovanými položkami u git Soubor .gitignore informuje git o souborech a složkách, které se mají při zápisu do úložiště GitHubu pro šablonu vyloučit (ignorovat). Podle potřeby můžete tento soubor upravit.
/azure.yaml konfigurační soubor azd up Tento konfigurační soubor obsahuje nastavení konfigurace pro příkaz azd up. Určuje služby a složky projektu, které se mají nasadit. Důležité: Tento soubor nesmí být odstraněn.
/*.Md Soubory formátu Markdownu Šablona může obsahovat různé soubory formátu Markdown (.md) pro různé účely. Soubory Markdownu můžete bezpečně odstranit.
/docker-compose.yml Nastavení Docker Compose Tento soubor YML vytvoří balíček kontejneru pro webovou aplikaci Python před nasazením aplikace do Azure.
/pyproject.toml Soubor nastavení sestavení Pythonu Soubor TOML obsahuje požadavky na systém sestavení projektů Pythonu. Tento soubor můžete upravit tak, aby identifikoval předvolby nástrojů, jako je konkrétní linter nebo architektura testování jednotek.
/requirements-dev.in soubor požadavků pip Tento soubor slouží k vytvoření verze vývojového prostředí požadavků pomocí příkazu pip install -r. Podle potřeby můžete tento soubor upravit tak, aby zahrnoval další balíčky.

There are no changes required, as the original translation is already optimal.

Při úpravě souborů šablon pro váš program nezapomeňte procvičit dobrou správu verzí. Tento přístup vám může pomoct obnovit úložiště na předchozí funkční verzi, pokud nové změny způsobují problémy s programem.

Jak můžu zpracovat chyby šablony?

Pokud se při použití šablony azd zobrazí chyba, projděte si možnosti popsané v článku Řešení potíží s rozhraním příkazového řádku azure pro vývojáře. Můžete také hlásit problémy v úložišti GitHubu přidruženém k šabloně azd.

Související obsah

  • Last updated on