Kurz: Sestavení php (Laravel) a aplikace flexibilního serveru Azure Database for MySQL ve službě Aplikace Azure Service

Aplikace Azure Služba poskytuje vysoce škálovatelnou službu hostování webů s automatickými opravami pomocí operačního systému Linux. V tomto kurzu se dozvíte, jak vytvořit zabezpečenou aplikaci PHP ve službě Aplikace Azure, která je připojená k databázi MySQL (pomocí flexibilního serveru Azure Database for MySQL). Až budete hotovi, budete mít aplikaci Laravel spuštěnou ve službě Aplikace Azure Service v Linuxu.

V tomto kurzu se naučíte:

• Vytvoření aplikace PHP a MySQL ve výchozím nastavení zabezpečení v Azure
• Konfigurace tajných kódů připojení k MySQL pomocí nastavení aplikace
• Nasazení kódu aplikace pomocí GitHub Actions
• Aktualizace a opětovné nasazení aplikace
• Bezpečné spouštění migrací databází
• Streamovat diagnostické protokoly z Azure
• Spravovat aplikaci na webu Azure Portal

Požadavky

• Předplatné Azure Pokud nemáte předplatné Azure, vytvořte si před zahájením bezplatný účet Azure. V současné době můžete s bezplatným účtem Azure vyzkoušet flexibilní server Azure Database for MySQL zdarma po dobu 12 měsíců. Další informace najdete v tématu Použití bezplatného účtu Azure k vyzkoušení flexibilního serveru Azure Database for MySQL zdarma.

Ukázková aplikace

Pokud chcete postupovat podle tohoto kurzu, naklonujte nebo stáhněte ukázkovou aplikaci z úložiště:

git clone https://github.com/Azure-Samples/laravel-tasks.git

Pokud chcete aplikaci spustit místně, postupujte takto:

• V souboru .env nakonfigurujte nastavení databáze (například DB_DATABASEDB_USERNAMEDB_PASSWORDa) pomocí nastavení v místní databázi flexibilního serveru Azure Database for MySQL. Ke spuštění této ukázky potřebujete místní instanci flexibilního serveru Azure Database for MySQL.

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

  composer install
  php artisan migrate
  php artisan key:generate
  php artisan serve
  

1. Vytvoření prostředků flexibilního serveru App Service a Azure Database for MySQL

V tomto kroku vytvoříte prostředky Azure. Kroky použité v tomto kurzu vytvoří konfiguraci flexibilního serveru App Service a Azure Database for MySQL, která je ve výchozím nastavení zabezpečená. 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.
• Modul runtime aplikace. Tady vyberete verzi PHP, kterou chcete použít pro vaši aplikaci.
• 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.

Pokyny	Snímek obrazovky
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.
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-laravel-mysql-tutorial. Oblast → Libovolná oblast Azure blízko vás. Název → msdocs-laravel-mysql-XYZ , kde XYZ je libovolný tři náhodné znaky. Tento název musí být v rámci služby Azure jedinečný. Zásobník modulu runtime → PHP 8.0. Flexibilní server MySQL je ve výchozím nastavení vybraný jako databázový stroj. Azure Database for MySQL je plně spravovaná databáze MySQL jako služba v Azure, která je kompatibilní s nejnovějšími komunitními edicemi. Poznamenejte si název databáze, který je pro vás vygenerovaný (app-name-database>).< Budete ho totiž potřebovat později. Vyberte Zkontrolovat a vytvořit. Po dokončení ověření vyberte Vytvořit.
Dokončení nasazení trvá několik minut a 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 služby App Service. Vytvoří se plán Linuxu na úrovni P1v2 . → 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 MySQL → přístupný jenom 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 databázového serveru MySQL ve virtuální síti. Po dokončení nasazení vyberte tlačítko Přejít k prostředku . Přejdete přímo do aplikace App Service.

2. Nastavení připojení k databázi

Průvodce vytvořením vygeneroval nastavení aplikace, které můžete použít pro připojení k databázi, ale ne ve formátu, který se dá použít pro váš kód. V tomto kroku upravíte a aktualizujete nastavení aplikace na formát, který vaše aplikace potřebuje.

