チュートリアル: Azure App Service に ASP.NET Core および Azure SQL Database アプリをデプロイする

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

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

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

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

2. デバイスの接続文字列を確認する

作成ウィザードによって、SQL データベースと Redis キャッシュの接続文字列が既に生成されています。 この手順では、生成された接続文字列を後の手順のために確認します。

3. サンプル コードのデプロイ

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

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

SQL Database は仮想ネットワークによって保護されているため、dotnet データベースの移行を実行する最も簡単な方法は、SSH セッション内で App Service コンテナーを使うことです。

SSH セッションでは、 /home 内のファイルに対する変更のみが、アプリの再起動後も保持されます。 /home の外部の変更は永続化されません。

問題がある場合は、 「トラブルシューティング」セクションを確認してください。

5.アプリの参照

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

Azure App Service は、アプリケーションの問題を診断するために、コンソールに記録されたすべてのメッセージをキャプチャします。 サンプル アプリは、この機能を示すために、各エンドポイントにコンソール ログ メッセージを出力します。

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

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

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

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

開発コンテナーには、既に Azure Developer CLI (AZD) が含まれています。

1. リポジトリのルートから、azd init を実行します。

   azd init --template dotnet-app-service-sqldb-infra
   

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

   Question	Answer
   The current directory is not empty. (現在のディレクトリが空ではありません。) Would you like to initialize a project here in '<your-directory>'? ('<ディレクトリ>' でプロジェクトを初期化しますか?)	Y
   What would you like to do with these files? (これらのファイルをどうしますか?)	Keep my existing files unchanged (既存のファイルを変更しないでそのままにする)
   Enter a new environment name (新しい環境の名前を入力してください)	一意の名前を入力します。 AZD テンプレートでは、この名前を Azure での Web アプリの DNS 名の一部として使用します (<app-name>.azurewebsites.net)。 英数字とハイフンを使用できます。

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

   azd auth login
   

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

   azd up
   

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

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

   • [リソース グループ]: 作成されたすべてのリソースのコンテナー。
   • [App Service プラン]: App Service のコンピューティング リソースを定義します。 Basic レベルの Linux プランが作成されます。
   • [App Service]: アプリを表し、App Service プランで実行されます。
   • [仮想ネットワーク]: App Service アプリと統合され、バックエンド ネットワーク トラフィックを分離します。
   • プライベート エンドポイント: 仮想ネットワーク内のデータベース サーバーと Redis キャッシュのアクセス エンドポイント。
   • ネットワーク インターフェイス: プライベート エンドポイントごとに 1 つのプライベート IP アドレスを表します。
   • Azure SQL データベース サーバー: プライベート エンドポイントの背後からのみアクセスできます。
   • Azure SQL Database: サーバー上にデータベースとユーザーが作成されます。
   • Azure Cache for Redis: プライベート エンドポイントの背後からのみアクセスできます。
   • [プライベート DNS ゾーン]: 仮想ネットワーク内のデータベース サーバーと Redis キャッシュの DNS 解決を可能にします。

問題がある場合は、 「トラブルシューティング」セクションを確認してください。

3.接続文字列を確認する

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

1. AZD の出力で、設定 AZURE_SQL_CONNECTIONSTRING と AZURE_REDIS_CONNECTIONSTRING を見つけます。 シークレットを安全に保つため、設定の名前のみが表示されます。 これらは、AZD の出力では次のようになります。

    App Service app has the following connection strings:
   
            - AZURE_SQL_CONNECTIONSTRING
            - AZURE_REDIS_CONNECTIONSTRING
    

   AZURE_SQL_CONNECTIONSTRING には、Azure の SQL データベースへの接続文字列が含まれており、AZURE_REDIS_CONNECTIONSTRING には、Azure Redis Cache への接続文字列が含まれています。 これは、後でコードで使用する必要があります。

2. 便宜のために、AZD テンプレートでは、アプリのアプリ設定ページへの直接リンクが示されます。 そのリンクを見つけ、それを新しいブラウザー タブで開きます。

問題がある場合は、 「トラブルシューティング」セクションを確認してください。

4.サンプル コードを変更して再デプロイする

これらの変更をデプロイする前に、移行バンドルを生成する必要があります。

問題がある場合は、 「トラブルシューティング」セクションを確認してください。

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

SQL Database は仮想ネットワークによって保護されているため、データベースの移行を実行する最も簡単な方法は、SSH セッション内で App Service コンテナーを使うことです。 ただし、App Service Linux コンテナーには .NET SDK がないため、データベース移行を実行する最も簡単な方法は、自己完結型の移行バンドルをアップロードすることです。

1. 次のコマンドを使用して、プロジェクトの移行バンドルを生成します。

   dotnet ef migrations bundle --runtime linux-x64 -o migrationsbundle
   

   ヒント

   サンプル アプリケーション (DotNetCoreSqlDb.csproj を参照) は、この migrationsbundle ファイルを含むように構成されています。 azd package ステージでは、migrationsbundle がデプロイ パッケージに追加されます。

2. azd upを使用してすべての変更をデプロイします。

   azd up
   

3. azd の出力で SSH セッションの URL を見つけて、ブラウザーでそこに移動します。 出力では次のようになります。

    Open SSH session to App Service container at: https://<app-name>.scm.azurewebsites.net/webssh/host
    

4. SSH ターミナルで、次のコマンドを実行します。

   cd /home/site/wwwroot
   ./migrationsbundle -- --environment Production
   

   それに成功すると、App Service はデータベースに正常に接続した状態になります。 --environment Production は、"Program.cs" で行ったコードの変更に対応します。

SSH セッションでは、 /home 内のファイルに対する変更のみが、アプリの再起動後も保持されます。 /home の外部の変更は永続化されません。

問題がある場合は、 「トラブルシューティング」セクションを確認してください。

6.アプリの参照

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

    Deploying services (azd deploy)
   
      (✓) Done: Deploying service web
      - Endpoint: https://<app-name>.azurewebsites.net/
    

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

   

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

問題がある場合は、 「トラブルシューティング」セクションを確認してください。

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

Azure App Service はコンソール ログをキャプチャできるので、アプリケーションに関する問題の診断に役立ちます。 便宜のために、AZD テンプレートでは、既にローカル ファイル システムへのログ記録が有効になっており、それらのログが Log Analytics ワークスペースに配布されています。

次のスニペットに示すように、このサンプル アプリケーションには、この機能を示す標準のログ記録ステートメントが含まれています。

public async Task<IActionResult> Index()
{
    var todoItems = await _cache.GetAsync(_TodoItemsCacheKey);
    if (todoItems != null)
    {
        _logger.LogInformation("Data from cache.");
        var todoList = JsonConvert.DeserializeObject<List<Todo>>(Encoding.UTF8.GetString(todoItems));
        return View(todoList);
    }
    else
    {
        _logger.LogInformation("Data from database.");
        var todoList = await _context.Todo.ToListAsync();
        var serializedTodoList = JsonConvert.SerializeObject(todoList);
        await _cache.SetAsync(_TodoItemsCacheKey, Encoding.UTF8.GetBytes(serializedTodoList));
        return View(todoList);
    }
}

AZD の出力で、App Service ログをストリーミングするためのリンクを見つけ、ブラウザーでそこに移動します。 このリンクは、AZD の出力では次のようになります。

Stream App Service logs at: https://portal.azure.com/#@/resource/subscriptions/<subscription-guid>/resourceGroups/<group-name>/providers/Microsoft.Web/sites/<app-name>/logStream

Java アプリのログ記録の詳細については、一連の「.NET、Node.js、Python、Java アプリケーション用の Azure Monitor OpenTelemetry を有効にする」をご覧ください。

問題がある場合は、 「トラブルシューティング」セクションを確認してください。

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

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

azd down