Kurz: Nasazení aplikace PHP, MySQL a Redis do služby Aplikace Azure Service

V tomto kurzu se dozvíte, jak vytvořit zabezpečenou aplikaci PHP ve službě Azure App Service, která se připojuje k databázi MySQL pomocí flexibilního serveru Azure Database for MySQL. Nasadíte také Azure Cache for Redis, abyste ve své aplikaci povolili kód ukládání do mezipaměti. Azure App Service je vysoce škálovatelná, samoopravující se webhostingová služba, která umožňuje snadné nasazení aplikací na Windows nebo Linux. Až budete hotovi, máte aplikaci Laravel spuštěnou ve službě Azure App Service v Linuxu.

Požadavky

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

Spusťte ukázku

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

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/laravel-tasks/fork.
3. Vyberte Vytvořit fork.

Krok 2: Ve forku na GitHubu:

1. Vyberte Code>Vytvořit kódovací prostor na hlavní. Nastavení codespace trvá několik minut. Zadaný soubor .env již obsahuje fiktivní APP_KEYproměnnou, kterou Laravel potřebuje spustit místně.

Krok 3: V terminálu codespace:

1. Spusťte composer install.
2. Spusťte migrace databází pomocí php artisan migratepříkazu .
3. Spusťte aplikaci pomocí php artisan servepříkazu .
4. Až se zobrazí oznámení Your application running on port 80 is available., vyberte Otevřít v prohlížeči. Ukázkovou aplikaci byste měli vidět na nové kartě prohlížeče. Pokud chcete aplikaci zastavit, zadejte Ctrl + C.

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

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 MySQL a Azure Cache for Redis. Pro proces vytváření zadáte:

• Název webové aplikace. Používá se jako součást názvu DNS pro vaši aplikaci.
• Oblast, ve které má být aplikace fyzicky umístěna ve světě. Je také součástí názvu DNS vaší aplikace.
• Zásobník modulu runtime pro aplikaci. Tady vyberete verzi PHP, kterou chcete použít pro vaši aplikaci.
• 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šechny prostředky Azure potřebné pro aplikaci v logickém kontejneru.

Přihlaste se do Azure Portalu. Podle těchto kroků vytvořte prostředky Azure App Service.

Krok 1: Na webu Azure Portal:

1. Na horním panelu hledání zadejte app service.
2. Vyberte položku s popiskem App Service pod nadpisem Služby .
3. Vyberte Vytvořit>webovou aplikaci. Můžete také přejít přímo k vytvoření webové aplikace .

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

1. Název: msdocs-laravel-mysql. Azure Portal vytvoří skupinu prostředků s názvem msdocs-laravel-mysql_group.
2. Zásobník modulu runtime: PHP 8.4.
3. Operační systém: Linux.
4. Oblast: Libovolná oblast Azure, která je blízko vás.
5. Plán Pro Linux: Vytvořte nové a použijte název msdocs-laravel-mysql.
6. Cenový plán: Basic. Až budete připraveni, můžete vertikálně navýšit kapacitu na jinou cenovou úroveň.

Krok 3:

1. Výběrem možnosti Další přejděte na kartu Databáze .
2. Vyberte Vytvořit databázi.
3. V Engin vyberte MySQL - Flexibilní server.
4. Vyberte Vytvořit Azure Cache pro Redis.
5. Do pole Název (v části Mezipaměť) zadejte název mezipaměti.
6. V SKU vyberte Basic.

Krok 4:

1. Výběrem možnosti Další přejděte na kartu Nasazení .
2. Povolte průběžné nasazování.
3. V organizaci vyberte alias GitHubu.
4. V úložišti vyberte laravel-tasks.
5. Ve větvi vyberte hlavní.
6. Ujistěte se, že je zakázáno základní ověřování.
7. Vyberte Zkontrolovat a vytvořit.
8. Po dokončení ověření vyberte Vytvořit.

