Nasazení webové aplikace v Pythonu (Django nebo Flask) pomocí PostgreSQL v Azure

Článek
12/20/2024

V tomto kurzu nasadíte webovou aplikaci Pythonu řízenou daty (Django nebo Flask) do služby Aplikace Azure Service pomocí služby relační databáze Azure Database for PostgreSQL. služba Aplikace Azure podporuje Python v linuxovém serverovém prostředí

K dokončení tohoto kurzu budete potřebovat:

Účet Azure s aktivním předplatným. Pokud účet Azure nemáte, můžete si ho zdarma vytvořit.
Znalost Pythonu s vývojem ve Flasku nebo Pythonu s vývojem v Django

Úč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 ve Flasku nebo Pythonu s vývojem v Django

Baňka
Django

S nainstalovaným rozhraním příkazového řádku pro vývojáře Azure můžete nasadit plně nakonfigurovanou ukázkovou aplikaci zobrazenou v tomto kurzu a zobrazit ji spuštěnou v Azure. Stačí spustit následující příkazy v prázdném pracovním adresáři:

azd auth login
azd init --template msdocs-flask-postgresql-sample-app
azd up

S nainstalovaným rozhraním příkazového řádku Pro vývojáře Azure můžete přeskočit na konec kurzu spuštěním následujících příkazů v prázdném pracovním adresáři:

azd auth login
azd init --template msdocs-django-postgresql-sample-app
azd up

Ukázková aplikace

Ukázkové aplikace Pythonu využívající architekturu Flask a Django vám pomůžou postupovat podle tohoto kurzu. Pokud je chcete nasadit bez místního spuštění, přeskočte tuto část.

Pokud chcete aplikaci spustit místně, ujistěte se, že máte místně nainstalovaný Python 3.7 nebo novější a PostgreSQL . Potom naklonujte větev ukázkového úložiště starter-no-infra a přejděte do kořenového adresáře úložiště.

Baňka
Django

git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app
cd msdocs-flask-postgresql-sample-app

Vytvořte soubor .env , jak je znázorněno níže, pomocí souboru .env.sample jako průvodce. Nastavte hodnotu DBNAME na název existující databáze v místní instanci PostgreSQL. Nastavte hodnoty parametru DBHOST, DBUSERa DBPASS podle potřeby pro místní instanci PostgreSQL.

DBNAME=<database name>
DBHOST=<database-hostname>
DBUSER=<db-user-name>
DBPASS=<db-password>

git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-django-postgresql-sample-app
cd msdocs-django-postgresql-sample-app

DBNAME=<database name>
DBHOST=<database-hostname>
DBUSER=<db-user-name>
DBPASS=<db-password>

Spuštěním následujícího příkazu na příkazovém řádku terminálu vytvořte pro aplikaci hodnotu SECRET_KEY: python -c 'import secrets; print(secrets.token_hex())'

Nastavte vrácenou hodnotu jako hodnotu SECRET_KEY v souboru .env.

SECRET_KEY=<secret-key>

Vytvořte pro aplikaci virtuální prostředí:

Windows
macOS/Linux

py -m venv .venv
.venv\scripts\activate

python3 -m venv .venv
source .venv/bin/activate

Nainstalujte závislosti:

pip install -r requirements.txt

Spusťte ukázkovou aplikaci pomocí následujících příkazů:

Baňka
Django

# Run database migration
flask db upgrade
# Run the app at http://127.0.0.1:5000
flask run

# Run database migration
python manage.py migrate
# Run the app at http://127.0.0.1:8000
python manage.py runserver

1. Vytvoření služby App Service a PostgreSQL

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í, které zahrnují App Service a Azure Database for PostgreSQL. Pro proces vytváření zadáte:

Název webové aplikace. Jedná se o název, který se používá jako součást názvu DNS pro webovou aplikaci ve formě https://<app-name>.azurewebsites.net.
Oblast, ve které se má aplikace spouštět fyzicky na světě.
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.

Baňka
Django

Krok 1: Na webu Azure Portal:

Do vyhledávacího panelu v horní části webu Azure Portal zadejte "databáze webové aplikace".
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.

