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

Step 1: Azure ポータルで次の手順を実行します。

1. 上部の検索バーに「app service」と入力します。
2. [サービス] の見出しの下にある [App Service] というラベルの付いた項目を選びます。
3. [作成]>[Web アプリ] を選びます。 作成ウィザードに直接移動することもできます。

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

1. 名前: msdocs-core-sql-XYZ。 msdocs-core-sql-XYZ_group という名前のリソース グループが自動的に生成されます。
2. Runtime stack: .NET 8 (LTS)。
3. オペレーティング システム: Linux。
4. リージョン: お好みのリージョン。
5. Linux プラン: 新規作成 し、 msdocs-core-sql-XYZ という名前を使用します。
6. 価格プラン: 基本 B1。 準備ができたら、別の価格レベルにスケールアップできます。

ステップ 3:

1. [ データベース ] タブを選択します。
2. [ データベースの作成] を選択します。
3. エンジンで、SQLAzure を選択します。
4. Azure Cache for Redis を作成を選択します。
5. [ 名前] ([キャッシュ] の下) に、キャッシュの名前を入力します。
6. [SKU] で [Basic] を選択します。

手順 4:

1. [ デプロイ ] タブを選択します。
2. 継続的デプロイを有効にします。
3. Organization で、GitHubエイリアスを選択します。
4. [リポジトリ] で、[msdocs-app-service-sqldb-dotnetcore] を選びます。
5. [ブランチ] で、[starter-no-infra] を選択します。
6. 基本認証が無効になっていることを確認します。
7. [Review + create](レビュー + 作成) を選択します。
8. 検証が完了した後、 [作成] を選択します。

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

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

手順 1: 既存の接続文字列

1. App Service ページの左側のメニューで、[設定] > [環境変数] > [接続文字列] を選択します。
2. AZURE_SQL_CONNECTIONSTRING を選択します。
3. Add/Edit 接続文字列 の Value フィールドで、文字列の末尾にある Password= 部分を見つけます。
4. 後で使用するために、Password= の後のパスワード文字列をコピーしておきます。 この接続文字列を使用すると、プライベート エンドポイントの背後でセキュリティで保護された SQL データベースに接続できます。 ただし、シークレットは App Service アプリに直接保存されますが、これは最適ではありません。 同様に、redis cache 接続文字列 App settings タブにはシークレットが含まれています。 これを変更します。

手順 2: シークレットを安全に管理するためのキー コンテナーを作成する

1. 上部の検索バーに「key vault」と入力し、Marketplace>Key Vault を選択します。
2. リソース グループで、msdocs-core-sql-XYZ_group を選択します。
3. [キー コンテナー名] に、文字と数字のみで構成される名前を入力します。
4. [リージョン] をリソース グループと同じ場所に設定します。

手順 3: プライベート エンドポイントを使用してキー コンテナーをセキュリティ保護する

1. [ネットワーク] タブを選択します。
2. [パブリック アクセスを有効にする] の選択を解除します。
3. [プライベート エンドポイントを作成する] を選択します。
4. リソース グループで、msdocs-core-sql-XYZ_group を選択します。
5. ダイアログの [場所] で、App Service アプリと同じ場所を選択します。
6. [名前] に「msdocs-core-sql-XYZVvaultEndpoint」と入力します。
7. [仮想ネットワーク] で、msdocs-core-sql-XYZ_group グループ内の仮想ネットワークを選択します。
8. [ サブネット] で、使用可能な互換性のあるサブネットを選択します。 Web アプリ ウィザードが、あなたのために便利に作成しました。
9. [OK] を選択します。
10. [Review + create](確認と作成) を選択し、次に [作成] を選択します。 キー ボールトのデプロイが完了するのを待ちます。 "デプロイが完了しました" と表示されます。

手順 4:

1. 上部の検索バーに「msdocs-core-sql」と入力し、次に msdocs-core-sql-XYZ という App Service リソースを選択します。
2. [App Service] ページの左側にあるメニューで、[設定] > [サービス コネクタ] を選択します。 既に 2 つのコネクタが存在していますが、これらはアプリ作成ウィザードによって作成されたものです。
3. SQL データベースのコネクタの横にあるチェックボックスをオンにし、[編集] を選択します。
4. 認証 タブを選択します。
5. [パスワード] に、先ほどコピーしたパスワードを貼り付けます。
6. Store Secret in Key Vault を選択します。
7. Key Vault接続で、新規作成を選択します。 [接続の作成] ダイアログが編集ダイアログの上に開きます。

手順 5: Key Vault接続を確立します

1. Key Vault接続の Create connection ダイアログで、Key Vault で、前に作成したkey vaultを選択します。
2. [確認および作成] を選択します。
3. 検証が完了したら、[作成] を選択します。

手順 6: SQL データベース コネクタの設定を完了する

1. defaultConnector の編集ダイアログに戻ります。 [認証] タブで、キー コンテナー コネクタが作成されるまで待ちます。 完了すると、Key Vault接続 ドロップダウンで自動的に選択されます。
2. [次へ: ネットワーク] を選択します。
3. [ターゲット サービスへのアクセスを有効にするようにファイアウォール規則を構成する] を選択します。 アプリ作成ウィザードでは、プライベート エンドポイントを使用して SQL データベースが既にセキュリティで保護されています。
4. [保存] を選択します。 "更新に成功しました" という通知が表示されるまで待ちます。

手順 7: Key Vault シークレットを使用するように Redis コネクタを構成します