Krok 5: Dokončení nasazení trvá několik minut. Pokud chcete webovou aplikaci zobrazit, vyberte Přejít k prostředku. Nasazení vytvoří 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é body: Přístup ke koncovým bodům pro databázový server a Redis cache 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 MySQL: Přístupný pouze ze svého privátního koncového bodu. Databáze a uživatel se pro vás vytvoří na serveru.
• Azure Cache for Redis: Přístupné jen za soukromým koncovým bodem.
• Privátní zóny DNS: Povolte rozlišení DNS databázového serveru a mezipaměti Redis ve virtuální síti.

Zabezpečené tajné kódy připojení

Nasazení pro vás již vygenerovalo proměnné konektivity jako nastavení aplikace. Osvědčeným postupem zabezpečení je úplné zachování tajných kódů mimo službu App Service. Přesuňte tajné kódy do trezoru klíčů a změňte nastavení aplikace na odkazy služby Key Vault pomocí konektorů služeb.

Krok 1: Načtěte existující připojovací řetězec.

1. V nabídce vlevo na stránce služby App Service vyberte Nastavení>Proměnné prostředí.
2. Vyberte Připojovací řetězce.
3. Vyberte AZURE_MYSQL_CONNECTIONSTRING.
4. V nastavení Přidat/upravit aplikaci zkopírujte v poli Hodnota uživatelské jméno a heslo pro pozdější použití. Připojovací řetězec umožňuje připojit se k databázi MySQL zabezpečenou za privátními koncovými body. Tajné kódy se ukládají přímo v aplikaci App Service, což není nejlepší. Tuto konfiguraci změníte.

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-laravel-mysql_group.
3. Do názvu trezoru klíčů zadejte název, který se skládá jenom z písmen a číslic.
4. V oblasti vyberte stejné umístění jako je skupina zdrojů.

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-laravel-mysql_group.
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-laravel-mysqlVaultEndpoint.
7. Ve virtuální síti vyberte virtuální síť ve skupině msdocs-laravel-mysql_group .
8. V podsíti vyberte dostupnou kompatibilní podsíť.
9. Vyberte OK.
10. Vyberte Zkontrolovat a vytvořit a pak vyberte Vytvořit. Počkejte na dokončení nasazení trezoru klíčů. Měli byste vidět , že je vaše nasazení dokončené.

Krok 4: Vytvořte konektor MySQL.

1. Na horním panelu hledání zadejte msdocs-laravel-mysql a pak vyberte prostředek služby App Service s názvem msdocs-laravel-mysql.
2. Na stránce služby App Service v nabídce vlevo vyberteKonektor služby>.
3. Vyberte Vytvořit.
4. Jako typ služby vyberte databázi pro flexibilní server MySQL.
5. Pro flexibilní server MySQL vyberte váš server, například msdocs-laravel-mysql-server.
6. Pro databázi MySQL vyberte databázi, například msdocs-laravel-mysql-database.

Krok 5: Nakonfigurujte ověřování pro konektor MySQL.

1. Vyberte kartu Ověřování .
2. Vyberte Připojovací řetězec.
3. Do pole Heslo vložte dříve zkopírované heslo.
4. Vyberte Uložit tajný klíč ve službě Key Vault.
5. 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 6: Vytvořte 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 7: Dokončete nastavení konektoru MySQL.

1. Jste zpátky v dialogovém okně konektoru MySQL. Na kartě Ověřování počkejte na vytvoření konektoru pro klíčový trezor. Po dokončení připojení ke službě Key Vault ho automaticky vybere.
2. Vyberte Zkontrolovat a vytvořit.
3. Vyberte Vytvořit. Počkejte, až se zobrazí oznámení o úspěšném dokončení aktualizace .

Krok 8: Nakonfigurujte konektor 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 již zabezpečil databázi SQL privátním koncovým bodem.
7. Vyberte Uložit. Počkejte, až se zobrazí oznámení o úspěšném dokončení aktualizace .

Krok 9: Ověřte integraci služby Key Vault.

1. V nabídce vlevo znovu vyberte Nastavení>Proměnné prostředí.
2. Vedle AZURE_MYSQL_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.

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íčů.

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

---

Konfigurace proměnných Laravel

Krok 1: Vytvořte CACHE_DRIVER jako nastavení aplikace.