Pokyny	Snímek obrazovky
Na stránce služby App Service v nabídce vlevo vyberte Konfigurace.
Na kartě Nastavení aplikace na stránce Konfigurace vyberte pro každé z následujících nastavení možnost Upravit, aktualizujte pole Název novými hodnotami a vyberte OK. Aktuální název Nový název AZURE_MYSQL_DBNAME DB_DATABASE AZURE_MYSQL_HOST DB_HOST AZURE_MYSQL_USERNAME DB_USERNAME AZURE_MYSQL_PASSWORD DB_PASSWORD
Vytvořte nové MYSQL_ATTR_SSL_CA nastavení databáze: Vyberte Nové nastavení aplikace. Do pole Název zadejte MYSQL_ATTR_SSL_CA. Do pole Hodnota zadejte /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ě, které vám usnadní práci. Vyberte OK.
Podle stejných kroků vytvořte následující další nastavení aplikace a pak vyberte Uložit. APP_DEBUG: Jako hodnotu použijte true. Jedná se o proměnnou ladění Laravel. APP_KEY: Jako hodnotu použijte base64:Dsz40HWwbCqnq0oxMsjq7fItmKIeBfCBGORfspaI1Kw= . Toto je šifrovací proměnná 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.

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í. Pomocí editoru Visual Studio Code provedete určité změny přímo v prohlížeči a pak necháte GitHub Actions nasadit automaticky za vás.

Pokyny	Snímek obrazovky
V novém okně prohlížeče: Přihlaste se k účtu GitHub. Přejděte na https://github.com/Azure-Samples/laravel-tasks. Vyberte Fork. Vyberte Vytvořit fork.
Na stránce GitHubu otevřete Visual Studio Code v prohlížeči stisknutím klávesy . .
V editoru Visual Studio Code v prohlížeči otevřete v průzkumníku konfiguraci/database.php . mysql V připojení se dozvíte, že nastavení aplikace, která jste vytvořili dříve pro připojení MySQL, se už používají (DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD, MYSQL_ATTR_SSL_CA).
Zpět na stránce služby App Service v nabídce vlevo vyberte Deployment Center.
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 laravel-tasks. Ve větvi vyberte hlavní. V horní nabídce vyberte Uložit. App Service potvrdí soubor pracovního postupu do vybraného úložiště GitHub v .github/workflows adresáři.
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. 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í.
Pokud chcete v kódu provést jakékoli změny, přejděte v prohlížeči do editoru Visual Studio Code: Vyberte rozšíření správy zdrojového kódu . Vedle změněného souboru, například database.php, vyberte + , aby se vaše změny zfázily. Do textového pole zadejte zprávu potvrzení, například add certificate. Zaškrtnutím zaškrtnutí potvrďte a nasdílíte změny do GitHubu. Pokud se vrátíte na stránku Deployment Center, zobrazí se nová položka protokolu, protože se spustí jiné spuštění. Počkejte na dokončení spuštění. Trvá to asi 15 minut. Tip Akce GitHubu je definovaná souborem v úložišti GitHub v .githubu/pracovním postupu. Můžete ho zrychlit přizpůsobením souboru.

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

Průvodce vytvořením umístí instanci flexibilního serveru Azure Database for 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.

Pokyny	Snímek obrazovky
Na stránce služby App Service: V nabídce vlevo vyberte SSH. Vyberte Přejít. V prohlížeči se otevře relace SSH s kontejnerem služby App Service. Pokud chcete, můžete přejít přímo na https://<app-name>.scm.azurewebsites.net/webssh/host místo toho.
V terminálu SSH: CD do kořenového adresáře kódu aplikace: cd /home/site/wwwroot Spusťte migrace databází z kořenového adresáře aplikace. php artisan migrate --force Poznámka: Kromě restartování aplikace se můžou zachovat jenom změny v /home souborech. Změny mimo /home provoz se neuchovávají.

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

Životní cyklus aplikace Laravel začíná v adresáři /public . Výchozí kontejner PHP 8.0 pro App Service používá Nginx, který začíná 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 8.0 (/etc/nginx/sites-available/default). Pro usnadnění vašeho pohodlí obsahuje ukázkové úložiště vlastní konfigurační soubor s názvem výchozí. Jak už jsme uvedli dříve, nechcete tento soubor nahradit pomocí prostředí SSH, protože změny se po restartování aplikace ztratí.

