ローカル Docker コンテナー内のアプリをデバッグする

Visual Studio には、Docker コンテナーを開発し、アプリケーションをローカルで検証するための一貫した方法が用意されています。 Docker がインストールされているローカル Windows デスクトップで実行されている Linux または Windows コンテナーでアプリを実行およびデバッグできます。コードを変更するたびにコンテナーを再起動する必要はありません。

この記事では、Visual Studio を使用してローカル Docker コンテナーでアプリを起動し、変更を加え、ブラウザーを更新して変更を確認する方法について説明します。 この記事では、コンテナー化されたアプリのデバッグ用にブレークポイントを設定する方法についても説明します。 サポートされているプロジェクトの種類には、Web アプリ、コンソール アプリ、.NET Framework と .NET Core を対象とする Azure 関数が含まれます。 この記事で紹介する例は、Core Web App ASP.NET 型のプロジェクトと、コンソール アプリ (.NET Framework) 型のプロジェクトです。

サポートされている種類のプロジェクトが既にある場合は、Visual Studio で Dockerfile を作成し、コンテナーで実行するようにプロジェクトを構成できます。 Visual Studio のコンテナー ツールを参照してください。

前提 条件

ローカル Docker コンテナー内のアプリをデバッグするには、次のツールをインストールする必要があります。

Docker コンテナーをローカルで実行するには、ローカルの Docker クライアントが必要です。 Docker Desktop を使用できます。これには Windows 10 以降が必要です。

Web アプリを作成する

プロジェクトがあり、「の概要」の説明に従って Docker サポートを追加した場合は、このセクションをスキップしてください。

Razor ページを編集して更新する

Razor ページの変更をすばやく反復処理するには、コンテナーでアプリケーションを開始します。 次に、インターネット インフォメーション サービス (IIS) Express の場合と同様に変更を加え続けます。

1. 使用しているコンテナーの種類 (Linux または Windows) を使用するように Docker が設定されていることを確認します。 タスク バーの Docker アイコンを右クリックし、[Linux コンテナーに切り替える] を選択するか、必要に応じて [Windows コンテナー に切り替える] を します。

2. このセクションの説明に従ってコードを編集し、実行中のサイトを更新することは、.NET Core および .NET 5 以降の既定のテンプレートでは有効になっていません。 これを有効にするには、Microsoft.AspNetCore.Mvc.Razor.RuntimeCompilation NuGet パッケージを追加します。 AddRazorRuntimeCompilation 拡張メソッドの呼び出しを、Startup.ConfigureServices メソッドのコードに追加します。 これは DEBUG モードでのみ有効にする必要があるため、Main メソッドで次のようにコードを記述します。

   // Add services to the container.
   var mvcBuilder = builder.Services.AddRazorPages();
   #if DEBUG
       if (Env.IsDevelopment())
       {
           mvcBuilder.AddRazorRuntimeCompilation();
       }
   #endif
   

   詳細については、「ASP.NET Core での Razor ファイルのコンパイル」を参照してください。 正確なコードは、使用したターゲット フレームワークとプロジェクト テンプレートによって異なる場合があります。

3. [ソリューション構成] を [デバッグ] に設定します。 次に、Ctrl キー 押+F5 キーを押して Docker イメージをビルドし、ローカルで実行します。

   コンテナー イメージがビルドされ、Docker コンテナーで実行されている場合、Visual Studio は既定のブラウザーで Web アプリを起動します。

4. インデックス ページに移動します。 このページで変更を加えます。

5. Visual Studio に戻り、Index.cshtml 開きます。

6. 次の HTML コンテンツをファイルの末尾に追加し、変更を保存します。

   <h1>Hello from a Docker container!</h1>
   

7. 出力ウィンドウで、.NET ビルドが完了し、次の行が表示されたら、ブラウザーに戻り、ページを更新します。

   Now listening on: http://*:80
   Application started. Press Ctrl+C to shut down.
   

変更が適用されました。

ブレークポイントを使用したデバッグ

多くの場合、変更にはさらなる検査が必要です。 このタスクには、Visual Studio のデバッグ機能を使用できます。

1. Visual Studio で、Index.cshtml.csを開きます。

2. OnGet メソッドの内容を次のコードに置き換えます。

       ViewData["Message"] = "Your application description page from within a container";
   