1. Ve webové aplikaci vyberteProměnné prostředí>.
2. Na kartě Nastavení aplikace vyberte Přidat.
3. Jako název zadejte CACHE_DRIVER.
4. Jako hodnotu zadejte redis.
5. Vyberte Použít a pak znovu Použít a pak Potvrďte.

Krok 2: Pomocí stejných kroků v kroku 1 vytvořte následující nastavení aplikace. Po dokončení vyberte Použít a aktualizujte nastavení aplikace.

• MYSQL_ATTR_SSL_CA: Jako hodnotu použijte /home/site/wwwroot/ssl/DigiCertGlobalRootCA.crt.pem . Toto nastavení aplikace odkazuje na cestu certifikátu TLS/SSL, který potřebujete pro přístup k serveru MySQL. Je součástí ukázkového úložiště.
• LOG_CHANNEL: Jako hodnotu použijte stderr . Toto nastavení říká Laravelu, aby směroval protokoly do stderr, což je zpřístupňuje protokolům služby App Service.
• APP_DEBUG: Jako hodnotu použijte true . Jedná se o proměnnou pro ladění v Laravelu, která umožňuje stránky v režimu ladění.
• APP_KEY: Jako hodnotu použijte base64:Dsz40HWwbCqnq0oxMsjq7fItmKIeBfCBGORfspaI1Kw= . Jedná se o šifrovací proměnnou Laravel.

Důležité

Tato APP_KEY hodnota se zde používá pro usnadnění. V produkčních scénářích by se měla generovat speciálně pro vaše nasazení pomocí php artisan key:generate --show příkazového řádku.

APP_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 Jak změním nastavení aplikace APP_KEY na referenční informace ke službě Key Vault?

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í každá git push ve vašem GitHub úložišti spustí akci sestavení a nasazení.

Krok 1: Vraťte se do prostoru kódu GitHubu ukázkového forku a spusťte git pull origin main. Tento příkaz načte nově potvrzený soubor pracovního postupu do vašeho prostoru kódu.

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

1. Začněte novou chatovací relaci výběrem zobrazení chatu a poté tlačítka +.
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 konfiguraci nebo database.php.
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 MySQL. 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 Copilotu a dokonce vám říct, abyste udělali změnu v souboru konfigurace nebo database.php .
4. Otevřete config/database.php v průzkumníku a přidejte kód.
5. Zeptejte se, "@workspace Moje aplikace App Service také používá Konektor služby Azure k připojení k mezipaměti pro 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 GitHub Copilotu a dokonce říct, abyste provedli změnu v souboru config/database.php. Pokud se zobrazí výzva, přihlaste se k GitHub Copilotu pro Azure a získejte přesnější odpovědi.
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 2 (možnost 2: bez GitHub Copilotu):

1. V Průzkumníku otevřete config/database.php. Najděte mysql oddíl a proveďte následující změny:
2. Nahraďte DB_HOST (řádek 49) za AZURE_MYSQL_HOST.
3. Nahraďte DB_DATABASE (řádek 51) za AZURE_MYSQL_DBNAME.
4. Nahraďte DB_USERNAME (řádek 52) za AZURE_MYSQL_USERNAME.
5. Nahraďte DB_PASSWORD (řádek 53) za AZURE_MYSQL_PASSWORD.
6. Nahraďte DB_PORT (řádek 50) za AZURE_MYSQL_PORT.
7. Přejděte do části Redis cache a proveďte následující změny:
8. Nahraďte REDIS_HOST (řádek 142) za AZURE_REDIS_HOST.
9. Nahraďte REDIS_PASSWORD (řádek 144) za AZURE_REDIS_PASSWORD.
10. Nahraďte REDIS_PORT (řádek 145) za AZURE_REDIS_PORT.
11. Nahraďte REDIS_CACHE_DB (řádek 146) textem AZURE_REDIS_DATABASE.
12. Ve stejné části přidejte řádek s 'scheme' => 'tls',. Tato konfigurace říká Laravelu, aby používal šifrování pro připojení k Redisu.

