Visual Studio Code で ASP.NET Core アプリを Azure に公開する

このチュートリアルでは、ASP.Net Core MVC アプリケーションを作成し、Visual Studio Code を使ってデプロイする方法を学びます。このチュートリアルは VS Code の知識があることを前提としています。詳細については、「VS Code の概要」を参照してください。このチュートリアルは、Windows、macOS、または Linux 環境で動作します。お使いの環境の正しいパス区切り文字 (\ か /) を使用してください。

Important

Azure App Service と ASP.NET Core のプレビューリリース

ASP.NET Core のプレビューリリースは、既定では Azure App Service に展開されません。 ASP.NET Core プレビューリリースを使用するアプリをホストするには、「Azure App Service に ASP.NET Core プレビューリリースをデプロイする」を参照してください。

App Service デプロイの問題のトラブルシューティングを行うには、「Azure App Service および IIS での ASP.NET Core のトラブルシューティング」を参照してください。

Prerequisites

Azure サブスクリプション。お持ちでない場合は、Azure 無料アカウントを取得します。
.NET SDK (最新の安定したリリース)。
Visual Studio Code。
- C# 拡張機能。
- Azure App Service 拡張機能。先に進む前に、拡張機能を使って Azure にサインインしてください。

ASP.NET Core MVC プロジェクトを作成する

統合ターミナルを開きます。
作業ディレクトリ (cd) を、プロジェクトを格納するディレクトリに設定します。
次のコマンドを実行してください:
```
dotnet new mvc -o MyMVCapp
code -r MyMVCapp
```
上記のコマンドについて:
- dotnet new mvc -o MyMVCapp
  - MyMVCapp フォルダーに新しい ASP.NET Core MVC プロジェクトを作成します。
- code -r MyMVCapp
  - Visual Studio Code に MyMVCapp.csproj プロジェクトファイルを読み込みます。
  - Visual Studio Code で統合ターミナルがそのプロジェクトディレクトリに更新されます。

Note

"ビルドとデバッグに必要な資産が 'MyMVCapp' にありません。追加しますか? " というダイアログボックスが表示されたら、[はい] を選択します。

次のような構造の MyMVCapp フォルダーに、新しい ASP.NET Core MVC プロジェクトが作成されます。

      appsettings.Development.json
      appsettings.json
<DIR> bin
<DIR> Controllers
<DIR> Models
      MyMVCapp.csproj
<DIR> obj
      Program.cs
<DIR> Properties
<DIR> Views
<DIR> wwwroot

.vscode フォルダーがプロジェクト構造の下に作成されます。 ASP.NET Core Web アプリのビルドとデバッグに役立つユーティリティファイルが含まれます。

プロジェクトをテストする

アプリを Azure にデプロイする前に、ローカルコンピューターで正しく実行されることを確認してください。

統合ターミナルを開きます (必要な場合)。
信頼された HTTPS 開発証明書を設定します。
- 次のコマンドを実行し、HTTPS 開発証明書を信頼します。
```
dotnet dev-certs https --trust
```
  上記のコマンドには、Linux 上の .NET 9 以降の SDK が必要です。 .NET 8.0.401 以前の SDK 上の Linux については、証明書を信頼するための Linux ディストリビューションのドキュメントを参照してください。
  
  証明書が以前に信頼されていなかった場合、前のコマンドでは次のダイアログが表示されます。
- 開発証明書を信頼することに同意する場合は、[ はい ] を選択します。
  
  詳細については、「ASP.NET Core HTTPS 開発証明書の信頼」セクションが含まれる「SSL の適用」の記事をご覧ください。
Firefox ブラウザーを信頼する方法の詳細については、「Firefox SEC_ERROR_INADEQUATE_KEY_USAGE 証明書エラー」を参照してください。
次のコマンドを実行してください:
```
dotnet run
```
上記のコマンド:
- KestrelASP.NET Core の組み込み Web サーバーが起動します。
- Web アプリをテストする URL が表示されます (http://localhost:<port> など)。<port> は、プロジェクト作成時に Properties\launchSettings.json で設定されるランダムなポート番号です。
出力に次のようなメッセージが表示されます。アプリは実行中であり、要求を待機していることを示しています。
```
$ dotnet run
Building...
info: Microsoft.Hosting.Lifetime[14]
    Now listening on: https://localhost:7064
info: Microsoft.Hosting.Lifetime[14]
    Now listening on: http://localhost:5119
info: Microsoft.Hosting.Lifetime[0]
    Application started. Press Ctrl+C to shut down.
info: Microsoft.Hosting.Lifetime[0]
    Hosting environment: Development
info: Microsoft.Hosting.Lifetime[0]
    Content root path: D:\Src\MyMVCapp\
```
+で HTTPS URL をクリックして、ブラウザーで Web アプリをテストします。上記の例では、URLはhttps://localhost:7064です。
統合ターミナルで Ctrl+キーを押して、テスト後に Web アプリをシャットダウンします。

デプロイパッケージをローカルで生成する

統合ターミナルで、次のコマンドを使って、bin/Publish にあるフォルダーに Release パッケージを生成します。
```
dotnet publish -c Release -o ./bin/Publish
```
bin フォルダー内に新しい Publish サブフォルダーが作成されます。このフォルダーには、Azure にデプロイするファイルが含まれています。

Azure App Service に公開する

Visual Studio Code 用の Azure App Service 拡張機能を活用し、下の手順で Azure App Service に直接、Web サイトを発行します。

新しい Azure Web App リソースを作成する

発行する既存の Azure Web Apps リソースがない場合は、作成する必要があります。

[Azure 拡張機能] タブの [ リソース ] ウィンドウで、使用するサブスクリプションを展開します。
App Services を右クリックし、[新しい Web アプリの作成...] を選択します。
画面の指示に従います。
1. Web アプリに一意の名前を入力してください。
2. 最新版の安定版 .NET ランタイム (.NET 6 (LTS) など) を選択します。 .NET Framework アプリ用である、ASP.NET ランタイムは選択しないでください。
3. 料金プランを選択してください。このチュートリアルでは、無料 (F1) でも問題ありません。

Azure に公開する

bin\Publish フォルダーを右クリックし、Deploy to Web App... を選択して画面の指示に従います。
1. Azure Web App リソースがあるサブスクリプションを選択します。
2. 発行する Azure Web Apps リソースを選択します。
3. 確認ダイアログが表示されたら、[ 展開 ] を選択します。
デプロイが完了したら、Browse Website をクリックしてデプロイを検証してください。

Browse Website をクリックすると、既定のブラウザーでそこに移動します。