Pokyny	Snímek obrazovky
Na stránce služby App Service: V nabídce vlevo vyberte Konfigurace. Vyberte kartu Obecné nastavení.
Na kartě Obecné nastavení: 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. Nahradí konfigurační soubor Nginx v kontejneru PHP 8.0 a restartuje Nginx. Tato konfigurace zajistí, že se tato změna provede v kontejneru při každém spuštění. Zvolte Uložit.

6. Přejděte do aplikace.

Pokyny	Snímek obrazovky
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.
Přidejte do seznamu několik úkolů. Blahopřejeme, ve službě Aplikace Azure Service spouštíte aplikaci PHP řízenou daty.

7. Streamování diagnostických protokolů

Pokyny	Snímek obrazovky
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 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ů.

Pokyny	Snímek obrazovky
Na panelu hledání v horní části webu Azure Portal: Zadejte název skupiny prostředků. Vyberte tuto skupinu prostředků.
Na stránce skupiny prostředků vyberte Odstranit skupinu prostředků.
Potvrďte odstranění zadáním názvu skupiny prostředků. Vyberte Odstranit.

Nejčastější dotazy

• Kolik stojí toto nastavení?
• Návody připojení k flexibilní serverové databázi Azure Database for MySQL, která je zabezpečená za virtuální sítí?
• Jak místní vývoj aplikací funguje s GitHub Actions?
• Proč je nasazení GitHub Actions tak pomalé?

Kolik stojí toto nastavení?

Ceny pro prostředky vytvoření jsou následující:

• Plán služby App Service se vytvoří na úrovni Premium V2 a dá se vertikálně navýšit nebo snížit. Podívejte se na ceny služby App Service.
• Instance flexibilního serveru Azure Database for MySQL se vytváří na úrovni B1ms a dá se vertikálně navýšit nebo snížit. 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 flexibilního serveru Azure Database for MySQL.
• 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 připojení k flexibilní serverové databázi Azure Database for MySQL, která je zabezpečená za virtuální sítí?

Pokud se chcete připojit k flexibilní serverové databázi Azure Database for MySQL, můžete použít několik metod založených na nástrojích a prostředích, které máte k dispozici:

• Přístup k nástrojům příkazového řádku:
  • mysql Pro základní přístup použijte příkaz z terminálu SSH aplikace.
• Desktopové nástroje (například MySQL Workbench):
  • Použití tunelového propojení SSH s Azure CLI:
    • Vytvořte relaci SSH pro webovou aplikaci pomocí Azure CLI.
    • Pomocí relace SSH tunelujte provoz do MySQL.
  • Použití sítě VPN typu site-to-site nebo virtuálního počítače Azure:
    • Váš počítač musí být součástí virtuální sítě.
    • Zvažte použití:
      • Virtuální počítač Azure propojený s jednou z podsítí.
      • Počítač v místní síti, který má připojení VPN typu site-to-site k virtuální síti Azure.
• Integrace Azure Cloud Shellu:
  • Integrujte Azure Cloud Shell s virtuální sítí pro přímý přístup.

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 a každý git push spustí nové sestavení a nasazení. Z místního klonu úložiště GitHub provedete požadované aktualizace nasdílení změn do GitHubu. 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 spuštění sestavení a následného nasazení se dvěma úlohami. 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ětšinu času potřebných procesem dvou úloh stráví 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í.

Shrnutí

V tomto kurzu jste se naučili, jak:

• Vytvoření flexibilní serverové aplikace PHP a Azure Database for MySQL ve výchozím nastavení zabezpečení v Azure
• Konfigurace tajných kódů připojení k flexibilnímu serveru Azure Database for MySQL pomocí nastavení aplikace
• Nasazení kódu aplikace pomocí GitHub Actions
• Aktualizace a opětovné nasazení aplikace
• Bezpečné spouštění migrací databází
• Streamovat diagnostické protokoly z Azure
• Spravovat aplikaci na webu Azure Portal

Související obsah

• Kurz: Mapování vlastního názvu DNS na aplikaci
• Správa prostředků na webu Azure Portal
• Správa flexibilního serveru Azure Database for MySQL pomocí Azure CLI