Krok 3:

1. Vyberte rozšíření Source Control.
2. Do textového pole zadejte zprávu potvrzení, jako je Konfigurace databáze Azure a připojení mezipaměti. Nebo vyberte a nechte GitHub Copilot vygenerovat potvrzovací zprávu za vás.
3. Vyberte Potvrdit a potvrďte akci ano.
4. Vyberte Synchronizovat změny 1 a potvrďte OK.

Krok 4:

1. V Azure portálu otevřete vaši webovou aplikaci a pak vyberte Nasazení>Centrum nasazení.
2. Vyberte Protokoly, pak zvolte Aktualizovat pro zobrazení nového spuštění nasazení.
3. V záznamu protokolu nasazení vyberte položku Sestavit/Nasadit záznamy s nejnovějším časovým razítkem.

Krok 5: Přejdete do svého ú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 10 minut.

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

Generování schématu databáze

Průvodce vytvořením umístí databázový server MySQL za privátní koncový bod, takže je přístupný jenom z virtuální sítě. Vzhledem k tomu, že aplikace App Service je už integrovaná s virtuální sítí, nejjednodušší způsob, jak spouštět migrace databází s vaší databází, je přímo z kontejneru služby App Service.

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

1. Vyberte Vývojové nástroje>SSH.
2. Vyberte Přejít.

Krok 2: V terminálu SSH:

1. Spusťte cd /home/site/wwwroot. Tady jsou všechny vaše nasazené soubory.
2. Spusťte php artisan migrate --force. Pokud proběhne úspěšně, služba App Service se úspěšně připojuje k databázi MySQL.

Návod

V relaci SSH se změny souborů v /home můžou zachovat i po restartování aplikace. Změny mimo /home se neuchovávají.

Změna kořenového adresáře webu

Životní cyklus aplikace Laravel začíná v adresáři /public . Výchozí kontejner PHP pro App Service používá Nginx, který se spouští v kořenovém adresáři aplikace. Pokud chcete změnit kořen webu, musíte změnit konfigurační soubor Nginx v kontejneru PHP (/etc/nginx/sites-available/default). Ukázkové úložiště obsahuje vlastní konfigurační soubor s názvem výchozí. Jak jsme si poznamenali dříve, nechcete tento soubor nahradit pomocí prostředí SSH. Změna je mimo aplikaci /home a po restartování aplikace se ztratí.

Krok 1:

1. V nabídce vlevo vyberte Nastavení>konfigurace.
2. Vyberte kartu Obecné nastavení .

Krok 2: Na kartě Obecné nastavení :

1. Do pole Spouštěcí příkaz zadejte následující příkaz: cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload.
2. Vyberte Uložit a pak vyberte Pokračovat. Příkaz nahradí konfigurační soubor Nginx v kontejneru PHP a restartuje Nginx. Tato konfigurace zajistí, že při každém spuštění se v kontejneru provede stejná změna.

Přechod do aplikace

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

1. V nabídce vlevo vyberte Přehled.
2. Vyberte výchozí doménu vaší aplikace.

Krok 2: Přidejte do seznamu několik úkolů. Blahopřejeme, ve službě Aplikace Azure Service spouštíte zabezpečenou aplikaci PHP řízenou daty.

Návod

Ukázková aplikace implementuje model cache-aside. Při opětovném načtení stránky po provedení změn dat se doba odezvy na webové stránce zobrazí mnohem rychleji, protože načítá data z mezipaměti místo databáze.

Přenášet diagnostické protokoly

Aplikace Azure Služba zaznamenává všechny zprávy protokolované do konzoly, aby vám pomohla při diagnostice problémů s vaší aplikací. Ukázková aplikace vypíše zprávy protokolu konzoly ve všech jejích koncových bodech, aby tuto funkci ukázala. Ve výchozím nastavení protokolovací funkce Laravelu, například Log::info(), zaznamenává do místního souboru. Nastavení vaší LOG_CHANNEL aplikace z dřívějších verzí zpřístupňuje položky protokolu ze streamu protokolu služby App Service.

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

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

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. Pro potvrzení odstranění zadejte název skupiny prostředků.
2. Vyberte Odstranit.

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 a Azure Database for MySQL.

