Nasazení webové aplikace Python Django pomocí PostgreSQL v Azure

V tomto kurzu nasadíte webovou aplikaci Pythonu řízenou daty (Django) do služby Aplikace Azure Service s relační databázovou službou Azure Database for PostgreSQL. služba Aplikace Azure podporuje Python v linuxovém serverovém prostředí Pokud chcete, podívejte se na kurz Flasku nebo kurz FastAPI.

V tomto kurzu se naučíte:

• Vytvořte ve výchozím nastavení zabezpečenou architekturu služby App Service, PostgreSQL a mezipaměti Redis.
• Zabezpečení tajných kódů připojení pomocí spravované identity a odkazů na Key Vault
• Nasaďte ukázkovou aplikaci v Pythonu do služby App Service z úložiště GitHub.
• Přístup k připojovací řetězec služby App Service a nastavení aplikace v kódu aplikace
• Proveďte aktualizace a znovu nasaďte kód aplikace.
• Generování schématu databáze spuštěním migrací databází
• Streamování diagnostických protokolů z Azure
• Správa aplikace na webu Azure Portal
• Zřiďte stejnou architekturu a nasaďte ji pomocí Azure Developer CLI.
• Optimalizujte svůj vývojový pracovní postup pomocí GitHub Codespaces a GitHub Copilotu.

Požadavky

• Účet Azure s aktivním předplatným. Pokud účet Azure nemáte, můžete si ho zdarma vytvořit.
• Účet GitHub. můžete si ho zdarma získat.
• Znalost Pythonu s vývojem Django
• (Volitelné) Pokud chcete vyzkoušet GitHub Copilot, účet GitHub Copilot. K dispozici je 30denní bezplatná zkušební verze.

• Účet Azure s aktivním předplatným. Pokud účet Azure nemáte, můžete si ho zdarma vytvořit.
• Nainstalované rozhraní příkazového řádku pro vývojáře Azure Pomocí Azure Cloud Shellu můžete postupovat podle kroků, protože už má nainstalované rozhraní příkazového řádku Azure Developer CLI.
• Znalost Pythonu s vývojem Django
• (Volitelné) Pokud chcete vyzkoušet GitHub Copilot, účet GitHub Copilot. K dispozici je 30denní bezplatná zkušební verze.

Přeskočit na konec

Pokud chcete jenom zobrazit ukázkovou aplikaci v tomto kurzu spuštěném v Azure, stačí v Azure Cloud Shellu spustit následující příkazy a postupovat podle pokynů:

mkdir msdocs-django-postgresql-sample-app
cd msdocs-django-postgresql-sample-app
azd init --template msdocs-django-postgresql-sample-app
azd up

1. Spuštění ukázky

Nejprve nastavíte ukázkovou aplikaci řízenou daty jako výchozí bod. Ukázkové úložiště zahrnuje konfiguraci vývojového kontejneru. Vývojový kontejner má vše, co potřebujete k vývoji aplikace, včetně databáze, mezipaměti a všech proměnných prostředí potřebných ukázkovou aplikací. Vývojový kontejner se může spouštět v kódu GitHubu, což znamená, že ukázku můžete spustit na libovolném počítači s webovým prohlížečem.

Poznámka:

Pokud budete postupovat společně s tímto kurzem s vlastní aplikací, podívejte se na popis souboru requirements.txt v README.md a podívejte se, jaké balíčky budete potřebovat.

Krok 1: V novém okně prohlížeče:

1. Přihlaste se k účtu GitHub.
2. Přejděte na https://github.com/Azure-Samples/msdocs-django-postgresql-sample-app/fork.
3. Zrušte výběr možnosti Kopírovat pouze hlavní větev. Chcete všechny větve.
4. Vyberte Vytvořit fork.

Krok 2: Ve forku GitHubu:

1. Pro počáteční větev vyberte hlavní>počáteční-no-infra. Tato větev obsahuje pouze ukázkový projekt a žádné soubory ani konfiguraci související s Azure.
2. Vyberte Code>Create codespace on starter-no-infra. Nastavení codespace trvá několik minut a spustí pip install -r requirements.txt se pro úložiště na konci. Zadaný soubor .env již obsahuje fiktivní SECRET_KEY proměnnou, kterou Django potřebuje spustit místně.

Krok 3: V terminálu codespace:

1. Spusťte migrace databází pomocí python manage.py migratepříkazu .
2. Spusťte aplikaci pomocí python manage.py runserverpříkazu .
3. Až se zobrazí oznámení Your application running on port 8000 is available., vyberte Otevřít v prohlížeči. Ukázkovou aplikaci byste měli vidět na nové kartě prohlížeče. Chcete-li aplikaci zastavit, zadejte Ctrl+C.

Tip

O tomto úložišti můžete požádat GitHub Copilot . Příklad:

• @workspace Co tento projekt dělá?
• @workspace Co dělá složka .devcontainer?

Máte problémy? Projděte si část Řešení potíží.

2. Vytvoření služby App Service, databáze a mezipaměti

V tomto kroku vytvoříte prostředky Azure. Kroky použité v tomto kurzu vytvoří sadu prostředků zabezpečených ve výchozím nastavení, mezi které patří App Service, Azure Database for PostgreSQL a Azure Cache. Pro proces vytváření zadáte:

• Název webové aplikace. Používá se jako součást názvu DNS pro vaši aplikaci ve formě https://<app-name>-<hash>.<region>.azurewebsites.net.
• Oblast, ve které se má aplikace spouštět fyzicky na světě. Používá se také jako součást názvu DNS pro vaši aplikaci.
• Zásobník modulu runtime pro aplikaci. Tady vyberete verzi Pythonu, kterou chcete pro svou aplikaci použít.
• Plán hostování aplikace. Je to cenová úroveň, která zahrnuje sadu funkcí a kapacitu škálování vaší aplikace.
• Skupina prostředků pro aplikaci. Skupina prostředků umožňuje seskupovat (v logickém kontejneru) všechny prostředky Azure potřebné pro aplikaci.

Přihlaste se k webu Azure Portal a podle těchto kroků vytvořte prostředky služby Aplikace Azure Service.

Krok 1: Na webu Azure Portal:

1. Do vyhledávacího panelu v horní části webu Azure Portal zadejte "databáze webové aplikace".
2. Vyberte položku s popiskem Web App + Database pod nadpisem Marketplace . Můžete také přejít přímo do průvodce vytvořením.

Krok 2: Na stránce Vytvořit webovou aplikaci a databázi vyplňte formulář následujícím způsobem.

1. Skupina prostředků: Vyberte Vytvořit novou a použijte název msdocs-django-postgres-tutorial.
2. Oblast: Libovolná oblast Azure, která je blízko vás.
3. Název: msdocs-python-postgres-XYZ.
4. Zásobník modulu runtime: Python 3.12.
5. Databáze: Flexibilní server PostgreSQL je ve výchozím nastavení vybraný jako databázový stroj. Název serveru a název databáze jsou také standardně nastavené na odpovídající hodnoty.
6. Přidat Azure Cache for Redis: Ano.
7. Plán hostování: Basic. Až budete připraveni, můžete vertikálně navýšit kapacitu na cenovou úroveň produkčního prostředí.
8. Vyberte Zkontrolovat a vytvořit.
9. Po dokončení ověření vyberte Vytvořit.

Krok 3: Dokončení nasazení trvá několik minut. Po dokončení nasazení vyberte tlačítko Přejít k prostředku . Přejdete přímo do aplikace App Service, ale vytvoří se následující prostředky:

• Skupina prostředků: Kontejner pro všechny vytvořené prostředky.
• Plán služby App Service: Definuje výpočetní prostředky pro Službu App Service. Vytvoří se plán Linuxu na úrovni Basic .
• App Service: Představuje vaši aplikaci a spouští se v plánu služby App Service.
• Virtuální síť: Integrovaná s aplikací App Service a izoluje provoz back-endové sítě.
• Privátní koncový bod: Koncový bod přístupu pro mezipaměť Redis ve virtuální síti.
• Síťová rozhraní: Představuje privátní IP adresy, jednu pro každý privátní koncový bod.
• Flexibilní server Azure Database for PostgreSQL: Přístupný pouze z virtuální sítě. Databáze a uživatel se pro vás vytvoří na serveru.
• Azure Cache for Redis: Přístupné pouze ze své privátní sítě.
• Privátní DNS zón: Umožňuje překlad DNS databázového serveru do mezipaměti Redis ve virtuální síti.

3. Zabezpečení tajných kódů připojení a přidání SECRET_KEY

Průvodce vytvořením vygeneroval proměnné připojení, které už máte jako nastavení aplikace. Osvědčeným postupem zabezpečení je ale úplné zachování tajných kódů mimo službu App Service. Tajné kódy přesunete do trezoru klíčů a změníte nastavení aplikace na odkazy služby Key Vault pomocí konektorů služeb.

Krok 1: Načtení existujícího připojovací řetězec

1. V nabídce vlevo na stránce služby App Service vyberte Proměnné prostředí nastavení>.
2. Vyberte AZURE_POSTGRESQL_CONNECTIONSTRING.
3. V nastavení přidat/upravit aplikaci v poli Hodnota najděte heslo = část na konci řetězce.
4. Zkopírujte řetězec hesla za heslem= pro pozdější použití. Toto nastavení aplikace umožňuje připojit se k databázi Postgres a mezipaměti Redis zabezpečené za privátními koncovými body. Tajné kódy se ale ukládají přímo v aplikaci App Service, což není nejlepší. Změníte to. Kromě toho přidáte SECRET_KEY nastavení, které vyžaduje vaše aplikace Django.

Krok 2: Vytvoření trezoru klíčů pro zabezpečenou správu tajných kódů

1. Na horním panelu hledání zadejte "key vault" a pak vyberte Marketplace>Key Vault.
2. Ve skupině prostředků vyberte msdocs-python-postgres-tutorial.
3. Do názvu trezoru klíčů zadejte název, který se skládá jenom z písmen a číslic.
4. V oblasti ji nastavte na stejné umístění jako skupina prostředků.

Krok 3: Zabezpečení trezoru klíčů pomocí privátního koncového bodu

1. Vyberte kartu Sítě.
2. Zrušte výběr možnosti Povolit veřejný přístup.
3. Vyberte Vytvořit privátní koncový bod.
4. Ve skupině prostředků vyberte msdocs-python-postgres-tutorial.
5. V dialogovém okně v umístění vyberte stejné umístění jako vaše aplikace App Service.
6. Do pole Název zadejte msdocs-python-postgres-XYZVaultEndpoint.
7. Ve virtuální síti vyberte msdocs-python-postgres-XYZVnet.
8. V podsíti msdocs-python-postgres-XYZSubnet.
9. Vyberte OK.
10. Vyberte Zkontrolovat a vytvořit a pak Vytvořit. Počkejte na dokončení nasazení trezoru klíčů. Měla by se zobrazit informace o tom, že vaše nasazení je dokončené.