Skupina prostředků → Vyberte vytvořit novou a použijte název msdocs-python-postgres-tutorial.
Oblast → Libovolná oblast Azure blízko vás.
Název → msdocs-python-postgres-XYZ , kde XYZ je jakékoli tři náhodné znaky. Tento název musí být v rámci služby Azure jedinečný.
Zásobník modulu runtime → Python 3.10
Jako databázový stroj je ve výchozím nastavení vybrán databázový → Flexibilní server PostgreSQL. Název serveru a název databáze jsou také standardně nastavené na odpovídající hodnoty.
Plán hostování → Basic. Až budete připraveni, můžete později vertikálně navýšit kapacitu na cenovou úroveň produkčního prostředí.
Vyberte Zkontrolovat a vytvořit.
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 služby App Service. Vytvoří se plán Linuxu na úrovni Basic .
→ App Service Představuje vaši aplikaci a běží v plánu služby App Service.
Virtuální síť → integrovaná s aplikací App Service a izoluje back-endový síťový provoz.
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ónu → Umožňuje překlad DNS serveru PostgreSQL ve virtuální síti.

2. Zabezpečení tajných kódů připojení

Průvodce vytvořením vygeneroval řetězec připojení k databázi pro vás již 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 referenční informace ke službě Key Vault pomocí konektorů služeb.

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

V nabídce vlevo na stránce služby App Service vyberte Proměnné prostředí nastavení>.
Vyberte AZURE_POSTGRESQL_CONNECTIONSTRING.
V nastavení přidat/upravit aplikaci v poli Hodnota najděte heslo = část na konci řetězce.
Zkopírujte řetězec hesla za heslem = pro pozdější použití. Toto nastavení aplikace umožňuje připojit se k databázi Postgres zabezpečenou za privátním koncovým bodem. Tajný kód se ale uloží přímo v aplikaci App Service, což není nejlepší. Změníte to.

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

Na horním panelu hledání zadejte "key vault" a pak vyberte Marketplace>Key Vault.
Ve skupině prostředků vyberte msdocs-python-postgres-tutorial.
Do názvu trezoru klíčů zadejte název, který se skládá jenom z písmen a číslic.
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

Vyberte kartu Sítě.
Zrušte výběr možnosti Povolit veřejný přístup.
Vyberte Vytvořit privátní koncový bod.
Ve skupině prostředků vyberte msdocs-python-postgres-tutorial.
Do pole Název zadejte název privátního koncového bodu, který se skládá jenom z písmen a číslic.
V oblasti ji nastavte na stejné umístění jako skupina prostředků.
V dialogovém okně v umístění vyberte stejné umístění jako vaše aplikace App Service.
Ve skupině prostředků vyberte msdocs-python-postgres-tutorial.
Do pole Název zadejte msdocs-python-postgres-XYZVaultEndpoint.
Ve virtuální síti vyberte msdocs-python-postgres-XYZVnet.
V podsíti msdocs-python-postgres-XYZSubnet.
Vyberte OK.
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 služby

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.
Na stránce služby App Service v nabídce vlevo vyberte Konektor služby Nastavení>. Konektor, který pro vás vytvořil průvodce vytvořením aplikace, už existuje.
Zaškrtněte políčko vedle spojnice a pak vyberte Upravit.
Na kartě Základy v části Databáze PostgreSQL vyberte vytvořenou databázi PostgreSQL.
Vyberte kartu Ověřování.
Do pole Heslo vložte dříve zkopírované heslo.
Vyberte Uložit tajný klíč ve službě Key Vault.
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

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.
Vyberte Zkontrolovat a vytvořit.
Po dokončení ověření vyberte Vytvořit.

Krok 6: Dokončení konfigurace konektoru služby

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.
Vyberte Další: Sítě.
Zvolte Uložit. Počkejte, až se zobrazí oznámení o úspěšném dokončení aktualizace.

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

V nabídce vlevo znovu vyberte Proměnné prostředí nastavení>.
Vedle AZURE_POSTGRESQL_CONNECTIONSTRING 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íčů.

Tento proces zahrnoval načtení připojovací řetězec PostgreSQL z proměnných prostředí služby App Service, vytvoření služby Azure Key Vault pro zabezpečenou správu tajných kódů s privátním přístupem a aktualizaci konektoru služby tak, aby ukládaly heslo do trezoru klíčů. Zabezpečené připojení mezi aplikací služby App Service a trezorem klíčů bylo vytvořeno pomocí spravované identity přiřazené systémem a nastavení bylo ověřeno potvrzením, že připojovací řetězec používá referenci ke službě Key Vault.

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

3. 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í.

Baňka
Django

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

Přihlaste se k účtu GitHub.
Přejděte na https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app.
Vyberte Fork.
Vyberte Vytvořit fork.

Krok 2: Na stránce GitHubu otevřete Visual Studio Code v prohlížeči stisknutím klávesy . .

Krok 3: V editoru Visual Studio Code v prohlížeči otevřete azureproject/production.py v průzkumníku. Podívejte se na proměnné prostředí používané v produkčním prostředí, včetně nastavení aplikace, která jste viděli na stránce konfigurace.

Krok 4: Zpět na stránce služby App Service v nabídce vlevo vyberte Deployment Center.

Krok 5: Na stránce Deployment Center:

Ve zdroji vyberte GitHub. Ve výchozím nastavení je jako zprostředkovatel sestavení vybrán GitHub Actions .
Přihlaste se ke svému účtu GitHub a postupujte podle pokynů k autorizaci Azure.
V organizaci vyberte svůj účet.
V úložišti vyberte msdocs-flask-postgresql-sample-app.
Ve větvi vyberte hlavní.
Ponechte výchozí možnost vybranou pro přidání pracovního postupu.
V části Typ ověřování vyberte Identitu přiřazenou uživatelem.
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.

Krok 6: Na stránce Deployment Center:

Vyberte Protokoly. Spuštění nasazení je již spuštěno.
V položce protokolu pro spuštění nasazení vyberte Sestavit/Nasadit protokoly.

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, aby se zobrazil stav Dokončeno. Trvá to asi 5 minut.

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

Přihlaste se k účtu GitHub.
Přejděte na https://github.com/Azure-Samples/msdocs-django-postgresql-sample-app.
Vyberte Fork.
Vyberte Vytvořit fork.

Krok 2: Na stránce GitHubu otevřete Visual Studio Code v prohlížeči stisknutím klávesy . .

Krok 4: Zpět na stránce služby App Service v nabídce vlevo vyberte Deployment Center.

Krok 5: Na stránce Deployment Center:

Ve zdroji vyberte GitHub. Ve výchozím nastavení je jako zprostředkovatel sestavení vybrán GitHub Actions .
Přihlaste se ke svému účtu GitHub a postupujte podle pokynů k autorizaci Azure.
V organizaci vyberte svůj účet.
V úložišti vyberte msdocs-django-postgresql-sample-app.
Ve větvi vyberte hlavní.
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.

Krok 6: Na stránce Deployment Center:

Vyberte Protokoly. Spuštění nasazení je již spuštěno.
V položce protokolu pro spuštění nasazení vyberte Sestavit/Nasadit protokoly.

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

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

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

Vyberte SSH.
Vyberte Přejít.

Krok 2: V terminálu SSH spusťte flask db upgradepříkaz . Pokud proběhne úspěšně, služba App Service se úspěšně připojuje k databázi. Kromě restartování aplikace se můžou zachovat jenom změny v /home souborech. Změny mimo /home jiné se neuchovávají.

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

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

Vyberte SSH.
Vyberte Přejít.

Krok 2: V terminálu 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. Kromě restartování aplikace se můžou zachovat jenom změny v /home souborech. Změny mimo /home jiné se neuchovávají.

Tip

V relaci SSH můžete pro Django také vytvářet uživatele pomocí python manage.py createsuperuser příkazu, jako byste měli typickou aplikaci Django. Další informace najdete v dokumentaci pro django django-admin a manage.py. Pro přístup /admin k části webu použijte účet superuživatele. Pro Flask použijte rozšíření, jako je Flask-admin , aby poskytoval stejné funkce.

5. Přejděte do aplikace.

Baňka
Django

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

V nabídce vlevo vyberte Přehled.
Vyberte adresu URL aplikace. Můžete také přejít přímo na https://<app-name>.azurewebsites.net.

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.

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

V nabídce vlevo vyberte Přehled.
Vyberte adresu URL aplikace. Můžete také přejít přímo na https://<app-name>.azurewebsites.net.

Na domovské stránce je vidět, že název poslední navštívené restaurace a data se ukládají do mezipaměti Azure a načítají se z mezipaměti Azure. Nezapomeňte, že ukázková aplikace používá připojovací řetězec AZURE_REDIS_CONNECTIONSTRING, kterou pro vás vytvořil průvodce.

6. Streamování diagnostických protokolů

Aplikace Azure Služba zachytává všechny zprávy výstupu do konzoly, aby vám pomohla 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.

Baňka
Django

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

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:

V nabídce vlevo vyberte protokoly služby App Service.
V části Protokolování aplikace vyberte Systém souborů.
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.

7. 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:

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

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

Krok 3:

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

1. 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ých ve výchozím nastavení, které zahrnují App Service a Azure Database for PostgreSQL.

Pokud jste to ještě neudělali, naklonujte větev ukázkového úložiště starter-no-infra v místním terminálu.

Baňka
Django

git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-flask-postgresql-sample-app
cd msdocs-flask-postgresql-sample-app

git clone -b starter-no-infra https://github.com/Azure-Samples/msdocs-django-postgresql-sample-app
cd msdocs-django-postgresql-sample-app

Tato naklonovaná větev je vaším výchozím bodem. Obsahuje jednoduchou aplikaci Flask pro datovou jednotku.

V kořenovém adresáři úložiště spusťte azd initpříkaz .
```
azd init --template python-app-service-postgresql-infra
```

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>.azurewebsites.net`). Jsou povoleny alfanumerické znaky a spojovníky.

Spuštěním azd up příkazu zřiďte potřebné prostředky Azure a nasaďte kód aplikace. Pokud ještě nejste přihlášení k Azure, prohlížeč se spustí a požádá vás o přihlášení. Příkaz azd up vás také vyzve k výběru požadovaného předplatného a umístění pro nasazení.
```
azd up
```
Dokončení azd up příkazu může trvat několik minut. Kód aplikace se také zkompiluje a nasadí, ale později kód upravíte tak, aby fungoval se službou App Service. Když je spuštěný, příkaz poskytuje zprávy o procesu zřizování a nasazení, včetně odkazu na nasazení v Azure. Po dokončení zobrazí příkaz také odkaz na aplikaci pro nasazení.

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:
- Baňka
- Django
- Skupina prostředků → Kontejner pro všechny vytvořené prostředky.
- Plán služby App Service → Definuje výpočetní prostředky služby App Service. Je zadán plán Linuxu na úrovni B1 .
- → App Service Představuje vaši aplikaci a běží v plánu služby App Service.
- Virtuální síť → integrovaná s aplikací App Service a izoluje back-endový síťový provoz.
- 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ónu → Umožňuje překlad DNS serveru PostgreSQL ve virtuální síti.
- Pracovní prostor služby Log Analytics → funguje jako cílový kontejner vaší aplikace k odeslání protokolů, kde můžete také dotazovat protokoly.
- Skupina prostředků → Kontejner pro všechny vytvořené prostředky.
- Plán služby App Service → Definuje výpočetní prostředky služby App Service. Je zadán plán Linuxu na úrovni B1 .
- → App Service Představuje vaši aplikaci a běží v plánu služby App Service.
- Virtuální síť → integrovaná s aplikací App Service a izoluje back-endový síťový provoz.
- 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é jenom z virtuální sítě.
- Privátní DNS zónu → Umožňuje překlad DNS serveru PostgreSQL ve virtuální síti.
- Pracovní prostor služby Log Analytics → funguje jako cílový kontejner vaší aplikace k odeslání protokolů, kde můžete také dotazovat protokoly.

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

Šablona azd, kterou používáte, 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.

Ve výstupu azd vyhledejte nastavení aplikace a najděte nastavení AZURE_POSTGRESQL_CONNECTIONSTRING a 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 settings:

         - AZURE_POSTGRESQL_CONNECTIONSTRING
         - AZURE_REDIS_CONNECTIONSTRING
         - FLASK_DEBUG
         - SCM_DO_BUILD_DURING_DEPLOYMENT
         - SECRET_KEY
 
```