Ve službě GitHub Codespace je již dostupné Azure Developer CLI (AZD).

1. Vygenerování šifrovacího klíče Laravel pomocí php artisan key:generate --show:

   php artisan key:generate --show
   

2. Přihlaste se k Azure spuštěním příkazu azd auth login a podle pokynů.

   azd auth login
   

3. Vytvořte potřebné prostředky Azure a pomocí příkazu nasaďte kód azd up aplikace. Podle pokynů vyberte požadované předplatné a umístění prostředků Azure.

   azd up
   

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

   Otázka	Odpověď
   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.
   Vyberte předplatné Azure, které chcete použít.	Vyberte své předplatné.
   Vyberte umístění Azure, které chcete použít.	Vyberte umístění.
   Zadejte hodnotu parametru zabezpečené infrastruktury 'appKey'.	Tady použijte výstup php artisan key:generate --show . Šablona AZD pro ni vytvoří tajný klíč služby Key Vault, který můžete použít ve své aplikaci.
   Zadejte hodnotu parametru zabezpečené infrastruktury databasePassword.	Heslo databáze pro MySQL Musí mít délku nejméně 8 znaků a obsahovat velká písmena, malá písmena, číslice a speciální znaky.

   Dokončení azd up příkazu trvá přibližně 15 minut. Mezipaměť Redis trvá nejvíce času. Příkaz také zkompiluje a nasadí kód aplikace, 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:

   • 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 B1 .
   • 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ě.
   • Flexibilní server Azure Database for MySQL: Přístupný pouze z virtuální sítě prostřednictvím integrace zóny DNS. Na serveru se pro vás vytvoří databáze.
   • Azure Cache for Redis: Přístupná pouze z virtuální sítě.
   • Privátní koncové body: Koncové body pro přístup k trezoru klíčů a Redis cache ve virtuální síti.
   • Privátní zóny DNS: Umožněte rozlišení DNS pro Key Vault, databázový server a mezipaměť Redis 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.
   • Trezor klíčů: Slouží k zachování hesla databáze stejně při opětovném nasazení pomocí AZD.

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

Použití připojovacích řetězců Azure v kódu aplikace

Šablona AZD, kterou používáte, vygenerovala proměnné připojení pro vás jako nastavení aplikace a vypisuje je do terminálu. 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í aplikace, která začínají AZURE_MYSQL_ a AZURE_REDIS_. Zobrazí se jenom názvy nastavení. Ve výstupu AZD vypadají takto:

   App Service app has the following app settings:
           - AZURE_KEYVAULT_RESOURCEENDPOINT
           - AZURE_KEYVAULT_SCOPE
           - AZURE_MYSQL_DBNAME
           - AZURE_MYSQL_FLAG
           - AZURE_MYSQL_HOST
           - AZURE_MYSQL_PASSWORD
           - AZURE_MYSQL_PORT
           - AZURE_MYSQL_USERNAME
           - AZURE_REDIS_DATABASE
           - AZURE_REDIS_HOST
           - AZURE_REDIS_PASSWORD
           - AZURE_REDIS_PORT
           - AZURE_REDIS_SSL
   

   Nastavení začínající AZURE_MYSQL_ jsou proměnné připojení pro databázi MySQL. Nastavení počínaje AZURE_REDIS_ jsou určená pro mezipaměť Redis. Později je budete muset použít ve svém kódu. Šablona AZD ukazuje přímý odkaz na stránku nastavení aplikace na webu Azure Portal.

2. V průzkumníku otevřete config/database.php. Tento soubor je konfiguračním souborem pro připojení k databázi a mezipaměti Redis.

