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 a nasazovat webové aplikace Pythonu do Azure. Tento článek poskytuje kontextové informace pro začátek práce se šablonami.
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í šablon azd. Pokud nechcete nastavit místní vývojové prostředí, můžete přesto postupovat podle rychlého startu pomocí GitHub Codespaces.
Co jsou webové šablony Python azd?
Šablony azd jsou určené zkušeným webovým vývojářům v Pythonu, kteří chtějí vytvářet webové aplikace v Pythonu, které cílí na nasazení Azure. Šablony poskytují nejjednodušší pro vývoj webových aplikací v Pythonu. Můžete rychle vytvořit celé místní vývojové/hostitelské prostředí a prostředí nasazení pouze s několika pokyny příkazového řádku. Pracovní postup je jednoduchý a postup je snadno zapamatovatelný.
Po nastavení vývojových a hostitelských prostředí vám šablony poskytnou co nejrychleji začít vytvářet webovou aplikaci v Pythonu. Konfigurací souborů kódu šablony tak, aby splňovaly vaše konkrétní požadavky, můžete webovou aplikaci v Pythonu přizpůsobit v řádu minut.
Šablony vám také pomůžou postupovat podle zavedených strategií návrhu a vycházet z osvědčených postupů. Postupujte podle návrhů šablon a přidejte svůj kód tak, že budete stavět na pevných základech. Šablony se vytvářejí a spravují oboroví veteráni s rozsáhlým vývojovým prostředím v Pythonu v Azure.
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. Kód projektu obsahuje mnoho osvědčených postupů pro architektury a balíčky Pythonu vyžadované pro konkrétní sadu technologií. Šablona je určená jako výchozí bod pro vaši aplikaci. Podle potřeby přidáte nebo odeberete aplikační logiku a prostředky Azure.
- zřízení prostředků Azure. Prostředky Azure pro hostování webové aplikace a databáze zřídíte pomocí Bicep, oblíbeného nástroje infrastruktury jako kódu. 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. Automaticky nasadíte úvodní aplikaci. Tento přístup umožňuje rychle zkontrolovat spuštěný program a rozhodnout, co chcete upravit.
- (volitelné) Nastavení úložiště GitHub a kanálu CI/CD. Volitelně můžete nastavit úložiště GitHub, včetně kanálu GitHub Actions pro kontinuální integraci/průběžné doručování (CI/CD). Tento přístup umožňuje rychle provádět změny kódu webového projektu. Když tyto změny sloučíte do hlavní větve úložiště GitHub, kanál CI/CD je publikuje do nového hostitelského prostředí Azure.
Kde se dostanu k šablonám?
Mnoho azd šablon je k dispozici v galerii šablon Awesome Azure Developer CLI. Tato kolekce nabízí jedinečné webové azd šablony Pythonu, které poskytují ukázkovou webovou aplikaci s paritou funkcí v mnoha různých oblíbených kombinacích prostředků Azure a webových architektur Pythonu.
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.
Index šablon
Následující tabulka uvádí dostupné webové azd šablony Pythonu, které se mají použít s příkazem azd init, technologiemi implementovanými v každé šabloně a odkazem na úložiště GitHub, pokud chcete přispívat změnami.
Následující
| Š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 | https://github.com/Azure-Samples/azure-django-cosmos-postgres-aca |
| azure-django-cosmos-postgres-appservice | Azure Cosmos DB for Azure Database for 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 | 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.
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ů šablony máte osobní kopii původní šablony, kde můžete podle potřeby upravit libovolný soubor. Kód projektu Pythonu můžete upravit minimálně tak, aby projekt používal logiku návrhu a aplikace. 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 obnovení 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.
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:
- nasazení webové aplikace Flask nebo FastAPI ve službě Azure App Service
- kontejnerizované webové aplikace v Pythonu v Azure s využitím MongoDB
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é šablony azd se může lišit v závislosti na typu projektu a použitém podkladovém technologickém zásobníku. Šablony uvedené v tomto článku se řídí běžnou konvencí:
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 azd init se vytvoří složka .azure. 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. |
Rada
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.