你当前正在访问 Microsoft Azure Global Edition 技术文档网站。 如果需要访问由世纪互联运营的 Microsoft Azure 中国技术文档网站,请访问 https://docs.azure.cn

教程:在 Azure 应用服务上生成 PHP (Laravel) 和 Azure Database for MySQL - 灵活服务器应用

适用于:Azure Database for MySQL - 灵活服务器

Azure 应用服务使用 Linux 操作系统,提供高度可缩放的自修补 Web 托管服务。 本教程演示如何(使用 Azure Database for MySQL 灵活服务器)在连接到 MySQL 数据库的Azure 应用服务中创建安全 PHP 应用。 完成本教程后,Linux 上的 Azure 应用服务中将会运行一个 Laravel 应用。

Screenshot of the Azure app example titled Task List showing new tasks added.

本教程介绍如何执行下列操作:

  • 在 Azure 中创建一个默认为安全的 PHP 和 MySQL 应用程序
  • 使用应用设置将连接机密配置到 MySQL
  • 使用 GitHub Actions 部署应用程序代码
  • 更新并重新部署应用
  • 安全运行数据库迁移
  • 从 Azure 流式传输诊断日志
  • 在 Azure 门户中管理应用

先决条件

示例应用程序

要继续学习本教程,请从资源库中克隆或下载示例应用程序:

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