AZURE_POSTGRESQL_CONNECTIONSTRINGobsahuje připojovací řetězec do databáze Postgres v Azure a AZURE_REDIS_CONNECTIONSTRING obsahuje připojovací řetězec do mezipaměti Redis v Azure. Abyste se k němu mohli připojit, musíte ho použít. Otevřete azureproject/production.py, odkomentujte následující řádky a soubor uložte:

Baňka
Django

conn_str = os.environ['AZURE_POSTGRESQL_CONNECTIONSTRING']
conn_str_params = {pair.split('=')[0]: pair.split('=')[1] for pair in conn_str.split(' ')}
DATABASE_URI = 'postgresql+psycopg2://{dbuser}:{dbpass}@{dbhost}/{dbname}'.format(
    dbuser=conn_str_params['user'],
    dbpass=conn_str_params['password'],
    dbhost=conn_str_params['host'],
    dbname=conn_str_params['dbname']
)

Kód aplikace je teď nakonfigurovaný tak, aby se připojil k databázi PostgreSQL v Azure. Pokud chcete, otevřete app.py a podívejte se, jak DATABASE_URI se používá proměnná prostředí.

conn_str = os.environ['AZURE_POSTGRESQL_CONNECTIONSTRING']
conn_str_params = {pair.split('=')[0]: pair.split('=')[1] for pair in conn_str.split(' ')}    
DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.postgresql',
        'NAME': conn_str_params['dbname'],
        'HOST': conn_str_params['host'],
        'USER': conn_str_params['user'],
        'PASSWORD': conn_str_params['password'],
    }
}

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.

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

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

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

Baňka
Django

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
 
```
V terminálu SSH spusťte flask db upgradepří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í.

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
 
```
V terminálu 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í.

5. Přejděte do aplikace.

Ve výstupu azd vyhledejte 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/

Přidejte do seznamu několik restaurací.
- Baňka
- Django
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.

6. 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 povolila protokolování do místního systému souborů a také je odesílá 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.

Baňka
Django

@app.route('/', methods=['GET'])
def index():
    print('Request for index page received')
    restaurants = Restaurant.query.all()
    return render_template('index.html', restaurants=restaurants)

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.

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

Pokud chcete odstranit všechny prostředky Azure v aktuálním prostředí nasazení, spusťte azd downpříkaz .

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_CONNECTIONSTRING', 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 nedošlo ke změně nastavení aplikace (AZURE_POSTGRESQL_CONNECTIONSTRING). 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?

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 terminálu 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?

Poznámka:

Pokud sledujete společně s tímto kurzem vlastní aplikaci, podívejte se na popis souboru requirements.txt v souboru README.md každého projektu (Flask, Django) a podívejte se, jaké balíčky budete potřebovat.

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.

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

Sdílet prostřednictvím

Nasazení webové aplikace v Pythonu (Django nebo Flask) pomocí PostgreSQL v Azure

Ukázková aplikace

1. Vytvoření služby App Service a PostgreSQL

2. Zabezpečení tajných kódů připojení

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

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

5. Přejděte do aplikace.

6. Streamování diagnostických protokolů

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

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

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

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

5. Přejděte do aplikace.

6. Streamování diagnostických protokolů

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

Řešení problému

Nemůžu se připojit k relaci SSH

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

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?

Další kroky

Váš názor

Další materiály

Sdílet prostřednictvím

Nasazení webové aplikace v Pythonu (Django nebo Flask) pomocí PostgreSQL v Azure

Přeskočit na konec

Ukázková aplikace

1. Vytvoření služby App Service a PostgreSQL

2. Zabezpečení tajných kódů připojení

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

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

5. Přejděte do aplikace.

6. Streamování diagnostických protokolů

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

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

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

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

5. Přejděte do aplikace.

6. Streamování diagnostických protokolů

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

Řešení problému

Nemůžu se připojit k relaci SSH

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

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?

Další kroky

Váš názor

Další materiály