Krok 4: Konfigurace konektoru PostgreSQL

1. Na horním panelu hledání zadejte msdocs-python-postgres a pak vyberte prostředek služby App Service s názvem msdocs-python-postgres-XYZ.
2. Na stránce služby App Service v nabídce vlevo vyberte Konektor služby Nastavení>. Už existují dva konektory, které pro vás průvodce vytvořením aplikace vytvořil.
3. Zaškrtněte políčko vedle konektoru PostgreSQL a pak vyberte Upravit.
4. V typu Klient vyberte Django. Typ klienta Django v konektoru služby PostgreSQL poskytuje proměnné databáze v samostatných nastaveních místo jednoho připojovací řetězec. Samostatné proměnné jsou pro vás jednodušší používat v nastavení databáze Django.
5. Vyberte kartu Ověřování.
6. Do pole Heslo vložte dříve zkopírované heslo.
7. Vyberte Uložit tajný klíč ve službě Key Vault.
8. V části Připojení ke službě Key Vault vyberte Vytvořit nový. V horní části dialogového okna pro úpravy se otevře dialogové okno Vytvořit připojení .

Krok 5: Vytvoření připojení ke službě Key Vault

1. V dialogovém okně Vytvořit připojení pro připojení ke službě Key Vault vyberte ve službě Key Vault trezor klíčů, který jste vytvořili dříve.
2. Vyberte Zkontrolovat a vytvořit.
3. Po dokončení ověření vyberte Vytvořit.

Krok 6: Dokončení nastavení konektoru PostgreSQL

1. Jste zpátky v dialogovém okně pro úpravy pro defaultConnector. Na kartě Ověřování počkejte na vytvoření konektoru trezoru klíčů. Po dokončení ho rozevírací seznam Připojení ke službě Key Vault automaticky vybere.
2. Vyberte Další: Sítě.
3. Zvolte Uložit. Počkejte, až se zobrazí oznámení o úspěšném dokončení aktualizace.

Krok 7: Konfigurace konektoru Redis tak, aby používal tajné kódy služby Key Vault

1. Na stránce Konektory služeb zaškrtněte políčko vedle konektoru Cache for Redis a pak vyberte Upravit.
2. Vyberte kartu Ověřování.
3. Vyberte Uložit tajný klíč ve službě Key Vault.
4. V části Připojení ke službě Key Vault vyberte trezor klíčů, který jste vytvořili.
5. Vyberte Další: Sítě.
6. Výběrem možnosti Konfigurovat pravidla brány firewall povolte přístup k cílové službě. Průvodce vytvořením aplikace už databázi SQL zabezpečil privátním koncovým bodem.
7. Zvolte Uložit. Počkejte, až se zobrazí oznámení o úspěšném dokončení aktualizace.

Krok 8: Ověření integrace služby Key Vault

1. V nabídce vlevo znovu vyberte Proměnné prostředí nastavení>.
2. Vedle AZURE_POSTGRESQL_PASSWORD vyberte Zobrazit hodnotu. Hodnota by měla být @Microsoft.KeyVault(...), což znamená, že se jedná o odkaz na trezor klíčů, protože tajný klíč je teď spravovaný v trezoru klíčů.
3. Pokud chcete ověřit připojovací řetězec Redis, vyberte Zobrazit hodnotu vedle AZURE_REDIS_CONNECTIONSTRING.

Krok 9: Ukázková aplikace přečte proměnnou prostředí SECRET_KEY a nastaví požadované SECRET_KEY nastavení. V tomto kroku ho vytvoříte jako nastavení aplikace.

1. Na kartě Nastavení aplikace vyberte Přidat.
2. Nastavte název na SECRET_KEY.
3. Nastavte hodnotu na dlouhý náhodný řetězec.
4. Klikněte na Použít a pak znovu na Použít a pak Potvrďte.

Shrnutí: Proces zabezpečení tajných kódů připojení:

• Načítání tajných kódů připojení z proměnných prostředí aplikace App Service
• Vytvoření trezoru klíčů
• Vytvoření připojení ke službě Key Vault se spravovanou identitou přiřazenou systémem
• Aktualizace konektorů služby tak, aby ukládaly tajné kódy do trezoru klíčů.

Poznámka:

SECRET_KEY V ideálním případě by se nastavení aplikace mělo nakonfigurovat jako odkaz na trezor klíčů, což je proces s více kroky. Další informace najdete v tématu Návody změna nastavení aplikace SECRET_KEY na referenční informace ke službě Key Vault?

Máte problémy? Projděte si část Řešení potíží.

---

4. Nasazení ukázkového kódu

V tomto kroku nakonfigurujete nasazení GitHubu pomocí GitHub Actions. Je to jen jeden z mnoha způsobů nasazení do služby App Service, ale také skvělý způsob, jak mít kontinuální integraci v procesu nasazení. Ve výchozím nastavení spustí každá git push z vašich úložišť GitHub akci sestavení a nasazení.

Krok 1: V nabídce vlevo vyberte Deployment Center(Deployment Center).>

Krok 2: Na stránce Deployment Center:

1. Ve zdroji vyberte GitHub. Ve výchozím nastavení je jako zprostředkovatel sestavení vybrán GitHub Actions .
2. Přihlaste se ke svému účtu GitHub a postupujte podle pokynů k autorizaci Azure.
3. V organizaci vyberte svůj účet.
4. V úložišti vyberte msdocs-django-postgresql-sample-app.
5. Ve větvi vyberte starter-no-infra. Jedná se o stejnou větev, ve které jste pracovali s ukázkovou aplikací bez jakýchkoli souborů nebo konfigurace souvisejících s Azure.
6. Jako typ ověřování vyberte identitu přiřazenou uživatelem.
7. V horní nabídce vyberte Uložit. App Service potvrdí soubor pracovního postupu do zvoleného úložiště GitHub v .github/workflows adresáři. Ve výchozím nastavení centrum nasazení vytvoří identitu přiřazenou uživatelem pro pracovní postup k ověření pomocí ověřování Microsoft Entra (ověřování OIDC). Alternativní možnosti ověřování najdete v tématu Nasazení do služby App Service pomocí GitHub Actions.

Krok 3: Zpět v prostoru kódu GitHubu ukázkového forku spusťte git pull origin starter-no-infra. Tím se do vašeho prostoru kódu načte nově potvrzený soubor pracovního postupu.

Krok 4 (možnost 1: s GitHub Copilotem):

1. Začněte novou chatovací relaci výběrem zobrazení chatu a pak výběrem +možnosti .
2. Zeptejte se na @workspace Jak se aplikace připojuje k databázi a redis? Copilot vám může vysvětlit, jak se nastavení konfiguruje v azureproject/development.py a azureproject/production.py.
3. Zeptejte se, "@workspace V produkčním režimu je moje aplikace spuštěná ve webové aplikaci App Service, která používá konektor služby Azure k připojení k flexibilnímu serveru PostgreSQL pomocí typu klienta Django. Jaké jsou názvy proměnných prostředí, které potřebuji použít? Copilot vám může dát návrh kódu podobný návrhu v možnosti 2: bez níže uvedených kroků GitHub Copilotu a dokonce vám řekněte, abyste udělali změnu v souboru azureproject/production.py .
4. Otevřete azureproject/production.py v průzkumníku a přidejte návrh kódu.
5. Zeptejte se, "@workspace Moje aplikace App Service také používá konektor služby Azure Service pro připojení ke službě Cache for Redis pomocí typu klienta Django. Jaké jsou názvy proměnných prostředí, které potřebuji použít?*" Copilot vám může dát návrh kódu podobný návrhu v možnosti 2: bez kroků GitHub Copilot níže a dokonce vám řeknete, abyste udělali změnu v souboru azureproject/production.py .
6. Přidejte návrh kódu. GitHub Copilot vám pokaždé nedává stejnou odpověď a není vždy správná. Možná budete muset položit další otázky, abyste vyladili jeho odpověď. Tipy najdete v tématu Co můžu dělat s GitHub Copilotem v kódu?.

Krok 4 (možnost 2: bez GitHub Copilotu):

1. V průzkumníku otevřete Program.cs .
2. Najděte okomentovaný kód (řádky 29–48) a odkomentujte ho. Tím se vytvoří připojení PostgreSQL a Redis pomocí , AZURE_POSTGRESQL_USERAZURE_POSTGRESQL_PASSWORD, AZURE_POSTGRESQL_HOST, AZURE_POSTGRESQL_NAMEa AZURE_REDIS_CONNECTIONSTRING.

Krok 5:

1. Vyberte rozšíření správy zdrojového kódu .
2. Do textového pole zadejte zprávu potvrzení, například Configure Azure database and cache connectons. Nebo vyberte a nechte GitHub Copilot vygenerovat potvrzovací zprávu za vás.
3. Vyberte Potvrdit a potvrďte akci ano.
4. Vyberte Možnost Synchronizovat změny 1 a potvrďte akci OK.

Krok 6: Zpět na stránce Deployment Center na webu Azure Portal:

1. Vyberte kartu Protokoly a pak výběrem možnosti Aktualizovat zobrazte spuštění nového nasazení.
2. V položce protokolu pro spuštění nasazení vyberte položku Sestavit/Nasadit protokoly s nejnovějším časovým razítkem.

Krok 7: Přejdete do úložiště GitHub a zjistíte, že je spuštěná akce GitHubu. Soubor pracovního postupu definuje dvě samostatné fáze, sestavení a nasazení. Počkejte na spuštění GitHubu a zobrazte stav Úspěch. Trvá to asi 5 minut.

Máte problémy? Projděte si průvodce odstraňováním potíží.

5. Generování schématu databáze

S databází PostgreSQL chráněnou virtuální sítí je nejjednodušší způsob, jak spustit migrace databází Django, v relaci SSH s kontejnerem Linuxu ve službě App Service.

Krok 1: Zpět na stránce služby App Service v nabídce vlevo

1. Vyberte SSH vývojových nástrojů>.
2. Vyberte Přejít.

Krok 2: V relaci SSH spusťte python manage.py migratepříkaz . Pokud proběhne úspěšně, služba App Service se úspěšně připojuje k databázi.

Tip

V relaci SSH se změny souborů v /home můžou zachovat i po restartování aplikace. Změny mimo /home jiné se neuchovávají. Relace SSH je užitečná pro spouštění běžných python manage.py příkazů, jako je vytvoření uživatele pomocí python manage.py createsuperusernástroje . Další informace najdete v dokumentaci pro django django-admin a manage.py. Pro přístup /admin k části webu použijte účet superuživatele.

Máte problémy? Projděte si část Řešení potíží.

6. Přejděte do aplikace.

Krok 1: Na stránce služby App Service:

1. V nabídce vlevo vyberte Přehled.
2. Vyberte adresu URL aplikace.

Krok 2: Přidejte do seznamu několik restaurací. Blahopřejeme, spouštíte webovou aplikaci ve službě Aplikace Azure Service se zabezpečeným připojením ke službě Azure Database for PostgreSQL.

7. Streamování diagnostických protokolů

Aplikace Azure Service zachytává všechny protokoly konzoly, které vám pomůžou diagnostikovat problémy s aplikací. Ukázková aplikace obsahuje print() příkazy, které tuto funkci předvádějí, jak je znázorněno níže.

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

Krok 1: Na stránce služby App Service:

1. V nabídce vlevo vyberte Monitorování>protokolů služby App Service.
2. V části Protokolování aplikace vyberte Systém souborů.
3. V horní nabídce vyberte Uložit.

Krok 2: V nabídce vlevo vyberte Stream protokolu. Zobrazí se protokoly pro vaši aplikaci, včetně protokolů platformy a protokolů z kontejneru.

Přečtěte si další informace o protokolování v aplikacích Pythonu v řadě o nastavení služby Azure Monitor pro vaši aplikaci v Pythonu.

8. Vyčištění prostředků

Po dokončení můžete odstranit všechny prostředky z předplatného Azure odstraněním skupiny prostředků.

Krok 1: Na panelu hledání v horní části webu Azure Portal:

1. Zadejte název skupiny prostředků.
2. Vyberte tuto skupinu prostředků.

Krok 2: Na stránce skupiny prostředků vyberte Odstranit skupinu prostředků.

Krok 3:

1. Potvrďte odstranění zadáním názvu skupiny prostředků.
2. Vyberte Odstranit.

:

2. Vytvoření prostředků Azure a nasazení ukázkové aplikace

V tomto kroku vytvoříte prostředky Azure a nasadíte ukázkovou aplikaci do App Service v Linuxu. Kroky použité v tomto kurzu vytvoří sadu prostředků zabezpečení ve výchozím nastavení, které zahrnují App Service, Azure Database for PostgreSQL a Azure Cache for Redis.

Vývojový kontejner už má Azure Developer CLI (AZD).

1. V kořenovém adresáři úložiště spusťte azd initpříkaz .

   azd init --template python-app-service-postgresql-infra
   

2. Po zobrazení výzvy zadejte následující odpovědi:

   Otázka	Odpověď
   Aktuální adresář není prázdný. Chcete zde inicializovat projekt v adresáři<>?	Y
   Co chcete s těmito soubory dělat?	Zachovat stávající soubory beze změny
   Zadejte nový název prostředí.	Zadejte jedinečný název. Šablona AZD používá tento název jako součást názvu DNS vaší webové aplikace v Azure (<app-name>-<hash>.azurewebsites.net). Jsou povoleny alfanumerické znaky a spojovníky.

3. Přihlaste se k Azure spuštěním azd auth login příkazu a následujícím příkazem:

   azd auth login
   

4. Pomocí příkazu vytvořte potřebné prostředky azd provision Azure. Podle pokynů vyberte požadované předplatné a umístění prostředků Azure.

   azd provision
   

   Dokončení azd provision příkazu trvá přibližně 15 minut (mezipaměť Redis trvá nejvíce času). Později upravíte kód tak, aby fungoval se službou App Service a nasadíte změny pomocí azd deploy. Když je spuštěný, příkaz poskytuje zprávy o procesu zřizování a nasazení, včetně odkazu na nasazení v Azure.

   Tato šablona AZD obsahuje soubory (azure.yaml a adresář infrastruktury ), které ve výchozím nastavení generují zabezpečenou architekturu s následujícími prostředky Azure:

   • Skupina prostředků: Kontejner pro všechny vytvořené prostředky.
   • Plán služby App Service: Definuje výpočetní prostředky pro Službu App Service. Vytvoří se plán Linuxu na úrovni Basic .
   • App Service: Představuje vaši aplikaci a spouští se v plánu služby App Service.
   • Virtuální síť: Integrovaná s aplikací App Service a izoluje provoz back-endové sítě.
   • Privátní koncové body: Přístupové koncové body pro trezor klíčů a mezipaměť Redis ve virtuální síti.
   • Síťová rozhraní: Představuje privátní IP adresy, jednu pro každý privátní koncový bod.
   • Flexibilní server Azure Database for PostgreSQL: Přístupný pouze z virtuální sítě. Databáze a uživatel se pro vás vytvoří na serveru.
   • Privátní DNS zóna: Povolí překlad DNS serveru PostgreSQL ve virtuální síti.
   • Pracovní prostor Služby Log Analytics: Slouží jako cílový kontejner vaší aplikace k odeslání protokolů, kde můžete také dotazovat protokoly.
   • Azure Cache for Redis: Přístupné pouze z zákulisí svého privátního koncového bodu.
   • Trezor klíčů: Přístupný pouze ze svého privátního koncového bodu. Slouží ke správě tajných kódů pro aplikaci App Service.

   Jakmile příkaz dokončí vytváření prostředků a nasazení kódu aplikace poprvé, nasazená ukázková aplikace ještě nefunguje, protože musíte provést malé změny, abyste se mohli připojit k databázi v Azure.

Máte problémy? Projděte si část Řešení potíží.

3. Použití připojovací řetězec databáze

Šablona AZD, kterou použijete, vygenerovala proměnné připojení, které jste už použili jako nastavení aplikace, a vypíše je do terminálu, aby vám to vyhovuje. Nastavení aplikace je jedním ze způsobů, jak udržovat tajné kódy připojení mimo úložiště kódu.