若要在本地运行应用程序,请执行以下操作:

  • 在 .env 中,使用本地 Azure Database for MySQL 灵活服务器数据库中的设置配置数据库设置(如 DB_DATABASEDB_USERNAMEDB_PASSWORD。 需要一个本地 Azure Database for MySQL 灵活服务器实例才能运行此示例。

  • 在存储库的根目录中,使用以下命令启动 Laravel:

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

1 - 创建应用服务和 Azure Database for MySQL 灵活服务器资源

此步骤创建 Azure 资源。 本教程中使用的步骤会创建默认安全的应用服务和 Azure Database for MySQL 灵活服务器配置。 此创建过程中,你将指定:

  • Web 应用的名称。 此名称用作 Web 应用的 DNS 名称的一部分,其格式为 https://<app-name>.azurewebsites.net
  • 应用的运行时。 在此处选择要用于应用的 PHP 版本。
  • 应用的资源组。 使用资源组可将应用程序所需的所有 Azure 资源分组到一个逻辑容器中。

登录到 Azure 门户并按照以下步骤创建 Azure 应用服务资源。

说明 屏幕快照
在 Azure 门户中:
  1. 在 Azure 门户顶部的搜索栏中,输入“Web 应用数据库”。
  2. 选择“市场”标题下标记为“Web 应用 + 数据库”的项目。
还可以直接导航到创建向导
A screenshot showing how to use the search box in the top tool bar to find the Web App + Database creation wizard.
在“创建 Web 应用 + 数据库”页上,按如下所述填写表单。
  1. 资源组 → 选择“新建”,并使用名称 msdocs-laravel-mysql-tutorial。

  2. 区域 → 与你靠近的任何 Azure 区域。

  3. 名称 → msdocs-laravel-mysql-XYZ,其中 XYZ 是任意三个随机字符。 该名称在 Azure 中必须唯一。

  4. 运行时堆栈 → PHP 8.0。

    默认情况下,选择 MySQL - 灵活服务器作为数据库引擎。 Azure Database for MySQL 是 Azure 上完全托管的 MySQL 数据库即服务,与最新的社区版本兼容。

  5. 请注意为你生成的数据库名称 (<app-name>-database)。 稍后需要用到此信息。

  6. 单击“查看 + 创建”。

验证完成后,单击“创建”
A screenshot showing how to configure a new app and database in the Web App + Database wizard.
部署需要几分钟时间才能完成,会创建以下资源:
  • 资源组 → 所有已创建资源的容器。
  • 应用服务计划 → 定义应用服务的计算资源。 将创建 P1v2 层中的 Linux 计划。
  • 应用服务 → 表示应用,且在应用服务计划中运行。
  • 虚拟网络 → 与应用服务应用集成,并隔离后端网络流量。
  • Azure Database for MySQL - 灵活服务器 → 只能从虚拟网络访问。 你的数据库和用户创建于此服务器上。
  • 专用 DNS 区域 → 启用虚拟网络中 MySQL 数据库服务器的 DNS 解析。
部署完成后,单击“转到资源”按钮。 你将直接转到应用服务应用。
A screenshot showing the form to fill out to create a web app in Azure.

2 - 设置数据库连接

创建向导生成了用于连接数据库的应用设置,但其格式尚未适用于你的代码。 在此步骤中,可以编辑应用设置并将其更新为应用所需的格式。

说明 屏幕快照
在左侧菜单的“应用服务”页面中,选择“配置”。 A screenshot showing how to open the configuration page in App Service.
在“配置”页面的“应用程序设置”选项卡中,对于以下每个设置,单击“编辑”,用新值更新“名称”字段,然后单击“确定”。
当前名称 名称
AZURE_MYSQL_DBNAME DB_DATABASE
AZURE_MYSQL_HOST DB_HOST
AZURE_MYSQL_USERNAME DB_USERNAME
AZURE_MYSQL_PASSWORD DB_PASSWORD
A screenshot showing how to see the autogenerated connection string.
创建新 MYSQL_ATTR_SSL_CA 数据库设置:
  1. 单击“新应用程序设置”。

  2. 在“名称”字段中,输入“MYSQL_ATTR_SSL_CA”。

  3. 在“”字段中,输入“/home/site/wwwroot/ssl/DigiCertGlobalRootCA.crt.pem”。

    此应用设置指向访问 MySQL 服务器所需的 TLS/SSL 证书的路径。 为了方便起见,它包含在示例存储库中。

  4. 单击“确定”。

A screenshot showing how to create an app setting.
按照相同的步骤创建以下额外的应用程序设置,然后单击“保存”。
  • APP_DEBUG:使用 true 作为值。 这是 Laravel 调试变量

  • APP_KEY:使用 base64:Dsz40HWwbCqnq0oxMsjq7fItmKIeBfCBGORfspaI1Kw= 作为值。 这是 Laravel 加密变量

    重要

    为了方便起见,此处使用 APP_KEY 值。 对于生产方案,应在命令行中使用 php artisan key:generate --show 专门为你的部署进行生成。

A screenshot showing all the required app settings in the configuration page.

3 - 部署示例代码

在此步骤中,你将使用 GitHub Actions 配置 GitHub 部署。 这只是部署到应用服务的许多方法之一,也是一种在部署过程中持续集成的好方法。 默认情况下,GitHub 存储库的每个 git push 都会启动生成和部署操作。 你将在浏览器中直接使用 Visual Studio Code 对代码库进行更改,然后让 GitHub Actions 自动部署。

说明 屏幕快照
在新的浏览器窗口中:
  1. 登录到 GitHub 帐户。

  2. 导航到 https://github.com/Azure-Samples/laravel-tasks

  3. 单击“分支”。

  4. 单击“创建分支”。

A screenshot showing how to create a fork of the sample GitHub repository.
在 GitHub 页中,按 . 键在浏览器中打开 Visual Studio Code。 A screenshot showing how to open the Visual Studio Code browser experience in GitHub.
在浏览器的 Visual Studio Code中,在资源管理器中打开 config/database.php。在 mysql 连接中,会看到已使用之前为 MySQL 连接创建的应用设置(DB_HOSTDB_DATABASEDB_USERNAMEDB_PASSWORDMYSQL_ATTR_SSL_CA)。 A screenshot showing Visual Studio Code in the browser and an opened file.
返回“应用服务”页,在左侧菜单中,选择“部署中心”。 A screenshot showing how to open the deployment center in App Service.
在“部署中心”页上:
  1. 在“源”中,选择“GitHub”。 默认情况下,选择 GitHub Actions 作为生成提供程序。

  2. 登录到 GitHub 帐户,并按照提示授权 Azure。

  3. 在“组织”中,选择你的帐户。

  4. 在“存储库”中,选择 laravel-tasks。

  5. 在“分支”中,选择“主”。

  6. 在顶部菜单中,单击“保存”。

应用服务将工作流文件提交到 .github/workflows 目录中的所选 GitHub 存储库中。
A screenshot showing how to configure CI/CD using GitHub Actions.
在“部署中心”页上:
  1. 选择“日志”。 部署运行已启动。

  2. 在部署运行的日志项中,选择“生成/部署日志”。

    你已转到 GitHub 存储库,并看到 GitHub Action 正在运行。 工作流文件定义两个单独的阶段,即生成和部署阶段。

A screenshot showing how to open deployment logs in the deployment center.
若要对代码进行任何更改,请在浏览器中转到 Visual Studio Code:
  1. 选择“源代码管理”扩展。

  2. 在更改的文件(例如 database.php)旁边,选择 + 以暂存更改。

  3. 在文本框中,键入提交消息,例如 add certificate

  4. 选择复选标记以提交并推送到 GitHub。

如果返回到“部署中心”页,将看到新的日志条目,因为已启动其他运行。 等待运行任务完成。 大约需要 15 分钟。

提示

GitHub Action 由 GitHub 存储库中的文件在 .github/workflow 中定义。 可以通过自定义文件来加快速度。

A screenshot showing how to commit your changes in the Visual Studio Code browser experience.

4 - 生成数据库架构

创建向导将 Azure Database for MySQL 灵活服务器实例置于专用终结点后面,因此只能从虚拟网络访问该实例。 由于应用服务应用已与虚拟网络集成,因此使用数据库运行数据库迁移的最简单方法是直接从应用服务容器中运行。

说明 屏幕快照
在“应用服务”页中:
  1. 从左侧菜单中选择“SSH”。

  2. 选择“转到”。

浏览器中打开与应用服务容器的 SSH 会话。 如果需要,可以直接导航到 https://<app-name>.scm.azurewebsites.net/webssh/host
A screenshot showing how to open the SSH shell for your app from the Azure portal.
在 SSH 终端中:
  1. 持续部署到应用程序代码的根目录:

    cd /home/site/wwwroot
    
  2. 从应用程序根目录运行数据库迁移

    php artisan migrate --force
    

    注意

    只有对 /home 中文件的更改才能在应用重启之后持久保存。 不会保留 /home 外部的更改。

A screenshot showing the commands to run in the SSH shell and their output.

5 - 更改站点根路径

Laravel 应用程序生命周期在 /public 目录中开始。 应用服务的默认 PHP 8.0 容器使用 Nginx,该服务器从应用程序的根目录中开始。 若要更改站点根路径,需要在 PHP 8.0 容器 (/etc/nginx/sites-available/default) 中更改 Nginx 配置文件。 为方便起见,示例存储库包含一个名为 default 的自定义配置文件。 如前所述,你不想使用 SSH shell 替换此文件,因为在应用重启后,更改将丢失。

说明 屏幕快照
在“应用服务”页中:
  1. 在左侧菜单中选择“配置”。

  2. 选择“常规设置”选项卡。

A screenshot showing how to open the general settings tab in the configuration page of App Service.
在“常规设置”选项卡中:
  1. 在“启动命令”框中,输入以下命令:cp /home/site/wwwroot/default /etc/nginx/sites-available/default && service nginx reload。

    它将替换 PHP 8.0 容器中的 Nginx 配置文件并重启 Nginx。 此配置可确保每次启动容器时对容器进行此更改。

  2. 选择“保存”。

A screenshot showing how to configure a startup command in App Service.

6 - 浏览到应用

说明 屏幕快照
在“应用服务”页中:
  1. 从左侧菜单中选择“概述”。

  2. 选择应用的 URL。

    你也可以直接导航到 https://<app-name>.azurewebsites.net

A screenshot showing how to launch an App Service from the Azure portal.
向列表中添加一些任务。恭喜,你的数据驱动的 PHP 应用正在 Azure 应用服务中运行。 A screenshot of the Laravel app running in App Service.

7 - 流式传输诊断日志

说明 屏幕快照
在“应用服务”页中:
  1. 从左菜单中选择“应用服务日志”。

  2. 在“应用程序日志记录”下,选择“文件系统”。

A screenshot showing how to enable native logs in App Service in the Azure portal.
在左侧菜单中,单击“日志流”。会看到应用的日志,包括平台日志和容器内部的日志。 A screenshot showing how to view the log stream in the Azure portal.

清理资源

完成后,可以通过删除资源组从 Azure 订阅中删除所有资源。

说明 屏幕快照
在 Azure 门户顶部的搜索栏中:
  1. 输入资源组名称。

  2. 选择前面创建的资源组。

A screenshot showing how to search for and navigate to a resource group in the Azure portal.
在资源组页面上,单击“删除资源组”。 A screenshot showing the location of the Delete Resource Group button in the Azure portal.
  1. 输入资源组名称以确认删除。

  2. 单击 “删除”

A screenshot of the confirmation dialog for deleting a resource group in the Azure portal.

常见问题

此设置花费有多大?

创建资源的定价如下所示:

  • 应用服务计划是在高级 V2 层中创建的,可以纵向扩展或缩减。 请参阅应用服务定价
  • Azure Database for MySQL 灵活服务器实例是在 B1ms 层中创建的,可以纵向扩展或缩减。 使用 Azure 免费帐户时,B1ms 层在 12 个月内免费,不能超过每月限制。 请参阅 Azure Database for MySQL 灵活服务器定价
  • 除非配置额外的功能(例如对等互连),否则虚拟网络不会产生费用。 请参阅 Azure 虚拟网络定价
  • 专用 DNS 区域会产生少量费用。 请参阅 Azure DNS 定价

如何连接到在虚拟网络后面受到保护的 Azure Database for MySQL 灵活服务器数据库?

若要连接到 Azure Database for MySQL 灵活服务器数据库,可以根据可用的工具和环境使用几种方法:

  • 命令行工具访问
    • 使用应用的 SSH 终端中的 mysql 命令进行基本访问。
  • 桌面工具(例如 MySQL Workbench)
    • 通过 Azure CLI 使用 SSH 隧道
      • 使用 Azure CLI 创建到 Web 应用的 SSH 会话
      • 使用 SSH 会话将流量隧道传送到 MySQL。
    • 使用站点到站点 VPN 或 Azure VM
      • 计算机必须是虚拟网络的一部分。
      • 请考虑使用:
  • Azure Cloud Shell 集成

本地应用开发如何与 GitHub Actions 配合使用?

以应用服务自动生成的工作流文件为例,每个 git push 文件都会启动新的生成和部署运行。 从 GitHub 存储库的本地克隆中,将所需的更新推送到 GitHub。 例如:

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

为什么 GitHub Actions 部署速度这么慢?

应用服务自动生成的工作流文件定义生成后部署的双作业运行。 由于每个作业都在自己的干净环境中运行,因此工作流文件可确保 deploy 作业有权从 build 作业访问文件:

两个作业过程的大部分时间都是花费在上传和下载项目上。 如果需要,可以通过将两个作业合并为一个作业来简化工作流文件,这样就无需上传和下载步骤。

摘要

在本教程中,你了解了如何执行以下操作:

  • 在 Azure 中创建安全默认的 PHP 和 Azure Database for MySQL 灵活服务器应用
  • 使用应用设置配置到 Azure Database for MySQL 灵活服务器的连接机密
  • 使用 GitHub Actions 部署应用程序代码
  • 更新并重新部署应用
  • 安全运行数据库迁移
  • 从 Azure 流式传输诊断日志
  • 在 Azure 门户中管理应用

后续步骤