教學課程：將 PHP、MySQL 和 Redis 應用程式部署至 Azure App 服務

建立應用程式服務與資料庫

在此步驟中，您會建立 Azure 資源。 本教學課程中使用的步驟會建立一組預設保護資源，其中包含 App Service 和適用於 MySQL 的 Azure 資料庫。 在建立流程中，請指定：

• Web 應用程式的 [名稱]。 它用來做為應用程式的 DNS 名稱的一部分。
• 要實際執行應用程式的區域。 它也是你應用程式 DNS 名稱的一部分。
• 應用程式的執行階段堆疊。 您可以在此處選取要用於應用程式的 PHP 版本。
• 應用程式的託管方案。 這是定價等級，其中包含應用程式的一組功能和擴充能力。
• 應用程式的 [資源群組]。 資源群組可以讓你將應用程式所需的所有 Azure 資源分組在一個邏輯容器中。

登入 Azure 入口網站。 請依照以下步驟建立您的 Azure App 服務 資源。

安全連線秘密

部署已經在應用程式設定中產生連線能力變數。 安全最佳做法是完全將秘密排除在 App Service 之外。 將你的秘密移到金鑰保險庫，並利用服務連接器將應用程式設定改為 金鑰庫參考 。

總結來說，確保連線秘密的程序為：

• 從 App Service 應用程式的環境變數擷取連線秘密。
• 建立金鑰保存庫。
• 使用系統指派的受控識別建立 金鑰保存庫 連線。
• 更新服務連接器以將秘密儲存在金鑰保存庫中。

有問題嗎？ 查看疑難排解區段。

配置 Laravel 變數

部署範例程式碼

在此步驟中，請使用 GitHub Actions 來設定 GitHub 部署。 這只是部署至 App Service 的許多方式之一，但也是在部署程序中持續整合的絕佳方式。 根據預設，每次對您的 GitHub 存放庫執行 git push 都會開始建置和部署動作。

有問題嗎？ 查看疑難排解區段。

產生資料庫結構

建立精靈會將 MySQL 資料庫伺服器放在私人端點後，因此只能從虛擬網路存取。 因為 App Service 應用程式已經與虛擬網路整合，所以使用資料庫執行資料庫移轉的最簡單方式，就是直接從 App Service 容器內執行資料庫移轉。

改變站點根目錄

Laravel 應用程式生命週期是在 /public 目錄中啟動。 App Service 的預設 PHP 容器會使用 Nginx，這會在應用程式的根目錄中啟動。 若要變更網站根目錄，您必須變更 PHP 容器中的 Nginx 設定檔 (/etc/nginx/sites-available/default)。 範例儲存庫包含一個稱為 default 的自訂設定檔。 如前所述，你不應該用 SSH shell 來替換這個檔案。 這個變更不在 /home 內，因此應用程式重新啟動後將會消失。

瀏覽至應用程式

資料流診斷記錄

Azure App 服務 會擷取所有登入到主控台的訊息，以協助您診斷應用程式的問題。 樣本應用程式在其每個端點中輸出主控台記錄訊息，以展示此功能。 預設情況下，Laravel 的日誌功能（例如 Log::info()）會輸出到本地檔案。 您先前的 LOG_CHANNEL 應用程式設定讓您能從 App Service 記錄資料流存取記錄項目。

清除資源

完成後，您可以刪除資源群組，以從 Azure 訂用帳戶中刪除所有資源。

建立 Azure 資源並部署範例應用程式

在此步驟中，您會建立 Azure 資源，並將範例應用程式部署至 Linux 上的 App Service。 本教學課程中使用的步驟會建立一組預設保護資源，其中包含 App Service 和適用於 MySQL 的 Azure 資料庫。

GitHub Codespace 已經有 Azure 開發人員 CLI （AZD）。

1. 使用 php artisan key:generate --show產生 Laravel 加密金鑰：

   php artisan key:generate --show
   

2. 執行 azd auth login 命令並遵循提示來登入 Azure：

   azd auth login
   

3. 使用 azd up 命令建立必要的 Azure 資源，並部署應用程式程式碼。 請遵循提示選取 Azure 資源所需的訂用帳戶和位置。

   azd up
   