1. Ve výstupu AZD vyhledejte nastavení AZURE_POSTGRESQL_USER, AZURE_POSTGRESQL_PASSWORD, AZURE_POSTGRESQL_HOST, AZURE_POSTGRESQL_NAMEa AZURE_REDIS_CONNECTIONSTRING. Pokud chcete tajné kódy zachovat v bezpečí, zobrazí se jenom názvy nastavení. Ve výstupu AZD vypadají takto:

    App Service app has the following connection settings:
            - AZURE_POSTGRESQL_NAME
            - AZURE_POSTGRESQL_HOST
            - AZURE_POSTGRESQL_USER
            - AZURE_POSTGRESQL_PASSWORD
            - AZURE_REDIS_CONNECTIONSTRING
            - AZURE_KEYVAULT_RESOURCEENDPOINT
            - AZURE_KEYVAULT_SCOPE
    

2. Šablona AZD vám pro usnadnění práci ukáže přímý odkaz na stránku nastavení aplikace. Najděte odkaz a otevřete ho na nové kartě prohlížeče.

Máte problémy? Projděte si část Řešení potíží.

4. Úprava vzorového kódu a opětovné nasazení

Pomocí GitHub Copilotu

1. V codespace GitHubu spusťte novou chatovací relaci tak , že vyberete zobrazení Chat a pak vyberete +.

2. Zeptejte se na @workspace Jak se aplikace připojuje k databázi? Copilot vám může vysvětlit, jak se nastavení připojení konfiguruje v azureproject/development.py a azureproject/production.py.

3. Zeptejte se, "@workspace V produkčním režimu je moje aplikace spuštěná ve webové aplikaci App Service, která používá konektor služby Azure k připojení k flexibilnímu serveru PostgreSQL pomocí typu klienta Django. Jaké jsou názvy proměnných prostředí, které potřebuji použít? Copilot vám může dát návrh kódu podobný návrhu v možnosti 2: bez níže uvedených kroků GitHub Copilotu a dokonce vám řekněte, abyste udělali změnu v souboru azureproject/production.py .

4. Otevřete azureproject/production.py v průzkumníku a přidejte návrh kódu.

   GitHub Copilot vám pokaždé nedává stejnou odpověď a není vždy správná. Možná budete muset položit další otázky, abyste vyladili jeho odpověď. Tipy najdete v tématu Co můžu dělat s GitHub Copilotem v kódu?.

5. V terminálu spusťte azd deploy.

   azd deploy
   

Bez GitHub Copilotu

1. Musíte použít pět nastavení aplikace pro připojení ve službě App Service. Otevřete azureproject/production.py, odkomentujte následující řádky (řádky 29–48) a uložte soubor:

   DATABASE_URI = 'postgresql+psycopg2://{dbuser}:{dbpass}@{dbhost}/{dbname}'.format(
       dbuser=os.getenv('AZURE_POSTGRESQL_USER'),
       dbpass=os.getenv('AZURE_POSTGRESQL_PASSWORD'),
       dbhost=os.getenv('AZURE_POSTGRESQL_HOST'),
       dbname=os.getenv('AZURE_POSTGRESQL_NAME')
   )
   
   CACHES = {
           "default": {  
               "BACKEND": "django_redis.cache.RedisCache",
               "LOCATION": os.environ.get('AZURE_REDIS_CONNECTIONSTRING'),
               "OPTIONS": {
                   "CLIENT_CLASS": "django_redis.client.DefaultClient",
                   "COMPRESSOR": "django_redis.compressors.zlib.ZlibCompressor",
           },
       }
   }
   

   Kód aplikace je teď nakonfigurovaný tak, aby se připojil k databázi PostgreSQL a mezipaměti Redis v Azure.

   ---

2. V terminálu spusťte azd deploy.

   azd deploy
   

Poznámka:

Pokud spustíte azd up, zkombinuje azd packageazd provision, a azd deploy. Důvodem, proč jste to na začátku neudělali, bylo to, že jste ještě neměli nastavení připojení PostgreSQL k úpravě kódu. Pokud jste pak spustili azd up , fáze nasazení by se zastavila, protože server Gunicorn by nemohl spustit aplikaci bez platného nastavení připojení. Obecně ale můžete tyto příkazy znovu spustit, když provedete změny v šabloně AZD nebo v kódu.

Máte problémy? Projděte si část Řešení potíží.

5. Generování schématu databáze

S databází PostgreSQL chráněnou virtuální sítí je nejjednodušší způsob, jak spustit migrace databází Django, v relaci SSH s kontejnerem Linuxu ve službě App Service.

1. Ve výstupu AZD vyhledejte adresu URL relace SSH a přejděte na ni v prohlížeči. Ve výstupu to vypadá takto:

    Open SSH session to App Service container at: https://<app-name>.scm.azurewebsites.net/webssh/host
    

2. V relaci SSH spusťte python manage.py migratepříkaz . Pokud proběhne úspěšně, služba App Service se úspěšně připojuje k databázi.

   

   Poznámka:

   Kromě restartování aplikace se můžou zachovat jenom změny v /home souborech. Změny mimo /home jiné se neuchovávají.

Máte problémy? Projděte si část Řešení potíží.

6. Přejděte do aplikace.

1. Ve výstupu AZD najděte adresu URL aplikace a přejděte na ni v prohlížeči. Adresa URL vypadá takto ve výstupu AZD:

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>.azurewebsites.net/
    

2. Přidejte do seznamu několik restaurací.

   

   Blahopřejeme, spouštíte webovou aplikaci ve službě Aplikace Azure Service se zabezpečeným připojením ke službě Azure Database for PostgreSQL.