3. Najděte část, která definuje spojení (řádky mysql 46-64) a nahraďte DB_HOST, DB_PORT, DB_DATABASE, DB_USERNAMEa DB_PASSWORD nastavením AZURE_MYSQL_ aplikace z výstupu AZD. Vaše mysql připojení by mělo vypadat jako následující kód.

   'mysql' => [
       'driver' => 'mysql',
       'url' => env('DATABASE_URL'),
       'host' => env('AZURE_MYSQL_HOST', '127.0.0.1'),
       'port' => env('AZURE_MYSQL_PORT', '3306'),
       'database' => env('AZURE_MYSQL_DBNAME', 'forge'),
       'username' => env('AZURE_MYSQL_USERNAME', 'forge'),
       'password' => env('AZURE_MYSQL_PASSWORD', ''),
       'unix_socket' => env('DB_SOCKET', ''),
       'charset' => 'utf8mb4',
       'collation' => 'utf8mb4_unicode_ci',
       'prefix' => '',
       'prefix_indexes' => true,
       'strict' => true,
       'engine' => null,
       'options' => extension_loaded('pdo_mysql') ? array_filter([
           PDO::MYSQL_ATTR_SSL_CA => env('MYSQL_ATTR_SSL_CA'),
       ]) : [],
   ],
   

   Další informace o konfiguraci databáze v Laravel naleznete v dokumentaci k Laravel.

4. Najděte část, která definuje připojení mezipaměti Redis (řádky 140-147) a nahraďte REDIS_HOST, REDIS_PASSWORD, REDIS_PORT a REDIS_CACHE_DB nastavení Azure_REDIS_ aplikace z výstupu AZD. Také přidejte 'scheme' => 'tls', k připojení. Připojení k mezipaměti by mělo vypadat jako následující kód:

   'cache' => [
       'scheme' => 'tls',
       'url' => env('REDIS_URL'),
       'host' => env('AZURE_REDIS_HOST', '127.0.0.1'),
       'username' => env('REDIS_USERNAME'),
       'password' => env('AZURE_REDIS_PASSWORD'),
       'port' => env('AZURE_REDIS_PORT', '6379'),
       'database' => env('AZURE_REDIS_DATABASE', '1'),
   ],
   

   Další informace o konfiguraci mezipaměti Redis v Laravel naleznete v dokumentaci k Laravel.

   Poznámka:

   Nezapomeňte, že vaše změny ještě nejsou nasazené. Nasadíte je na konci dalšího kroku.

Nastavit nastavení Laravel ve webové aplikaci

1. Z Průzkumníku otevřete infra/resources.bicep. Tento soubor je soubor Bicep, který definuje vytvořené prostředky Azure.

2. Najděte část, která definuje nastavení aplikace (řádky 510–514) a zrušte jejich komentář. Tato nastavení aplikace jsou:

   Nastavení	Popis
   CACHE_DRIVER	Určuje Laravelu, aby jako mezipaměť používal Redis (podívejte se na dokumentaci k Laravelu).
   MYSQL_ATTR_SSL_CA	Je potřeba otevřít připojení TLS k MySQL v Azure. Soubor certifikátu je součástí ukázkového úložiště pro usnadnění. Tato proměnná je používána připojením k MySQL v config/database.php
   LOG_CHANNEL	cs-CZ: Řekne Laravelu, aby směroval protokoly do stderr, čímž je zpřístupní v protokolech služby App Service (viz dokumentace k Laravelu).
   APP_DEBUG	Povolte stránky režimu ladění Laravelu (viz dokumentace k Laravelu).
   APP_KEY	Šifrovací proměnná Laravel Šablona AZD už vytvořila tajný klíč služby Key Vault (řádky 212–217), abyste k ní měli přístup pomocí odkazu na Key Vault.

3. V infra/resources.bicep vyhledejte definici prostředku pro aplikaci App Service a odkomentujte řádek 315:

   appCommandLine: 'cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload'
   

   Životní cyklus aplikace Laravel začíná v adresáři /public namísto kořenového adresáře aplikace. Výchozí kontejner PHP pro App Service používá Nginx, který se spouští v kořenovém adresáři aplikace. Pokud chcete změnit kořen webu, musíte změnit konfigurační soubor Nginx v kontejneru PHP (/etc/nginx/sites-available/default).

   Ukázkové úložiště obsahuje náhradní konfigurační soubor s názvem výchozí, který říká Nginx, aby hledal v adresáři /public . Tento vlastní příkaz v appCommandLine se spustí pokaždé, když se aplikace spustí, aby vždy zajistil náhradu souboru při každém načtení Linuxového kontejneru z čistého stavu.

