Kurz: Nasazení webové aplikace Django s PostgreSQL v Azure App Service

1. Nastavení počátečního prostředí

1. Mít účet Azure s aktivním předplatným. Vytvořte si účet zdarma.
2. Nainstalujte Python 3.6 nebo novější.
3. Nainstalujte Azure CLI 2.18.0 nebo novější, pomocí kterého můžete spouštět příkazy v libovolném prostředí pro zřizování a konfiguraci prostředků Azure.

Otevřete okno terminálu a zkontrolujte, že máte Python verze 3.6 nebo vyšší:

python3 --version

py -3 --version

py -3 --version

Zkontrolujte, že vaše verze Azure CLI je 2.18.0 nebo vyšší:

az --version

Pokud potřebujete upgradovat, zkuste příkaz az upgrade (vyžaduje verzi 2.11+) nebo si můžete nainstalovat Azure CLI.

Pak se přihlaste k Azure prostřednictvím rozhraní příkazového řádku:

az login

Tento příkaz otevře prohlížeč a shromáždí vaše přihlašovací údaje. Po dokončení příkazu se zobrazí výstup JSON obsahující informace o vašich předplatných.

Po přihlášení můžete spouštět příkazy Azure pomocí Azure CLI a pracovat s prostředky ve vašem předplatném.

Máte problémy? Dejte nám vědět.

2. Klonování nebo stažení ukázkové aplikace

git clone https://github.com/Azure-Samples/djangoapp

cd djangoapp

git checkout flexible-server

Ukázka djangoapp obsahuje aplikaci dotazování Django řízenou daty, kterou získáte podle článku Psaní první aplikace Django v dokumentaci Django. Hotová aplikace je zde k dispozici pro usnadnění práce.

Ukázka se také upraví tak, aby se spouštěl v produkčním prostředí, jako je App Service:

• Produkční nastavení se nachází v souboru azuresite/production.py. Nastavení vývoje se nachází v souboru azuresite/settings.py.
• Při nastavení proměnné prostředí aplikace WEBSITE_HOSTNAME používá produkční nastavení. Azure App Service automaticky nastaví tuto proměnnou na adresu URL webové aplikace, například msdocs-django.azurewebsites.net .

Produkční nastavení jsou specifická pro konfiguraci Django pro spuštění v libovolném produkčním prostředí a nejsou specifická pro App Service. Další informace najdete v kontrolním seznamu nasazení Django. Podrobnosti o některých změnách najdete také v tématu Nastavení produkce pro Django v Azure.

Máte problémy? Dejte nám vědět.

3. Vytvoření databáze Postgres v Azure

az extension add --name db-up

az postgres up --resource-group DjangoPostgres-tutorial-rg --location centralus --sku-name B_Gen5_1 --server-name <postgres-server-name> --database-name pollsdb --admin-user <admin-username> --admin-password <admin-password> --ssl-enforcement Enabled

Máte problémy? Dejte nám vědět.

4. Nasazení kódu do Azure App Service

V této části vytvoříte hostitele aplikace v App Service, připojíte tuto aplikaci k databázi Postgres a pak na tohoto hostitele nasadíte kód.

4.1 Vytvoření App Service aplikace

az webapp up --resource-group DjangoPostgres-tutorial-rg --location centralus --plan DjangoPostgres-tutorial-plan --sku B1 --name <app-name>

Po úspěšném nasazení příkaz vygeneruje výstup JSON jako v následujícím příkladu:

Máte problémy? V opačném případě nám dejte vědětv průvodci odstraňováním potíží.

4.2 Konfigurace proměnných prostředí pro připojení k databázi

Když je teď kód nasazený App Service, dalším krokem je připojení aplikace k databázi Postgres v Azure.

Kód aplikace očekává, že najde informace o databázi ve čtyřech proměnných prostředí s názvem DBHOST , DBNAME , a DBUSER DBPASS .

Pokud chcete nastavit proměnné prostředí App Service, vytvořte "nastavení aplikace" pomocí následujícího příkazu az webapp config appsettings set.

az webapp config appsettings set --settings DBHOST="<postgres-server-name>" DBUSER="<username>" DBPASS="<password>" DBNAME="pollsdb" 

az webapp config appsettings set --settings DBHOST="<host>" DBUSER="<username>" DBPASS="<password>" DBNAME="flexibleserverdb" 

V kódu Pythonu máte k těmto nastavením přístup jako k proměnným prostředí pomocí příkazů jako os.environ.get('DBHOST') . Další informace najdete v tématu Přístup k proměnným prostředí.

Máte problémy? V opačném případě nám dejte vědětv průvodci odstraňováním potíží.

4.3 Spuštění migrací databáze Django

Migrace databází Django zajišťují, že schéma v databázi PostgreSQL v Azure odpovídá schématu popsanému ve vašem kódu.