Máte problémy? Projděte si část Řešení potíží.

7. Streamování diagnostických protokolů

Aplikace Azure Služba může zaznamenávat protokoly konzoly, které vám pomůžou diagnostikovat problémy s aplikací. Pro usnadnění přístupu už šablona AZD umožňuje protokolování do místního systému souborů a odesílá protokoly do pracovního prostoru služby Log Analytics.

Ukázková aplikace obsahuje print() příkazy k předvedení této funkce, jak je znázorněno v následujícím fragmentu kódu.

def index(request):
    print('Request for index page received')
    restaurants = Restaurant.objects.annotate(avg_rating=Avg('review__rating')).annotate(review_count=Count('review'))
    lastViewedRestaurant = request.session.get("lastViewedRestaurant", False)

Ve výstupu AZD vyhledejte odkaz na streamování protokolů služby App Service a přejděte na něj v prohlížeči. Odkaz vypadá takto ve výstupu AZD:

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

Přečtěte si další informace o protokolování v aplikacích Pythonu v řadě o nastavení služby Azure Monitor pro vaši aplikaci v Pythonu.

Máte problémy? Projděte si část Řešení potíží.

8. Vyčištění prostředků

Pokud chcete odstranit všechny prostředky Azure v aktuálním prostředí nasazení, spusťte azd down a postupujte podle pokynů.

azd down

Řešení problému

Níže jsou uvedené problémy, se kterými se můžete setkat při pokusu o práci v tomto kurzu a postupu při jejich řešení.

Nemůžu se připojit k relaci SSH

Pokud se nemůžete připojit k relaci SSH, nepovedlo se spustit samotnou aplikaci. Podrobnosti najdete v diagnostických protokolech . Pokud se například zobrazí nějaká chyba KeyError: 'AZURE_POSTGRESQL_HOST', může to znamenat, že proměnná prostředí chybí (možná jste odebrali nastavení aplikace).

Při spouštění migrací databází se zobrazí chyba

Pokud dojde k nějakým chybám souvisejícím s připojením k databázi, zkontrolujte, jestli se nastavení aplikace (AZURE_POSTGRESQL_USER, AZURE_POSTGRESQL_PASSWORDAZURE_POSTGRESQL_HOSTa AZURE_POSTGRESQL_NAME) nezměnilo nebo odstranilo. Bez toho připojovací řetězec nemůže migrovat příkaz komunikovat s databází.

Nejčastější dotazy

• Kolik stojí toto nastavení?
• Návody se připojit k serveru PostgreSQL, který je zabezpečený za virtuální sítí pomocí jiných nástrojů?
• Jak místní vývoj aplikací funguje s GitHub Actions?
• Jak je ukázka Django nakonfigurovaná tak, aby běžela ve službě Aplikace Azure Service?
• Návody změnit nastavení aplikace SECRET_KEY na referenční informace ke službě Key Vault?
• Návody chyby ladění během nasazení GitHub Actions?
• Nemám oprávnění k vytvoření identity přiřazené uživatelem
• Co můžu dělat s GitHub Copilotem v kódu?

• Kolik stojí toto nastavení?
• Návody se připojit k serveru PostgreSQL, který je zabezpečený za virtuální sítí pomocí jiných nástrojů?
• Jak místní vývoj aplikací funguje s GitHub Actions?
• Jak je ukázka Django nakonfigurovaná tak, aby běžela ve službě Aplikace Azure Service?
• Návody chyby ladění během nasazení GitHub Actions?
• Nemám oprávnění k vytvoření identity přiřazené uživatelem
• Co můžu dělat s GitHub Copilotem v kódu?

Kolik stojí toto nastavení?

Ceny vytvořených prostředků jsou následující:

• Plán služby App Service se vytvoří na úrovni Basic a dá se vertikálně navýšit nebo snížit. Podívejte se na ceny služby App Service.
• Flexibilní server PostgreSQL se vytváří v nejnižší vrstvě s možností nárazového škálování Standard_B1ms s minimální velikostí úložiště, kterou je možné vertikálně navýšit nebo snížit. Podívejte se na ceny služby Azure Database for PostgreSQL.
• Za virtuální síť se neúčtují poplatky, pokud nenakonfigurujete další funkce, jako je partnerský vztah. Podívejte se na ceny služby Azure Virtual Network.
• Za privátní zónu DNS se účtují malé poplatky. Podívejte se na ceny Azure DNS.

Návody se připojit k serveru PostgreSQL, který je zabezpečený za virtuální sítí pomocí jiných nástrojů?

• Základní přístup z nástroje příkazového řádku můžete spustit psql z relace SSH aplikace.
• Pokud se chcete připojit z desktopového nástroje, musí být váš počítač ve virtuální síti. Může to být například virtuální počítač Azure, který je připojený k jedné z podsítí, nebo počítač v místní síti, který má připojení VPN typu site-to-site s virtuální sítí Azure.
• Azure Cloud Shell můžete také integrovat s virtuální sítí.

Jak místní vývoj aplikací funguje s GitHub Actions?

Když jako příklad použijete automaticky vygenerovaný soubor pracovního postupu ze služby App Service, spustí se nové git push sestavení a nasazení. Z místního klonu úložiště GitHub provedete požadované aktualizace a nasdílíte je na GitHub. Příklad:

git add .
git commit -m "<some-message>"
git push origin main

Jak je ukázka Django nakonfigurovaná tak, aby běžela ve službě Aplikace Azure Service?

