Sdílet prostřednictvím

Přehled šablon azd webu v Pythonu

  • Článek

Šablony Azure Developer CLI (azd) v Pythonu jsou nejrychlejším a nejsnadnějším způsobem, jak začít se sestavováním a nasazováním webových aplikací Pythonu do Azure. Tento článek obsahuje kontextové informace o tom, jak začínáte.

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 místo toho postupovat podle rychlého startu pomocí GitHub Codespaces .

Co jsou šablony azd webu v Pythonu?

V galerii Awesome AZD Templates je k dispozici mnoho azd šablon. Tato kolekce webových azd šablon Pythonu je ale jedinečná, protože 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.

Když spustíte webovou azd šablonu Pythonu, budete:

  • Vytvořte úvodní aplikaci – konkrétně web pro fiktivní společnost s názvem Relecloud. Kód projektu obsahuje mnoho osvědčených postupů pro dané architektury a balíčky Pythonu, které jsou nezbytné pro konkrétní zásobník 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 – Šablona zřídí prostředky Azure pro hostování webové aplikace a databáze pomocí Bicep, oblíbeného nástroje pro infrastrukturu jako kód. Znovu upravíte šablony Bicep, pokud potřebujete přidat další služby Azure.
  • Nasaďte úvodní aplikaci do nově zřízených prostředků Azure – počáteční aplikace se automaticky nasadí, takže uvidíte, že všechno funguje během několika minut a rozhodnete se, co chcete upravit.
  • Volitelné: Nastavení úložiště GitHub a kanálu CI/CD – Pokud chcete, šablona obsahuje logiku pro nastavení úložiště GitHub pro vás, včetně kanálu CI/CD GitHub Actions. Během několika minut můžete 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.

Kdo je to pro?

Šablony mají být používány zkušenými webovými vývojáři Pythonu, kteří chtějí začít vytvářet novou webovou aplikaci Pythonu, která cílí na nasazení Azure.

Proč bych to chtěl(a) použít?

azd Použití šablon nabízí několik výhod:

  • Nejrychlejší možný začátek – s místním vývojovým prostředím a hostitelským nastavením prostředí se můžete soustředit na vytváření aplikace během několika minut.
  • Nejjednodušší spuštění – Provedením několika pokynů příkazového řádku sestavte celý místní vývoj, hostování a nasazení prostředí. Pracovní postup je snadno použitelný a snadno zapamatovatelný.
  • Stavět na osvědčených postupech – Každá šablona je vytvořená a udržována Pythonem na oborových veteránech Azure. Přidejte svůj kód podle svých přístupů k návrhu, abyste se mohli stavět na pevných základech.

Index šablon

Následující tabulka obsahuje seznam dostupných webových šablon Pythonu azd pro použití s příkazem azd init , technologie implementované v každé šabloně a odkaz na úložiště GitHub, pokud chcete přispívat změnami.

Šablona Webová architektura Databáze Platforma hostování Úložiště GitHub
azure-django-postgres-flexible-aca Django Flexibilní server PostgreSQL Azure Container Apps úložiště
azure-django-postgres-flexible-appservice Django Flexibilní server PostgreSQL Azure App Service úložiště
azure-django-cosmos-postgres-aca Django Cosmos DB (adaptér PostgreSQL) Azure Container Apps úložiště
azure-django-cosmos-postgres-appservice Django Cosmos DB (adaptér PostgreSQL) Azure App Service úložiště
azure-django-postgres-addon-aca Django Doplněk PostgreSQL pro Azure Container Apps Azure Container Apps úložiště

Jak šablony fungují?

K provádění úloh definovaných šablonou azd se používají různé azd příkazy. Tyto příkazy jsou podrobně popsané v článku Začínáme používat Azure Developer CLI.

Šablona azd se skládá z úložiště GitHub obsahující kód aplikace (kód Pythonu využívající oblíbenou webovou architekturu) a soubory infrastruktury jako kódu (konkrétně Bicep) k vytvoření prostředků Azure. Obsahuje také konfiguraci potřebnou k nastavení úložiště GitHub s kanálem CI/CD.

Rychlý start vás provede jednotlivými kroky pro použití konkrétní azd šablony. Vyžaduje pouze spuštění pěti instrukcí příkazového řádku do produkčního hostitelského prostředí a místního vývojového prostředí:

  1. azd init --template <template name> - vytvoří nový projekt ze šablony a vytvoří kopii kódu aplikace na 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 pojmenování nasazených prostředků.
  2. azd auth login – přihlásí vás 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čí. Tento azd auth login příkaz se vyžaduje jenom při prvním použití Azure Developer CLI (azd) pro každou relaci.
  3. azd up – zřídí cloudové prostředky a nasadí aplikaci do těchto prostředků.
  4. azd deploy - nasadí změny zdrojového kódu aplikace do prostředků, které jsou již zřízeny azd up.
  5. azd down – odstraní prostředky Azure a kanál CI/CD, pokud byl použit.

Tip

Podívejte se na výstup s azd výzvami, na které potřebujete odpovědět. Například po spuštění azd up příkazu se může zobrazit výzva k výběru předplatného, pokud patříte do více než jednoho. Kromě toho se zobrazí výzva k výběru 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í šablony máte osobní kopii původní šablony, kde můžete podle potřeby upravit každý soubor. Kód projektu Pythonu můžete minimálně upravit tak, aby projekt mohl mít logiku návrhu a aplikace. Pokud potřebujete změnit prostředky Azure, můžete také upravit konfiguraci infrastruktury jako kódu. Podívejte se na oddíl s názvem Co můžu upravit nebo odstranit?