4. 出現提示時，請提供下列答案：

   問題	回答
   輸入新的環境名稱	輸入唯一名稱。 AZD 範本會使用此名稱作為 Azure 中 Web 應用程式的 DNS 名稱一部分 (<app-name>-<hash>.azurewebsites.net)。 允許英數字元與連字號。
   選取要使用的 Azure 訂用帳戶	選取您的訂用帳戶。
   選取要使用的 Azure 位置	選取位置。
   輸入 『appKey』 基礎結構安全參數的值	請在這裡使用 php artisan key:generate --show 的輸出。 AZD 樣本會為其建立金鑰保存庫秘密，以供您在應用程式中使用。
   輸入 『databasePassword』 基礎結構安全參數的值	MySQL 的資料庫密碼。 長度必須至少為 8 個字元，且包含大寫字母、小寫字母、數位和特殊字元。

   azd up這個指令大約需要15分鐘完成。 這個指令也會編譯並部署你的應用程式碼，但你之後會修改程式碼以配合 App Service。 執行時，命令會提供佈建和部署程式的相關資訊，包括 Azure 中部署的連結。 完成時，命令也會顯示部署應用程式的連結。

   此 AZD 範本包含使用下列 Azure 資源產生預設安全架構的檔案 (azure.yaml 和 infra 目錄)：

   • 資源群組：所有已建立資源的容器。
   • App Service 方案：定義 App Service 的計算資源。 系統會在 B1 層中建立 Linux 方案。
   • App Service：代表您的應用程式，並在 App Service 方案中執行。
   • 虛擬網路：與 App Service 應用程式整合，並隔離後端網路流量。
   • 適用於 MySQL 的 Azure 資料庫 彈性伺服器：只能透過 DNS 區域整合從虛擬網路存取。 系統會為您在伺服器上建立資料庫。
   • Azure Managed Redis：僅能從虛擬網路內部存取。
   • 私人端點：虛擬網路中的金鑰保存庫和 Redis 快取的存取端點。
   • 私人 DNS 區域：啟用虛擬網路中的金鑰保存庫、資料庫伺服器和 Redis 快取的 DNS 解析。
   • Log Analytics 工作區：作為應用程式傳送記錄的目標容器，您也可以在其中查詢記錄。
   • 金鑰保存庫：當您使用 AZD 重新部署時，用來保留資料庫密碼。

有問題嗎？ 查看疑難排解區段。

在應用程式代碼中使用 Azure 連接字串

你使用的 AZD 範本已經在 應用程式設定 中產生了連接變數，並輸出到終端機。 應用程式設定是將連線秘密保留在程式碼存放庫外部的一個方法。

1. 在 AZD 輸出中，尋找以 AZURE_MYSQL_ 和 AZURE_REDIS_開頭的應用程式設定。 只會顯示設定名稱。 其在 AZD 輸出中看起來像這樣：

   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
   

   設定以 AZURE_MYSQL_ 開頭的是 MySQL 資料庫的連線變數。 以 AZURE_REDIS_ 開頭的設定適用於 Azure Managed Redis。 您稍後需要在程式碼中使用它們。 AZD 範本會直接顯示 Azure 入口網站應用程式設定頁面的連結。

2. 從檔案總管開啟 config/database.php。 此檔案為資料庫與 Redis 快取連線的設定檔。

3. 尋找定義mysql連接的部分（第 46-64 行），並將DB_HOST、DB_PORT、DB_DATABASE、DB_USERNAME和DB_PASSWORD替換為AZD輸出中的AZURE_MYSQL_應用程式設定。 您的 mysql 連線看起來應該像下列程序代碼。

   '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'),
       ]) : [],
   ],
   

   如需 Laravel 中資料庫組態的詳細資訊，請參閱 Laravel 檔。

4. 找到定義 Azure Managed Redis 連線的部分（第 140-147 行），然後將 REDIS_HOST、REDIS_PASSWORD、REDIS_PORT 和 REDIS_CACHE_DB 替換為 AZD 輸出中的 Azure_REDIS_ 應用程式設定。 此外，將 'scheme' => 'tls', 添加至連線。 快取連線看起來應該如下列程式碼所示：

   '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', '10000'),
       'database' => env('AZURE_REDIS_DATABASE', '0'),
   ],
   

   如需 Laravel 中 Redis 快取組態的詳細資訊，請參閱 Laravel 檔。

   備註

   請記住，尚未部署您的變更。 您會在下一步驟的末尾部署它們。

在網頁應用程式中設定 Laravel 設定

1. 從檔案總管開啟 infra/resources.bicep。 這個檔案是用來定義已建立的 Azure 資源的 Bicep 檔案。

2. 找到 App Service 應用程式的資源定義，並取消第 319 行的評論：

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

   Laravel 應用程式生命週期 從 /public 目錄開始，而不是應用程式根目錄。 App Service 的預設 PHP 容器會使用 Nginx，這會在應用程式根目錄中啟動。 若要變更網站根目錄，您必須變更 PHP 容器中的 Nginx 設定檔 (/etc/nginx/sites-available/default)。

   範例儲存庫包含一個名為 default 的替換設定檔，該檔案會指示 Nginx 在 /public 目錄中尋找。 每當應用程式開始套用應用檔案取代，或每當 Linux 容器從初始狀態重新載入時，appCommandLine 中的這個自訂命令就會執行。