1. [Service Connector] ページで、Cache for Redis コネクタの横にあるチェック ボックスをオンにし、[ 編集] を選択します。
2. 認証 タブを選択します。
3. Store Secret in Key Vault を選択します。
4. [Key Vault接続] で、作成したKey Vaultを選択します。
5. [次へ: ネットワーク] を選択します。
6. [ターゲット サービスへのアクセスを有効にするようにファイアウォール規則を構成する] を選択します。
7. [保存] を選択します。 "更新に成功しました" という通知が表示されるまで待ちます。

手順 8: Key Vault統合を確認します

1. 左側のメニューで、[設定] > [環境変数] > [接続文字列] をもう一度選択します。
2. [AZURE_SQL_CONNECTIONSTRING] の横にある [値を表示] を選択します。 値は @Microsoft.KeyVault(...) にする必要があります。これは、シークレットがキー コンテナーで管理されるようになったため、key コンテナー参照であることを意味します。
3. Redis 接続文字列を確認するには、App settings タブを選択します。AZURE_REDIS_CONNECTIONSTRING の横にある Show 値 を選択します。 値も @Microsoft.KeyVault(...) にする必要があります。

Step 1: サンプル フォークのGitHubコード空間に戻り、git pull origin starter-no-infra を実行します。 これにより、新しくコミットされたワークフロー ファイルが codespace にプルされます。

手順 2 (オプション 1: GitHub Copilot):

1. [チャット] ビューを選択し、+ を選択して、新しいチャット セッションを開始します。
2. "@workspace アプリはデータベースとキャッシュにどのように接続しますか?" とCopilot クラスと、Program.cs。
3. 「運用モードでは、データベース用に AZURE_SQL_CONNECTIONSTRING と呼ばれる接続文字列を使用し、アプリの設定として AZURE_REDIS_CONNECTIONSTRING を使用したい」と尋ねると、CopilotがOption 2: without GitHub Copilotの手順に似たコードを提案してくれるかもしれません。その際、Program.csファイルを変更するよう指示されることもあります。
4. エクスプローラーで "Program.cs" を開き、コード候補を追加します。 GitHub Copilotは毎回同じ応答を返すわけではなく、常に正しいとは限りません。 その応答を微調整するために、さらに質問をする必要があるかもしれません。 ヒントについては、「 codespace のGitHub Copilotでできること」を参照>。

手順 2 (オプション 2: GitHub Copilotなし):

1. エクスプローラーで "Program.cs" を開きます。
2. コメント化されたコード (行 12-21) を見つけ、それをコメント解除します。 このコードは、AZURE_SQL_CONNECTIONSTRING を使用してデータベースに接続し、アプリ設定 AZURE_REDIS_CONNECTIONSTRINGを使用して Redis Cache に接続します。

手順 3 (オプション 1: GitHub Copilot):

1. エクスプローラーで ".github/workflows/starter-no-infra_msdocs-core-sql-XYZ" を開きます。 App Service 作成ウィザードでこのファイルが作成されました。
2. dotnet publish ステップを強調表示し、 を選択します。
3. Copilot に質問、" dotnet ef をインストールし、同じ出力フォルダーに移行バンドルを作成します。"
4. 提案を受け入れる場合は、[Accept] を選択します。 GitHub Copilotは毎回同じ応答を返すわけではなく、常に正しいとは限りません。 その応答を微調整するために、さらに質問をする必要があるかもしれません。 ヒントについては、「 codespace のGitHub Copilotでできること」を参照>。

手順 3 (オプション 2: GitHub Copilotなし):

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

手順 4:

1. [ソース管理] 拡張機能を選びます。
2. テキスト ボックスに、Configure Azure database and cache connections などのコミット メッセージを入力します。 または、 を選択して、GitHub Copilotにコミットメッセージの生成を任せてください。
3. [コミット] を選択し、[はい] で確定します。
4. [変更の同期 1] を選択し、[OK] で確認します。

手順 5: Azure ポータルの [デプロイ センター] ページに戻ります。

1. [ログ] タブを選択し、[最新の情報に更新] を選択して、新しいデプロイの実行を確認します。
2. デプロイの実行のログ項目で、最新のタイムスタンプを持つ [ビルドまたはデプロイ ログ] エントリを選びます。

手順 6: GitHub リポジトリにアクセスし、GitHubアクションが実行されていることを確認します。 ワークフロー ファイルでは、ビルドとデプロイという 2 つの異なるステージを定義します。 GitHubが実行され、Success の状態が表示されるまで待ちます。 所要時間は約 5 分です。

手順 1: [App Service] ページに戻り、左側のメニューで

1. [開発ツール]>[SSH] を選択します。
2. [Go] \(移動) を選択します。 (起動には数分かかります)。

手順 2: SSH セッション内で次を実行します。

1. cd /home/site/wwwroot を実行します。 デプロイされたすべてのファイルがここにあります。
2. コマンド ./migrationsbundle -- --environment Production を使用して、GitHub ワークフローによって生成された移行バンドルを実行します。 それに成功すると、App Service は SQL Database に正常に接続した状態になります。 --environment Production は、"Program.cs" で行ったコードの変更に対応します。

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

1. 左側のメニューから [概要] を選びます。
2. アプリの URL を選びます。

手順 2: この一覧にいくつかのタスクを追加します。 おめでとうございます。これで、Azure SQL Databaseへの安全な接続を確立し、Azure App ServiceでWebアプリを実行しています。

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

1. 左側のメニューから [監視]>[App Service ログ] を選択します。
2. [アプリケーション ログ記録] で [ファイル システム] を選びます。
3. 上部のメニューから、[保存] を選択します。

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

手順 1: Azure ポータルの上部にある検索バーで、次の手順を実行します。

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

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

ステップ 3:

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