Volitelné: Úprava a opětovné zřízení prostředků Azure

Pokud chcete změnit zřízené prostředky Azure, můžete upravit příslušné soubory Bicep v šabloně a použít:

  1. azd provision – znovu zřizuje prostředky Azure do požadovaného stavu, jak je definováno v souborech Bicep.

Nastavení kanálu CI/CD

Azure Developer CLI (azd) poskytuje snadný způsob, jak nastavit kanál CI/CD pro novou webovou aplikaci v Pythonu. Pokaždé, když sloučíte potvrzení nebo žádosti o přijetí změn do hlavní větve, kanál CI/CD automaticky sestaví a publikuje změny vašich prostředků Azure.

Volitelné: Automatické nastavení kanálu CI/CD GitHub Actions

Pokud chcete implementovat funkci kanálu CI/CD GitHub Actions, použijte následující příkaz:

  1. azd pipeline config – Umožňuje určit úložiště a nastavení GitHubu pro povolení kanálu CI\CD. Jakmile je nakonfigurovaná, 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.

Jaké jsou moje další možnosti?

Pokud nechcete používat azd šablony, můžete svou aplikaci v Pythonu nasadit do Azure a vytvářet prostředky Azure mnoha způsoby.

Mnoho kroků vytvoření a nasazení prostředků můžete provést pomocí jednoho z následujících nástrojů:

Nebo pokud hledáte ucelený kurz, který obsahuje architektury vývoje pro web v Pythonu, podívejte se na:

Musím používat Dev Containers?

Ne. Webové azd šablony Pythonu ve výchozím nastavení využívají Dev Containers . Dev Containers nabízí řadu výhod, ale vyžadují určité požadované znalosti a software. Pokud nechcete používat Dev Containers a nechcete místo toho používat místní vývojové prostředí, podívejte se na soubor README.md v kořenovém adresáři ukázkové aplikace, kde najdete pokyny k nastavení prostředí.

Co můžu upravit nebo odstranit?

Obsah každé azd šablony se může lišit v závislosti na typu projektu a použitém podkladovém zásobníku technologií. Šablony uvedené v tomto článku se řídí běžnou konvencí:

Složka/soubory Účel Popis
/ kořenový adresář Kořenový adresář obsahuje mnoho různých druhů souborů a složek pro mnoho různých účelů.
/.Azure azd konfigurační soubory Obsahuje proměnné prostředí, které používají příkazy Azure Developer CLI (azd). Tato složka se vytvoří po spuštění azd init příkazu. Můžete změnit hodnoty proměnných prostředí a přizpůsobit aplikaci a prostředky Azure. Další informace naleznete v souboru .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.
/.Github Konfigurace GitHub Actions Obsahuje nastavení konfigurace pro volitelný kanál CI/CD GitHub Actions a také lintování a testy. Soubor azure-dev.yaml je možné upravit nebo odstranit, pokud nechcete kanál GitHub Actions nastavit pomocí azd pipeline config příkazu.
/Infra Soubory Bicep Bicep umožňuje deklarovat prostředky Azure, které chcete nasadit do svého prostředí. Měli byste upravit pouze soubory main.bicep a web.bicep . Viz Rychlý start: Škálování služeb nasazených pomocí azd webových šablon Pythonu pomocí Bicep.
/Src soubory počátečního kódu projektu Obsahuje všechny šablony vyžadované webovou architekturou, statickými soubory, soubory .py pro logiku kódu a datové modely, atd requirements.txt. 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í šablony Používá se interně k vygenerování azd šablon. Tento soubor můžete bezpečně odstranit.
/.gitattributes atributy gitu Poskytuje gitu důležitou konfiguraci pro zpracování souborů a složek. Tento soubor můžete podle potřeby upravit.
/.gitignore Git ignore Říká Gitu, aby ignoroval zahrnutí souborů a složek do úložiště. Tento soubor můžete podle potřeby upravit.
/azure.yaml azd konfigurační soubor Obsahuje nastavení konfigurace pro azd up deklarování služeb a složek projektu, které budou nasazeny. Tento soubor nesmí být odstraněn.
/*.Md Soubory markdownu Existuje několik souborů markdownu pro různé účely. Tyto soubory můžete bezpečně odstranit.
/docker-compose.yml Docker Compose Vytvoří balíček kontejneru pro aplikaci před nasazením do Azure.
/pyproject.toml Systém sestavení Pythonu Obsahuje požadavky na systém sestavení projektů Pythonu. Tento soubor můžete upravit tak, aby zahrnoval upřednostňované nástroje (například pro použití linteru a architektury testování jednotek).
/requirements-dev.in soubor požadavků pip Používá se k vytvoření verze vývojového prostředí požadavků pomocí pip install -r příkazu. Tento soubor můžete podle potřeby upravit tak, aby zahrnoval další balíčky.

Tip

Používejte vhodné postupy správy verzí, abyste se mohli vrátit k určitému bodu v čase, kdy projekt fungoval, pokud něco nevysvětlovatelně přerušíte.

Nejčastější dotazy

Otázka: Při použití azd šablony došlo k chybě. Co mám dělat?

A: Viz řešení potíží s Azure Developer CLI. Můžete také nahlásit problémy v úložišti GitHub příslušné azd šablony.