4. Zpátky v terminálu codespace spusťte azd up znovu.

   azd up
   

Návod

azd up spouští azd package, azd provision a azd deploy společně, protože děláte změny infrastruktury i aplikace. Pokud chcete provést pouze změny infrastruktury, spusťte azd provisionpříkaz . Pokud chcete pouze nasadit změny kódu aplikace, spusťte azd deploypříkaz .

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

Generování schématu databáze

S databází MySQL chráněnou virtuální sítí je nejjednodušší způsob, jak spouštět migrace databází Laravel, 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: <URL>
   

2. V relaci SSH spusťte migrace databází z adresáře /home/site/wwwroot :

   cd /home/site/wwwroot
   php artisan migrate --force
   

   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.

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

Přechod 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: <URL>
   

2. Přidejte do seznamu několik úkolů.

   

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

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

Přenášet diagnostické protokoly

Aplikace Azure Služba zaznamenává všechny zprávy protokolované do konzoly, aby vám pomohla při diagnostice problémů s vaší aplikací. Pro usnadnění přístupu už šablona AZD povolila protokolování do místního systému souborů a odesílá protokoly do pracovního prostoru služby Log Analytics.

Ukázková aplikace vypíše zprávy protokolu konzoly ve všech jejích koncových bodech, aby tuto funkci ukázala. Ve výchozím nastavení protokolovací funkce Laravelu, například Log::info(), zaznamenává do místního souboru. Nastavení vaší LOG_CHANNEL aplikace z dřívějších verzí zpřístupňuje položky protokolu ze streamu protokolu služby App Service.

Route::get('/', function () {
    Log::info("Get /");
    $startTime = microtime(true);
    // Simple cache-aside logic
    if (Cache::has('tasks')) {
        $data = Cache::get('tasks');
    } else {
        $data = Task::orderBy('created_at', 'asc')->get();
        Cache::add('tasks', $data);
    }
    return view('tasks', ['tasks' => $data, 'elapsed' => microtime(true) - $startTime]);
});

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

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

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émů

Při migracích databází dochází k chybě php_network_getaddresses: getaddrinfo for mysqldb failed: No address associated with hostname...

Označuje, že proměnné připojení MySQL nejsou správně nakonfigurované. Ověřte, že AZURE_MYSQL_ nastavení aplikace jsou správně nakonfigurované v části 'Použití řetězců připojení Azure v kódu aplikace'.

V prohlížeči se zobrazí prázdná stránka.

Označuje, že App Service nemůže najít spouštěcí soubory PHP ve /public. Postupujte podle pokynů v části Konfigurace nastavení Laravel ve webové aplikaci.

V prohlížeči se mi zobrazuje stránka ladění Unsupported cipher or incorrect key length.

Označuje, že APP_KEY nastavení je nastavené na neplatný klíč. Při spuštění azd up nezapomeňte nastavit appKey na výstup php artisan key:generate --show.

V prohlížeči se mi zobrazuje stránka ladění Uncaught Error: Class "Illuminate\..." not found.

Tato chyba a podobné chyby značí, že jste nespustili composer install před azd up, nebo že balíčky v adresáři /vendor jsou zastaralé. Spusťte composer install a azd deploy znovu.

V prohlížeči se mi zobrazuje stránka ladění php_network_getaddresses: getaddrinfo for redishost failed: Name or service not known.

Označuje, že proměnné připojení Redis nejsou správně nakonfigurované. Ověřte, že AZURE_REDIS_ nastavení aplikace jsou správně nakonfigurované v části 'Použití řetězců připojení Azure v kódu aplikace'.

V prohlížeči se mi zobrazuje stránka ladění SQLSTATE[42S02]: Base table or view not found: 1146 Table 'XXXX-XXXXXXXXX-mysql-database.tasks' doesn't exist

Znamená to, že jste nespustili migrace databáze, nebo migrace databáze nebyly provedeny úspěšně. Postupujte podle kroků v části Generování schématu databáze.

Nejčastější dotazy

• Kolik stojí toto nastavení?
• Jak se připojím k databázi MySQL, která je zabezpečená za virtuální sítí, pomocí jiných nástrojů?
• Jak změním nastavení aplikace APP_KEY na referenční informace ke službě Key Vault?
• Jak místní vývoj aplikací funguje s GitHub Actions?
• Proč je nasazení GitHub Actions tak pomalé?
• 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í?
• Jak se připojím k databázi MySQL, která je zabezpečená za virtuální sítí, pomocí jiných nástrojů?
• Jak místní vývoj aplikací funguje s GitHub Actions?
• Proč je nasazení GitHub Actions tak pomalé?
• 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 MySQL je vytvořen v úrovni B1ms a lze ho upravit směrem nahoru nebo dolů. S bezplatným účtem Azure je úroveň B1ms bezplatná po dobu 12 měsíců až do měsíčních limitů. Podívejte se na ceny služby Azure Database for MySQL.
• Azure Cache for Redis se vytvoří na úrovni Basic s minimální velikostí mezipaměti. K této úrovni jsou spojené malé náklady. Kapacitu můžete vertikálně navýšit na vyšší úroveň výkonu pro vyšší dostupnost, clustering a další funkce. Podívejte se na ceny služby Azure Cache for Redis.
• Virtuální síť není zpoplatněna, pokud nekonfigurujete další funkce, jako je například propojení sítí. 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.

Jak se připojím k databázi MySQL, která je chráněná za virtuální sítí, pomocí jiných nástrojů?

• Pro základní přístup z nástroje příkazového řádku můžete spustit mysql z SSH terminálu aplikace.
• Pokud se chcete připojit z desktopového nástroje, jako je MySQL Workbench, 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 změním nastavení aplikace APP_KEY na referenční informace ke službě Key Vault?

V krocích webu Azure Portal v části Konfigurace proměnných Laravel můžete přejít APP_KEY na odkaz služby Key Vault spuštěním následujících příkazů Azure CLI v prostoru kódu GitHubu:

# 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=laravelAppKey

# 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 $(php artisan key:generate --show)

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

Totéž můžete udělat také na webu Azure Portal. Další informace najdete tady:

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

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

Jako příklad vezměte automaticky vygenerovaný soubor pracovního postupu ze služby App Service. Každý git push spustí nové sestavení a nasazení. Z místního klonu úložiště GitHub provedete požadované aktualizace a odešlete je na GitHub. Příklad:

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

Proč je nasazení GitHub Actions tak pomalé?

Automaticky vygenerovaný soubor pracovního postupu ze služby App Service definuje pracovní postup sestavení a následného nasazení, který zahrnuje dva úkoly. Vzhledem k tomu, že každá úloha běží ve vlastním čistém prostředí, soubor pracovního postupu zajistí, že deploy má úloha přístup k souborům build z úlohy:

• Na konci build úlohy nahrajte soubory jako artefakty.
• Na začátku deploy úlohy stáhněte artefakty.

V procesu dvou úloh je většina potřebného času strávena nahráváním a stahováním artefaktů. Pokud chcete, můžete soubor pracovního postupu zjednodušit tím, že zkombinujete dvě úlohy do jedné, což eliminuje potřebu kroků pro nahrávání a stahování.

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

Podívejte se na Nastavení nasazení GitHub Actions z Centra nasazení.

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

Můžete si všimnout, že zobrazení chatu GitHub Copilot už pro vás bylo k dispozici při vytváření pracovního 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 doplňují, a můžete upravit své otázky pro přesnější odpovědi, které obdrží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 v tématu Use the @workspace agent.
• V chatové relaci může GitHub Copilot navrhovat změny a také @workspace naznačit, kde tyto změny provést, ale změny za vás nesmí provádět. Je na vás přidat navrhované změny a otestovat je.

Související obsah

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

Nebo si projděte tento zdroj:

• Konfigurace aplikace PHP