チュートリアル: PHP、MySQL、Redis アプリを Azure App Service にデプロイする

2 - App Service、データベース、キャッシュを作成する

この手順では、Azure リソースを作成します。 このチュートリアルで使用する手順では、App Service、Azure Database for MySQL、Azure Cache for Redis を含む一連のセキュリティで保護された既定のリソースを作成します。 作成プロセスでは、次のように指定します。

• 名前: Web アプリの名前。 アプリの DNS 名の一部として使用されます。
• 世界でアプリを物理的に実行するためのリージョン。 これは、アプリの DNS 名の一部としても使用されます。
• アプリのランタイム スタック。 ここで、アプリに使う PHP のバージョンを選びます。
• アプリのホスティング プラン。 これは、アプリの一連の機能と容量のスケーリングを含む価格レベルです。
• アプリのリソース グループ。 リソース グループを使うと、アプリケーションに必要なすべての Azure リソースを (論理コンテナーに) グループ化できます。

Azure portal にサインインし、以下の手順に従って Azure App Service リソースを作成します。

3 - セキュリティで保護された接続シークレット

作成ウィザードにより、すでに接続変数がアプリの設定として自動的に生成されています。 ただし、セキュリティのベスト プラクティスは、App Service からシークレットを完全に排除することです。 シークレットをキー保管庫に移動し、サービスコネクタを使用してアプリ設定を Key Vault の参照 に変更します。

まとめると、接続シークレットをセキュリティで保護するためのプロセスには次の作業が含まれます。

• App Service アプリの環境変数から接続シークレットを取得する。
• キー コンテナーを作成する。
• システム割り当てマネージド ID を使用して Key Vault 接続を作成する。
• キー コンテナーにシークレットを格納するようにサービス コネクタを更新する。

問題がありますか？ 「トラブルシューティング」セクションを確認してください。

4 - Laravel 変数を構成する

5 - サンプル コードをデプロイする

この手順では、GitHub Actions を使用して GitHub のデプロイを構成します。 これは、App Service にデプロイする多くの方法の 1 つにすぎませんが、デプロイ プロセスで継続的インテグレーションを実現する優れた方法でもあります。 既定では、GitHub リポジトリに git push があるたびにビルドとデプロイのアクションが起動されます。

問題がありますか？ 「トラブルシューティング」セクションを確認してください。

6 - データベース スキーマを生成する

作成ウィザードでは、MySQL データベース サーバーをプライベート エンドポイントの背後に配置し、仮想ネットワークからのみアクセスできるようにします。 App Service アプリは既に仮想ネットワークと統合されているため、データベースでデータベース移行を実行するには、App Service コンテナー内から直接実行するのが最も簡単な方法です。

7 - サイト ルートの変更

Laravel アプリケーションのライフサイクルは、代わりに /public ディレクトリで開始されます。 App Service の既定の PHP コンテナーでは、アプリケーションのルート ディレクトリで起動する Nginx が使われます。 サイト ルートを変更するには、PHP コンテナー内 (/etc/nginx/sites-available/default) の Nginx 構成ファイルを変更する必要があります。 便宜上、サンプル リポジトリには default というカスタム構成ファイルが含まれています。 前述のとおり、変更は /home の外部で行われ、アプリの再起動後に変更内容が失われるため、SSH シェルを使ってこのファイルを置き換える必要はありません。

8 - アプリを参照する

9 - 診断ログをストリーム配信する

Azure App Service は、アプリケーションの問題を診断するために、コンソールに記録されたすべてのメッセージをキャプチャします。 サンプル アプリは、この機能を示すために、各エンドポイントにコンソール ログ メッセージを出力します。 既定では、Laravel のログ機能 (例: Log::info()) はローカル ファイルに出力されます。 以前の LOG_CHANNEL アプリ設定は、App Service ログ ストリームからログ エントリにアクセスできるようにします。

リソースをクリーンアップする

完了したら、リソース グループを削除することで、Azure サブスクリプションからすべてのリソースを削除できます。

2.Azure リソースを作成してサンプル アプリをデプロイする

このステップでは、Azure リソースを作成し、サンプル アプリを App Service on Linux にデプロイします。 このチュートリアルで使用される手順では、App Service と Azure Database for MySQL を含む既定でセキュリティ保護された一連のリソースを作成します。

GitHub codespace には、 Azure Developer CLI (AZD) が既に含まれています。

1. php artisan key:generate --showを使用して Laravel 暗号化キーを生成します。

   php artisan key:generate --show
   

2. azd auth login コマンドを実行し、プロンプトに従って Azure にサインインします。

   azd auth login
   

3. 必要な Azure リソースを作成し、azd up コマンドを使用してアプリ コードをデプロイします。 プロンプトに従って、Azure リソースの目的のサブスクリプションと場所を選択します。

   azd up
   

4. メッセージが表示されたら、次の回答を入力します。

   質問	答え
   Enter a new environment name (新しい環境の名前を入力してください)	一意の名前を入力します。 AZD テンプレートでは、この名前を Azure での Web アプリの DNS 名の一部として使用します (<app-name>-<hash>.azurewebsites.net)。 英数字とハイフンを使用できます。
   使用する Azure サブスクリプションを選択する	サブスクリプションを選択します。
   使用する Azure の場所を選択する	場所を選択します。
   'appKey' インフラストラクチャのセキュリティで保護されたパラメーターの値を入力します	ここでは、 php artisan key:generate --show の出力を使用します。 AZD テンプレートは、アプリで使用できる Key Vault シークレットを作成します。
   'databasePassword' インフラストラクチャのセキュリティで保護されたパラメーターの値を入力します	MySQL のデータベース パスワード。 長さは 8 文字以上で、大文字、小文字、数字、特殊文字を含める必要があります。

   azd up コマンドが完了するまで約 15 分かかります (大部分の時間は Redis キャッシュに費やされます)。 また、アプリケーションのコードのコンパイルとデプロイも行われますが、後でコードを変更して App Service で動くようにします。 実行中、このコマンドは、Azure のデプロイへのリンクを含む、プロビジョニングとデプロイのプロセスに関するメッセージを提供します。 完了すると、コマンドはデプロイ アプリケーションへのリンクも表示します。

   この AZD テンプレートには、次の Azure リソースを使用して既定でセキュリティ保護されたアーキテクチャを生成するファイル (azure.yaml と infra ディレクトリ) が含まれています。

   • [リソース グループ]: 作成されたすべてのリソースのコンテナー。
   • [App Service プラン]: App Service のコンピューティング リソースを定義します。 B1 レベルの Linux プランが作成されます。
   • [App Service]: アプリを表し、App Service プランで実行されます。
   • [仮想ネットワーク]: App Service アプリと統合され、バックエンド ネットワーク トラフィックを分離します。
   • Azure Database for MySQL Flexible Server: DNS ゾーン統合を通じて仮想ネットワークからのみアクセス可能です。 サーバー上にデータベースが自動的に作成されます。
   • [Azure Cache for Redis]: 仮想ネットワーク内からのみアクセスできます。
   • プライベート エンドポイント: 仮想ネットワーク内のキー コンテナーと Redis キャッシュのアクセス エンドポイント。
   • [プライベート DNS ゾーン]: 仮想ネットワーク内のキー コンテナー、データベース サーバー、Redis キャッシュの DNS 解決を可能にします。
   • [Log Analytics ワークスペース]: アプリでログを配布するためのターゲット コンテナーとして機能します。ここでは、ログにクエリを実行することもできます。
   • [キー コンテナー]: AZD を使用して再デプロイしたときにデータベース パスワードを同じに維持するために使用されます。

問題がありますか？ 「トラブルシューティング」セクションを確認してください。

3.アプリケーション コードで Azure 接続文字列を使用する

使用している AZD テンプレートにより、接続変数がアプリ設定として既に自動的に生成されており、それらが便宜のためにターミナルに出力されます。 アプリの設定は、接続のシークレットをコード リポジトリに残さないための 1 つの方法です。

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_で始まる設定は Redis Cache 用です。 これは、後でコードで使用する必要があります。 便宜上、AZD テンプレートには、Azure portal のアプリのアプリ設定ページへの直接リンクが表示されます。

2. エクスプローラーから config/database.php を開きます。 これは、データベースと Redis Cache 接続の構成ファイルです。

3. mysql接続を定義するパーツ (46 から 64 行目) を見つけ、AZD 出力のDB_HOST アプリ設定でDB_PORT、DB_DATABASE、DB_USERNAME、DB_PASSWORD、および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. Redis Cache 接続を定義する部分 (140 から 147 行目) を見つけ、AZD 出力の REDIS_HOST、 REDIS_PASSWORD、 REDIS_PORT、 REDIS_CACHE_DB を 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', '6379'),
       'database' => env('AZURE_REDIS_DATABASE', '1'),
   ],
   

   Laravel での Redis Cache の構成の詳細については、 Laravel のドキュメントを参照してください。

   注

   変更はまだデプロイされていないことに注意してください。 次の手順の最後にデプロイします。

4. WebアプリでLaravel設定を構成する

1. エクスプローラーで infra/resources.bicep を開きます。 これは、作成された Azure リソースを定義する Bicep ファイルです。

2. アプリ設定を定義するパーツ (510 から 514 行目) を見つけてコメントを解除します。 これらのアプリ設定は次のとおりです。

   設定	説明
   CACHE_DRIVER	Redis をキャッシュとして使用するように Laravel に指示します ( Laravel のドキュメントを参照)。
   MYSQL_ATTR_SSL_CA	Azure で MySQL への TLS 接続を開くために必要です。 便宜上、証明書ファイルはサンプル リポジトリに含まれています。 この変数は、config/database.php の mysql 接続によって使用されます
   LOG_CHANNEL	stderrにログをパイプするように Laravel に指示します。これにより、App Service ログで使用できるようになります (Laravel のドキュメントを参照)。
   APP_DEBUG	Laravel でデバッグ モード ページを有効にします ( Laravel のドキュメントを参照)。
   APP_KEY	Laravel 暗号化変数。 AZD テンプレートでは既に Key Vault シークレット (212 行目から 217 行目) が作成されているため、 Key Vault 参照を使用してアクセスできます。

3. infra/resources.bicep で、App Service アプリのリソース定義とコメント解除行 315 を見つけます。

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

   Laravel アプリケーションのライフサイクル は、アプリケーション ルートではなく /public ディレクトリから開始されます。 App Service の既定の PHP コンテナーでは、アプリケーション ルートで開始される Nginx が使用されます。 サイト ルートを変更するには、PHP コンテナー内 (/etc/nginx/sites-available/default) の Nginx 構成ファイルを変更する必要があります。 便宜上、サンプル リポジトリには default と呼ばれる置換構成ファイルが含まれており、 Nginx に /public ディレクトリを検索するように指示します。 appCommandLineのこのカスタム コマンドは、Linux コンテナーがクリーンな状態から再読み込みされるたびに、アプリがファイル置換の適用を開始するたびに実行されます。

4. codespace ターミナルに戻り、もう一度 azd up 実行します。

   azd up
   

問題がありますか？ 「トラブルシューティング」セクションを確認してください。

5.データベース スキーマを生成する

MySQL データベースが仮想ネットワークによって保護されている場合、Laravel データベースの移行を実行する最も簡単な方法は、App Service の Linux コンテナーとの SSH セッションにあります。

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 はデータベースに正常に接続しています。

問題がありますか？ 「トラブルシューティング」セクションを確認してください。

6.アプリに移動

1. AZD の出力で、アプリの URL を見つけ、ブラウザーでそこに移動します。 URL は、AZD の出力では次のようになります。

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

2. 一覧にいくつかのタスクを追加します。

   

   おめでとうございます。Azure Database for MySQL へのセキュリティで保護された接続を使用して、Web アプリが Azure App Service で実行されています。

問題がありますか？ 「トラブルシューティング」セクションを確認してください。

7.診断ログをストリーミングする

Azure App Service は、アプリケーションの問題を診断するために、コンソールに記録されたすべてのメッセージをキャプチャします。 便宜のために、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>

問題がありますか？ 「トラブルシューティング」セクションを確認してください。

8.リソースをクリーンアップする

現在のデプロイ環境内のすべての Azure リソースを削除するには、azd down を実行し、プロンプトに従います。

azd down

• この設定にはいくらかかりますか。
• 仮想ネットワークの背後にセキュリティ保護されている MySQL データベースに他のツールで接続するにはどうすればよいですか。
• APP_KEY アプリの設定を Key Vault 参照に変更するにはどうすればよいですか?
• GitHub Actions でのローカル アプリの開発はどのように行いますか。
• GitHub Actions のデプロイが遅いのはなぜですか。
• ユーザー割り当て ID を作成するためのアクセス許可がありません
• 自分のコードスペースで GitHub Copilot を使用して何ができますか?

• この設定にはいくらかかりますか。
• 仮想ネットワークの背後にセキュリティ保護されている MySQL データベースに他のツールで接続するにはどうすればよいですか。
• GitHub Actions でのローカル アプリの開発はどのように行いますか。
• GitHub Actions のデプロイが遅いのはなぜですか。
• ユーザー割り当て ID を作成するためのアクセス許可がありません
• 自分のコードスペースで GitHub Copilot を使用して何ができますか?

APP_KEY アプリの設定を Key Vault 参照に変更するにはどうすればよいですか?

「4 - Laravel 変数の構成」のポータルの手順から、GitHub コードスペースで次の Azure CLI コマンドを実行して、APP_KEYを Key Vault 参照に変更できます。

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

ポータルで同じ操作を実行することもできます。 詳細については、以下を参照してください。

1. Key Vault スコープのロールの割り当て
2. キー コンテナーにシークレットを追加する
3. キー コンテナーからシークレットを取得する
4. アプリケーションの設定を構成する