3. 找到定義應用程式設定的部分（第 514-518 行），然後取消註解。 這些應用程式設定如下：

   設定	說明
   CACHE_DRIVER	告訴 Laravel 使用 Redis 作為其快取 （請參閱 Laravel 檔）。
   MYSQL_ATTR_SSL_CA	需要 開啟 Azure 中 MySQL 的 TLS 連線。 為了方便起見，憑證檔案會包含在範例存放庫中。 此變數會被 config/database.php 中的 mysql 聯機使用
   LOG_CHANNEL	告知 Laravel 將記錄傳送至 stderr，讓其可供 App Service 記錄使用（請參閱 Laravel 檔）。
   APP_DEBUG	在 Laravel 中啟用偵錯模式頁面（請參閱 Laravel 檔）。
   APP_KEY	Laravel 加密變數。 AZD 範本已建立 金鑰保存庫 密碼（第 212-217 行），因此您可以使用 金鑰保存庫 參考來存取。

4. 回到 Codespace 終端機，再次執行 azd up 。

   azd up
   

有問題嗎？ 查看疑難排解區段。

產生資料庫結構

使用受虛擬網路保護的 MySQL 資料庫，在 App Service 的 Linux 容器中透過 SSH 會話執行 Laravel 資料庫移轉是最簡單的方式。

1. 在 AZD 輸出中，尋找 SSH 工作階段的 URL，並在瀏覽器中瀏覽至目標。 輸出中看起來像這樣：

   Open SSH session to App Service container at: <URL>
   

2. 在 SSH 工作階段中，從 /home/site/wwwroot 目錄執行資料庫移轉：

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

   如果成功，App Service 已成功連線至資料庫。

有問題嗎？ 查看疑難排解區段。

瀏覽至應用程式

1. 在 AZD 輸出中，尋找您應用程式的 URL，然後在瀏覽器中開啟該 URL。 AZD 輸出中 URL 看起來像這樣：

   Deploying services (azd deploy)
   
     (✓) Done: Deploying service web
     - Endpoint: <URL>
   

2. 將幾項工作新增至清單。

   

   恭喜，您正在 Azure App 服務 中執行 Web 應用程式，並安全地連線至適用於 MySQL 的 Azure 資料庫。

有問題嗎？ 查看疑難排解區段。

資料流診斷記錄

Azure App 服務 會擷取所有登入到主控台的訊息，以協助您診斷應用程式的問題。 為了方便起見，AZD 範本已啟用本機檔案系統日誌功能，並將日誌送至 Log Analytics 工作區。

樣本應用程式在其每個端點中輸出主控台記錄訊息，以展示此功能。 預設情況下，Laravel 的日誌功能（例如 Log::info()）會輸出到本地檔案。 您先前的 LOG_CHANNEL 應用程式設定讓您能從 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]);
});

在 AZD 的輸出中，找到用於傳送 App Service 記錄的連結，然後在瀏覽器中打開該連結。 連結在 AZD 輸出中看起來像這樣：

Stream App Service logs at: <URL>

有問題嗎？ 查看疑難排解區段。

清除資源

若要刪除目前部署環境中的所有 Azure 資源，請執行 azd down 並遵循提示。

azd down

• 這設定會產生多少費用？
• 如何使用其他工具連線到虛擬網路後方的 MySQL 資料庫？
• 如何將APP_KEY應用程式設定變更為 金鑰保存庫 參考？
• 本機應用程式開發如何與 GitHub Actions 搭配運作？
• 為何 GitHub Actions 部署速度過慢？
• 我沒有權限可建立使用者指派的身分識別
• 我可以在 Codespace 中使用 GitHub Copilot 執行哪些作業？

• 這設定會產生多少費用？
• 如何使用其他工具連線到虛擬網路後方的 MySQL 資料庫？
• 本機應用程式開發如何與 GitHub Actions 搭配運作？
• 為何 GitHub Actions 部署速度過慢？
• 我沒有權限可建立使用者指派的身分識別
• 我可以在 Codespace 中使用 GitHub Copilot 執行哪些作業？

如何將APP_KEY應用程式設定變更為 金鑰保存庫 參考？

在 Azure 入口網站的 Configure Laravel 變數步驟中，你可以透過在 GitHub 程式碼空間執行以下 Azure CLI 指令，切換 APP_KEY 到 金鑰保存庫 參考：

# 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)"

你也可以在 Azure 入口網站做同樣的事。 如需詳細資訊，請參閱：

1. 金鑰保存庫 範圍的角色指派
2. 將秘密新增至 金鑰保存庫
3. 從 金鑰保存庫 擷取秘密
4. 設定應用程式設定