1. Spuštěním az webpp ssh otevřete relaci SSH pro webovou aplikaci v prohlížeči:

   az webapp ssh
   

   Pokud se nemůžete připojit k relaci SSH, nepodařilo se spustit samotnou aplikaci. Podrobnosti najdete v diagnostických protokolech. Pokud jste například v předchozí části nevytáhli potřebná nastavení aplikace, v protokolech se zobrazí KeyError: 'DBNAME' .

2. V relaci SSH spusťte následující příkazy (příkazy můžete vložit pomocí kláves Ctrl + Shift + V):

   # Run database migrations
   python manage.py migrate
   
   # Create the super user (follow prompts)
   python manage.py createsuperuser
   

   Pokud dojde k chybám souvisejícím s připojením k databázi, zkontrolujte hodnoty nastavení aplikace vytvořených v předchozí části.

3. Příkaz createsuperuser vás vyzve k zadání přihlašovacích údajů superuživatele. Pro účely tohoto kurzu použijte výchozí uživatelské jméno, stisknutím root klávesy Enter ponechte e-mailovou adresu prázdnou a jako Pollsdb1 heslo zadejte .

4. Pokud se zobrazí chyba, že je databáze uzamčená, ujistěte se, že jste spustili příkaz v az webapp settings předchozí části. Bez těchto nastavení nemůže příkaz pro migraci komunikovat s databází, což vede k chybě.

Máte problémy? V opačném případě nám dejte vědětv průvodci odstraňováním potíží.

4.4 Vytvoření otázky k dotazování v aplikaci

1. Otevřete web aplikace. Aplikace by měla zobrazit zprávy "Polls app" (Aplikace hlasování) a No polls are available (Žádná hlasování nejsou k dispozici), protože databáze ještě žádné konkrétní dotazování nemá.

   az webapp browse
   

   Pokud se zobrazí Chyba aplikace, je pravděpodobné, že jste v předchozím kroku nevytyli požadovaná nastavení,nakonfigurujte proměnné prostředí pro připojení k databázi nebo že tato hodnota obsahuje chyby. Spusťte příkaz az webapp config appsettings list a zkontrolujte nastavení. Můžete také zkontrolovat diagnostické protokoly a zobrazit konkrétní chyby při spuštění aplikace. Pokud jste například nastavení nevytáhli, v protokolech se zobrazí chyba KeyError: 'DBNAME' .

   Po aktualizaci nastavení tak, aby se opraví všechny chyby, dejte aplikaci minutu na restartování a pak aktualizujte prohlížeč.

2. Přejděte na stránku správce webové aplikace tak, že k adrese URL připojíte /admin , například http://<app-name>.azurewebsites.net/admin . Přihlaste se pomocí přihlašovacích údajů superuživatele Django z předchozí části ( root a Pollsdb1 ). V části Polls(Hlasování) vyberte Add (Přidat) vedle Questions (Otázky) a vytvořte dotaz s několika možnostmi.

3. Vraťte se na hlavní web ( ) a potvrďte, že otázky jsou http://<app-name>.azurewebsites.net teď prezentovány uživateli. Odpovězte na otázky, ale chcete v databázi vygenerovat nějaká data.

Blahopřejeme! V linuxovém prostředí používáte webovou aplikaci Python Django Azure App Service pro Linux s aktivní databází Postgres.

Máte problémy? Dejte nám vědět.

5. Provedení změn kódu a opětovné nasazení

V této části proveďte místní změny aplikace a znovu nasaďte kód, aby App Service. V tomto procesu nastavíte virtuální prostředí Pythonu, které podporuje průběžnou práci.

5.1 Místní spuštění aplikace

V okně terminálu spusťte následující příkazy. Při vytváření superuživatele postupujte podle pokynů:

# Configure the Python virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt
# Run Django migrations
python manage.py migrate
# Create Django superuser (follow prompts)
python manage.py createsuperuser
# Run the dev server
python manage.py runserver

# Configure the Python virtual environment
py -3 -m venv venv
Set-ExecutionPolicy -Scope CurrentUser -ExecutionPolicy RemoteSigned -Force
venv\scripts\activate

# Install dependencies
pip install -r requirements.txt
# Run Django migrations
python manage.py migrate
# Create Django superuser (follow prompts)
python manage.py createsuperuser
# Run the dev server
python manage.py runserver

:: Configure the Python virtual environment
py -3 -m venv venv
venv\scripts\activate

:: Install dependencies
pip install -r requirements.txt
:: Run Django migrations
python manage.py migrate
:: Create Django superuser (follow prompts)
python manage.py createsuperuser
:: Run the dev server
python manage.py runserver

Po úplném načtení webové aplikace poskytne vývojový server Django adresu URL místní aplikace ve zprávě Spuštění vývojového serveru na http://127.0.0.1:8000/ adrese . Ukončete server stisknutím kláves CTRL+BREAK.

Otestujte aplikaci místně pomocí následujících kroků:

1. V prohlížeči přejděte na . Měla by se zobrazit zpráva "Nejsou k dispozici http://localhost:8000 žádná hlasování".

2. Přejděte na http://localhost:8000/admin a přihlaste se pomocí uživatele s rolí správce, který jste vytvořili dříve. V části Polls(Hlasování) znovu vyberte Add (Přidat) vedle Questions (Otázky) a vytvořte dotaz s několika možnostmi.

3. Znovu přejděte http://localhost:8000 na a odpovězte na otázku a otestujte aplikaci.

4. Stisknutím kláves Ctrl C zastavte server + Django.

Při místním spuštění aplikace používá místní databázi Sqlite3 a nenarušuje vaši produkční databázi. V případě potřeby můžete také k lepší simulaci produkčního prostředí použít místní databázi PostgreSQL.

Máte problémy? Dejte nám vědět.

5.2 Aktualizace aplikace

V polls/models.py vyhledejte řádek, který začíná na , choice_text a změňte parametr na max_length 100:

# Find this line of code and set max_length to 100 instead of 200
choice_text = models.CharField(max_length=100)

Vzhledem k tomu, že jste změnili datový model, vytvořte novou migraci Django a migrujte databázi:

python manage.py makemigrations
python manage.py migrate

Spusťte vývojový server znovu pomocí a python manage.py runserver otestujte aplikaci na adrese http: / /localhost:8000/admin:

Zastavte webový server Django znovu stisknutím kláves Ctrl + C.

Máte problémy? V opačném případě nám dejte vědětv průvodci odstraňováním potíží.

5.3 Opětovné nasazení kódu do Azure

V kořenovém adresáři úložiště spusťte následující příkaz:

az webapp up

Tento příkaz používá parametry uložené v mezipaměti v souboru .azure/config. Protože App Service zjistí, že aplikace už existuje, jednoduše znovu nasadí kód.

Máte problémy? V opačném případě nám dejte vědětv průvodci odstraňováním potíží.

5.4 Opětovné spuštění migrací v Azure

Vzhledem k tomu, že jste provedli změny datového modelu, je potřeba znovu spustit migrace databáze v App Service.

V prohlížeči znovu otevřete relaci SSH tak, že přejdete na https://<app-name>.scm.azurewebsites.net/webssh/host . Pak spusťte následující příkaz:

python manage.py migrate

Máte problémy? V opačném případě nám dejte vědětv průvodci odstraňováním potíží.

5.5 Kontrola aplikace v produkčním prostředí

Znovu přejděte do aplikace (pomocí nebo přejděte na ) a az webapp browse http://<app-name>.azurewebsites.net otestujte aplikaci znovu v produkčním prostředí. (Vzhledem k tomu, že jste změnili pouze délku databázového pole, je změna patrná pouze v případě, že se při vytváření otázky pokusíte zadat delší odpověď.)

Máte problémy? V opačném případě nám dejte vědětv průvodci odstraňováním potíží.

6. Streamování diagnostických protokolů

Můžete přistupovat k protokolům konzoly generovaným z kontejneru, který hostuje aplikaci v Azure.

Spuštěním následujícího příkazu Azure CLI zobrazte stream protokolu. Tento příkaz používá parametry uložené v mezipaměti v souboru .azure/config.

az webapp log tail

Pokud nevidíte protokoly konzoly okamžitě, podívejte se znovu za 30 sekund.

Streamování protokolů můžete kdykoli zastavit stisknutím kláves Ctrl + C.

Máte problémy? Dejte nám vědět.

az webapp log config --docker-container-logging filesystem

7. Správa aplikace v Azure Portal

V Azure Portalvyhledejte název aplikace a ve výsledcích vyberte aplikaci.

Ve výchozím nastavení se na portálu zobrazí stránka Přehled vaší aplikace, která poskytuje obecné zobrazení výkonu. Tady můžete také provádět základní úlohy správy, jako je procházení, zastavení, restartování a odstranění. Karty na levé straně stránky obsahují různé stránky konfigurace, které můžete otevřít.

Máte problémy? V opačném případě nám dejte vědětv průvodci odstraňováním potíží.

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

Pokud chcete aplikaci zachovat nebo pokračovat dalšími kurzy, přeskočte k části Další kroky. Jinak můžete odstranit skupinu prostředků vytvořenou pro tento kurz, abyste se vyhnuli průběžných poplatkům:

az group delete --name Python-Django-PGFlex-rg --no-wait

Odstraněním skupiny prostředků také odstraníte a odstraníte všechny prostředky, které obsahuje. Před použitím příkazu se ujistěte, že už prostředky ve skupině nepotřebujete.

Odstranění všech prostředků může nějakou dobu trvat. Argument --no-wait umožňuje, aby se příkaz okamžitě vrátil.

Máte problémy? Dejte nám vědět.

Další kroky

Zjistěte, jak namapovat vlastní název DNS na vaši aplikaci:

Zjistěte, App Service můžete spustit aplikaci v Pythonu: