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

[アーティクル]
05/25/2023

このチュートリアルでは、データドリブンの ASP.NET Core アプリを Azure App Service にデプロイし、Azure SQL Database に接続する方法について説明します。また、アプリケーションでキャッシュコードを有効にする Azure Cache for Redis もデプロイします。 Azure App Service は、高いスケーラビリティを備え、パッチを自己適用する Web ホスティングサービスであり、アプリを Windows または Linux に簡単にデプロイできます。このチュートリアルでは ASP.NET Core 7.0 アプリを使用しますが、他のバージョンの ASP.NET Core および ASP.NET Framework の場合でもプロセスは同じです。

このチュートリアルには、次のものが必要です。

アクティブなサブスクリプションが含まれる Azure アカウント。 Azure アカウントがない場合は、無料で作成できます。
GitHub アカウント。 1 つ無料で取得することもできます。

サンプルアプリケーション

このチュートリアルで使用するサンプルアプリケーションを探索するには、リポジトリ https://github.com/Azure-Samples/msdocs-app-service-sqldb-dotnetcore からダウンロードするか、次の Git コマンドを使用して複製します。

git clone https://github.com/Azure-Samples/msdocs-app-service-sqldb-dotnetcore.git
cd msdocs-app-service-sqldb-dotnetcore

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 リソースを作成します。

手順 1: Azure portal 内で次を実行します。

Azure portal の上部にある検索バーに「Web app database」と入力します。
[Marketplace] の見出しの下にある [Web アプリとデータベース] というラベルの付いた項目を選びます。作成ウィザードに直接移動することもできます。

手順 2:[Web アプリとデータベースの作成] ページ内で、このフォームに次のように入力します。

[リソースグループ] → [新規作成] を選び、名前として msdocs-core-sql-tutorial を使います。
リージョン → 任意の近くの Azure リージョン。
[名前] → msdocs-core-sql-XYZ。ここで XYZ は任意のランダムな 3 文字です。この名前は Azure 全体で一意である必要があります。
[ランタイムスタック] → .NET 7 (STS)。
Add Azure Cache for Redis? (Azure Cache for Redis を追加しますか?) → はい。
ホスティングプラン → Basic。準備ができたら、後で運用価格レベルにスケールアップできます。
SQLAzure は、データベースエンジンとして既定で選択されています。 Azure SQL Database は、フルマネージドのサービスとしてのプラットフォーム (PaaS) データベースエンジンであり、安定した最新バージョンの SQL Server で常に実行されています。
[Review + create](レビュー + 作成) を選択します。
検証が完了した後、 [作成] を選択します。

手順 3: このデプロイは完了するまでに数分かかります。デプロイが完了したら、[リソースに移動] ボタンを選択します。 App Service アプリに直接移動しますが、次のリソースが作成されます。

リソースグループ → 作成されたすべてのリソースのコンテナーです。
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 解決を有効にします。

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

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

手順 1: [App Service] ページ内の左側のメニュー内で、[構成] を選びます。

手順 2:

ページの一番下までスクロールし、[接続文字列] セクションで AZURE_SQL_CONNECTIONSTRING を見つけます。この文字列は、作成ウィザードによって新しい SQL データベースから生成されました。アプリケーションを設定するには、この名前が必要になります。
また、[アプリケーションの設定] セクションで AZURE_REDIS_CONNECTIONSTRING を見つけます。この文字列は、作成ウィザードによって新しい Redis キャッシュから生成されました。アプリケーションを設定するには、この名前が必要になります。
必要に応じて、各設定の右側にある [編集] ボタンを選択し、その値を表示またはコピーできます。後で、AZURE_SQL_CONNECTIONSTRING および AZURE_REDIS_CONNECTIONSTRING を使用するようにアプリケーションを変更します。

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

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

手順 1: 新しいブラウザーウィンドウ内で次を実行します。

GitHub アカウントにサインインします。
https://github.com/Azure-Samples/msdocs-app-service-sqldb-dotnetcore に移動します。
[Fork] を選択します。
[Create fork] (フォークの作成) を選択します。

手順 2: [App Service] ページ内の左側のメニュー内で [デプロイセンター] を選びます。

手順 3: [デプロイセンター] ページ内で次を実行します。

[ソース] で、[GitHub] を選びます。既定では、ビルドプロバイダーとして GitHub Actions が選ばれます。
GitHub アカウントにサインインし、プロンプトに従って Azure を承認します。
[組織] で、自分のアカウントを選びます。
[リポジトリ] で、[msdocs-app-service-sqldb-dotnetcore] を選びます。
[ブランチ] で [main] を選びます。
上部のメニューから、[保存] を選択します。 App Service は、選んだ GitHub リポジトリの .github/workflows ディレクトリに、ワークフローファイルをコミットします。

手順 4: そのフォークされたサンプルの GitHub ページに戻り、. キーを押して、ブラウザー内で Visual Studio Code を開きます。

手順 5: ブラウザー内の Visual Studio Code 内で次を実行します。

エクスプローラーで DotNetCoreSqlDb/appsettings.json を開きます。
接続文字列名 MyDbConnection を AZURE_SQL_CONNECTIONSTRING に変更します。これは、前に App Service で作成した接続文字列と一致します。

手順 6:

エクスプローラーで DotNetCoreSqlDb/Program.cs を開きます。
options.UseSqlServer メソッドで、接続文字列名 MyDbConnection を AZURE_SQL_CONNECTIONSTRING に変更します。ここで、接続文字列がサンプルアプリケーションによって使用されます。
builder.Services.AddDistributedMemoryCache(); メソッドを削除し、以下のコードで置き換えます。これは、メモリ内キャッシュから Azure の Redis キャッシュを使用するようにコードを変更します。これを行うには、前の AZURE_REDIS_CONNECTIONSTRING を使用します。

builder.Services.AddStackExchangeRedisCache(options =>
{
options.Configuration = builder.Configuration["AZURE_REDIS_CONNECTIONSTRING"];
options.InstanceName = "SampleInstance";
});

手順 7:

エクスプローラーで .github/workflows/main_msdocs-core-sql-XYZ を開きます。このファイルは、App Service の作成ウィザードによって作成されました。
dotnet publish のステップで、コマンド dotnet tool install -g dotnet-ef --version 7.0.14 を使用して、Entity Framework Core ツールをインストールするためのステップを追加します。
新しいステップで、デプロイパッケージにデータベース移行バンドル (dotnet ef migrations bundle --runtime linux-x64 -p DotNetCoreSqlDb/DotNetCoreSqlDb.csproj -o ${{env.DOTNET_ROOT}}/myapp/migrate) を生成するための別のステップを追加します。移行バンドルは自己完結型の実行可能ファイルであり、.NET SDK を必要とせずに運用環境で実行できます。 App Service linux コンテナーには .NET ランタイムのみ含まれており、.NET SDK は含まれていません。

手順 8:

[ソース管理] 拡張機能を選びます。
テキストボックスに、Configure DB & Redis & add migration bundle のようなコミットメッセージを入力します。
[コミットしてプッシュ] を選択します。

手順 9: Azure portal 内の [デプロイセンター] ページ内に戻り、次を実行します。

[ログ] を選択します。新しいデプロイの実行が、コミットされた変更から既に開始されています。
デプロイの実行のログ項目で、最新のタイムスタンプを持つ [ビルドまたはデプロイログ] エントリを選びます。

手順 10: GitHub リポジトリに移動し、その GitHub アクションが実行されていることを確認します。ワークフローファイルでは、ビルドとデプロイという 2 つの異なるステージを定義します。 GitHub が実行されて、[完了] の状態が表示されるまで待ちます。これには数分かかります。

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

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

手順 1: [App Service] ページに戻り、左側のメニュー内で [SSH] を選びます。

手順 2: SSH ターミナル内で次を実行します。

cd /home/site/wwwroot を実行します。デプロイされたすべてのファイルがここにあります。
./migrate を使用して、GitHub ワークフローによって生成された移行バンドルを実行します。それに成功すると、App Service は SQL Database に正常に接続した状態になります。 /home 内のファイルへの変更のみが、アプリの再起動後も保持されます。 /home の外部の変更は永続化されません。

5.アプリの参照

手順 1: [App Service] ページ内で、次を実行します。

左側のメニューから [概要] を選びます。
アプリの URL を選びます。直接、https://<app-name>.azurewebsites.net に移動することもできます。

手順 2: この一覧にいくつかのタスクを追加します。セキュリティで保護されたデータドリブンの ASP.NET Core アプリが Azure App Service で実行されるようになりました。

ヒント

サンプルアプリケーションでは、キャッシュアサイドパターンが実装されています。 2 回目にデータビューにアクセスしたとき、またはデータを変更した後に同じページを再度読み込む場合、データベースではなくキャッシュからデータを読み込むため、Web ページの処理時間には、はるかに短い時間が表示されます。

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

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

手順 1: [App Service] ページ内で、次を実行します。

左側のメニューから、[App Service ログ] を選びます。
[アプリケーションログ記録] で [ファイルシステム] を選びます。

手順 2:左側のメニューから [ログストリーム] を選択します。プラットフォームログとコンテナー内のログを含む、アプリのログが表示されます。

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

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

手順 1: Azure portal の上部にある検索バーで次を行います。

リソースグループ名を入力します。
リソースグループを選択します。

手順 2: [リソースグループ] ページ内で、[リソースグループの削除] を選びます。

ステップ 3:

リソースグループの名前を入力して、削除を確定します。
[削除] を選択します。

よく寄せられる質問

この設定にはいくらかかりますか。
仮想ネットワークの背後でセキュリティで保護されている Azure SQL Database サーバーに他のツールで接続するにはどうすればよいですか?
GitHub Actions でのローカルアプリの開発はどのように行いますか。
GitHub Actions のデプロイ中に発生したエラーをデバッグする方法を教えてください

この設定にはいくらかかりますか。

作成リソースの価格は次のとおりです。

App Service プランは Basic レベルで作成され、スケールアップまたはスケールダウンできます。「App Service の価格」をご覧ください。
Azure SQL Database は、最小限のコアを持つ Standard シリーズハードウェア上の汎用サーバーレス層で作成されます。コストは少額であり、他のリージョンに配布することもできます。最大サイズを小さくすることでコストをさらに最小化することも、サービスレベル、コンピューティングレベル、ハードウェア構成、コア数、データベースサイズ、ゾーン冗長性を調整してスケールアップすることもできます。「Azure SQL Database の価格」を参照してください。
Azure Cache for Redis は、最小キャッシュサイズの Basic レベルで作成されます。このレベルには少ないコストがかかります。高い可用性、クラスタリング、およびその他の機能のために、より高いパフォーマンスレベルにスケールアップできます。「Azure Cache for Redis の価格」を参照してください。
仮想ネットワークでは、ピアリングなどの追加機能を構成しない限り、料金は発生しません。「Azure Virtual Network の価格」を参照してください。
プライベート DNS ゾーンでは、少額の料金が発生します。「Azure DNS の価格」を参照してください。

仮想ネットワークの背後でセキュリティで保護されている Azure SQL Database サーバーに他のツールで接続するにはどうすればよいですか?

コマンドラインツールからの基本的なアクセスには、アプリの SSH ターミナルから sqlcmd を実行できます。アプリのコンテナーには sqlcmd が付属していないため、手動でインストールする必要があります。インストールされたクライアントは、アプリの再起動後は保持されない点に注意してください。
SQL Server Management Studio クライアントまたは Visual Studio から接続するには、お使いのマシンが仮想ネットワーク内にある必要があります。たとえば、サブネットの 1 つに接続されている Azure VM、または Azure 仮想ネットワークとサイト間 VPN で接続されているオンプレミスネットワーク内のマシンが該当します。

GitHub Actions でのローカルアプリの開発はどのように行いますか。

App Service から自動生成されたワークフローファイルを例にとると、git push ごとに新しいビルドとデプロイの実行が起動されます。 GitHub リポジトリのローカルクローンから、必要な更新を行い、それを GitHub にプッシュします。次に例を示します。

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

GitHub Actions のデプロイ中に発生したエラーをデバッグする方法を教えてください

自動生成された GitHub ワークフローファイルでステップが失敗した場合は、失敗したコマンドを変更して、より詳細な出力を生成してみてください。たとえば、dotnet オプションを追加することで、任意の -v コマンドからより多くの出力を取得できます。変更をコミットおよびプッシュして、App Service への別のデプロイをトリガーします。

次のステップ

次のチュートリアルに進み、カスタムドメインと証明書を使用してアプリをセキュリティで保護する方法を学習してください。

カスタムドメインと証明書を使用してセキュリティ保護する

または、他のリソースを参照してください。

チュートリアル: マネージド ID を使用してシークレットなしで App Service から SQL Databaseに接続する

ASP.NET Core アプリの構成