3. コード行の左側にブレークポイントを設定します。

4. デバッグを開始してブレークポイントにヒットするには、F5 キーを押します。

5. Visual Studio に切り替えて、ブレークポイントを表示します。 値を検査します。

   

   

.NET Framework コンソール アプリを作成する

このセクションでは、最初にプロジェクトに Docker サポートを追加する方法を示して、ローカル Docker コンテナー内の .NET Framework コンソール アプリ プロジェクトをデバッグする方法について説明します。 プロジェクトの種類によって、Docker サポートのレベルが異なっていることを認識することが重要です。 .NET Core (.NET 5 以降を含む) コンソール アプリ プロジェクトと .NET Framework コンソール アプリ プロジェクトでは、さまざまなレベルの Docker サポートがあります。

.NET Framework コンソール アプリ プロジェクトが作成されると、Docker サポートを有効にするオプションはありません。 このようなプロジェクトを作成した後、Docker サポートをプロジェクトに明示的に追加する方法はありません。 .NET Framework コンソール アプリ プロジェクトの場合は、コンテナー オーケストレーションのサポートを追加できます。 .NET Framework コンソール アプリ プロジェクトにオーケストレーション サポートを追加すると、プロジェクトに Docker サポートが追加されるという副作用があります。

次の手順では、.NET Framework コンソール アプリ プロジェクトにオーケストレーション サポートを追加する方法を示します。その後、Docker のサポートがプロジェクトに追加され、プロジェクトをローカルの Docker コンテナーでデバッグできるようになります。

1. 新しい .NET Framework コンソール アプリ プロジェクトを作成します。
2. ソリューション エクスプローラーで、プロジェクト ノードを右クリックし、[ >コンテナー オーケストレーション サポート追加] を選択します。 表示されたダイアログ ボックスで、Docker Compose 選択します。 Dockerfile がプロジェクトに追加され、関連するサポート ファイルを含む Docker Compose プロジェクトが追加されます。

ブレークポイントを使用したデバッグ

1. ソリューション エクスプローラーで、Program.csを開きます。

2. Main メソッドの内容を次のコードに置き換えます。

       System.Console.WriteLine("Hello, world!");
   

3. コード行の左側にブレークポイントを設定します。

4. F5 押してデバッグを開始し、ブレークポイントにヒットします。

5. Visual Studio に切り替えてブレークポイントを表示し、値を検査します。

   

# This layer is to support debugging, VS's Token Proxy requires the runtime to be installed in the container
FROM mcr.microsoft.com/dotnet/runtime:8.0 AS runtime
FROM base as debug
COPY --from=runtime /usr/share/dotnet /usr/share/dotnet
RUN ln -s /usr/share/dotnet/dotnet /usr/bin/dotnet

# Set the stage to debug to use an image with the .NET runtime in it
services:
  functionappintegrated:
    build:
      target: debug

コンテナーの再利用

Visual Studio が通常デバッグ構成に使用する高速モード を使用する場合、Dockerfile を変更すると、Visual Studio によってコンテナー イメージとコンテナー自体のみが再構築されます。 Dockerfile を変更しない場合、Visual Studio は以前の実行のコンテナーを再利用します。

コンテナーを手動で変更し、クリーン なコンテナー イメージで再起動する場合は、Visual Studio で Build>Clean コマンドを使用し、通常どおりにビルドします。

リリース構成に一般的な高速モードを使用していない場合、Visual Studio はプロジェクトがビルドされるたびにコンテナーを再構築します。

高速モードを使用する場合は、構成できます。「Visual Studio Container Toolsを構成する方法」を参照してください。

トラブルシューティング

Visual Studio Docker 開発で発生する問題を解決する方法について説明します。

関連コンテンツ

詳細については、「Visual Studio でコンテナー化されたアプリをビルドする方法」を参照してください。

Docker with Visual Studio、Windows、Azure の詳細

• Visual Studio を使用したコンテナー開発の詳細について説明します。
• Docker コンテナーをビルドしてデプロイするには、Azure Pipelines Docker 統合に関するページを参照してください。
• Windows Server と Nano Server に関する記事のインデックスについては、Windows コンテナー情報 参照してください。
• Azure Kubernetes Service について学び、Azure Kubernetes Service のドキュメント を確認しましょう。