Ukázková aplikace Django konfiguruje nastavení v souboru azureproject/production.py tak, aby se mohlo spustit ve službě Aplikace Azure Service. Tyto změny jsou běžné pro nasazení Django do produkčního prostředí, a ne specifické pro Službu App Service.

• Django ověří hlavičku HTTP_HOST příchozích požadavků. Ukázkový kód používá proměnnou WEBSITE_HOSTNAME prostředí ve službě App Service k přidání názvu domény aplikace do nastavení ALLOWED_HOSTS Django.

  # Configure the domain name using the environment variable
  # that Azure automatically creates for us.
  ALLOWED_HOSTS = [os.environ['WEBSITE_HOSTNAME']] if 'WEBSITE_HOSTNAME' in os.environ else []
  

• Django nepodporuje obsluhu statických souborů v produkčním prostředí. Pro účely tohoto kurzu použijete WhiteNoise k povolení obsluhy souborů. Balíček WhiteNoise byl již nainstalován s requirements.txt a jeho middleware se přidá do seznamu.

  
  # WhiteNoise configuration
  MIDDLEWARE = [
      'django.middleware.security.SecurityMiddleware',
      # Add whitenoise middleware after the security middleware
      'whitenoise.middleware.WhiteNoiseMiddleware',
  

  Nastavení statického souboru se pak nakonfiguruje podle dokumentace Django.

  SESSION_ENGINE = "django.contrib.sessions.backends.cache"
  STATICFILES_STORAGE = 'whitenoise.storage.CompressedManifestStaticFilesStorage'
  

Další informace naleznete v tématu Produkční nastavení pro aplikace Django.

Návody změnit nastavení aplikace SECRET_KEY na referenční informace ke službě Key Vault?

Z výše uvedeného postupu na portálu můžete přejít SECRET_KEY na referenci služby Key Vault spuštěním následujících příkazů Azure CLI v Cloud Shellu:

# Change the following variables to match your environment
SUBSCRIPTION_ID=<subscription-id>
RESOURCE_GROUP=<resource-group-name>
KEY_VAULT_NAME=<key-vault-name>
APP_SERVICE_NAME=<app-name>
SECRET_NAME=djangoSecretKey

# Set the subscription ID
az account set --subscription $SUBSCRIPTION_ID

# Assign 'Key Vault Secrets Officer' role to your user at the scope of the key vault
az role assignment create \
  --assignee $(az ad signed-in-user show --query id -o tsv) \
  --role $(az role definition list --name "Key Vault Secrets Officer" --query "[].id" -o tsv) \
  --scope $(az keyvault show --name $KEY_VAULT_NAME --resource-group $RESOURCE_GROUP --query id --output tsv)

# Add the secret to the key vault
az keyvault secret set \
  --vault-name $KEY_VAULT_NAME \
  --name $SECRET_NAME \
  --value $(python -c 'import secrets; print(secrets.token_hex())')

# Add Key Vault reference to the App Service configuration
az webapp config appsettings set \
  --resource-group $RESOURCE_GROUP \
  --name $APP_SERVICE_NAME \
  --settings "SECRET_KEY=@Microsoft.KeyVault(SecretUri=https://$KEY_VAULT_NAME.vault.azure.net/secrets/$SECRET_NAME)"

Totéž můžete udělat i na portálu. Další informace naleznete v tématu:

1. Přiřazení role oboru služby Key Vault
2. Přidání tajného kódu do služby Key Vault
3. Načtení tajného klíče ze služby Key Vault
4. Konfigurace nastavení aplikace

Návody chyby ladění během nasazení GitHub Actions?

Pokud v automaticky vygenerovaném souboru pracovního postupu GitHubu selže krok, zkuste upravit neúspěšný příkaz a vygenerovat více podrobného výstupu. Můžete například získat další výstup z python příkazu přidáním -d možnosti. Potvrďte a nasdílejte změny, aby se aktivovalo další nasazení do služby App Service.

Nemám oprávnění k vytvoření identity přiřazené uživatelem

Viz Nastavení nasazení GitHub Actions z Centra nasazení.

Co můžu dělat s GitHub Copilotem v kódu?

Možná jste si všimli, že zobrazení chatu GitHub Copilot už pro vás bylo při vytváření prostoru kódu. Pro usnadnění práce zahrneme rozšíření chatu GitHub Copilot do definice kontejneru (viz .devcontainer/devcontainer.json). Potřebujete ale účet GitHub Copilot (k dispozici je 30denní bezplatná zkušební verze).

Několik tipů pro vás při komunikaci s GitHub Copilotem:

• V rámci jedné chatové relace se otázky a odpovědi vzájemně staví a otázky můžete upravit tak, aby vyladily odpověď, kterou získáte.
• GitHub Copilot ve výchozím nastavení nemá přístup k žádnému souboru ve vašem úložišti. Pokud chcete položit otázky k souboru, otevřete ho nejprve v editoru.
• Pokud chcete, aby GitHub Copilot měl při přípravě odpovědí přístup ke všem souborům v úložišti, začněte svou otázkou @workspace. Další informace najdete na webu Use the @workspace agent.
• V chatové relaci může GitHub Copilot navrhovat změny a (s @workspace) dokonce i tam, kde se mají změny provádět, ale změny za vás nesmí provádět. Je na vás přidat navrhované změny a otestovat je.

Další kroky

V dalším kurzu se dozvíte, jak zabezpečit aplikaci pomocí vlastní domény a certifikátu.

  Zabezpečení s využitím vlastní domény a certifikátu

Zjistěte, jak App Service spouští aplikaci v Pythonu:

Konfigurace aplikace v Pythonu