1. コンテナを使用したSitecoreのローカル開発

コンテナで実行されているコードのデバッグ

Version:
日本語翻訳に関する免責事項

このページの翻訳はAIによって自動的に行われました。可能な限り正確な翻訳を心掛けていますが、原文と異なる表現や解釈が含まれる場合があります。正確で公式な情報については、必ず英語の原文をご参照ください。

このトピックでは、Visual Studioを使用して、ローカル のDockerコンテナーで実行されているコードを診断する方法について説明します。

始める前に

このガイドでは、ソリューションのビルド出力を含むカスタムSitecoreランタイム イメージをビルドして実行できることを前提としています。

Docker Examplesリポジトリのcustom-imagesソリューションをお持ちでない場合は、そのソリューションを使用できます。準備手順に従うか、付属のinit.ps1スクリプトを実行して、これらの準備手順を自動的に実行します。

前提 条件

ローカルのDockerコンテナでアプリをデバッグするには、次のものが必要です。

  • Visual Studio 2019バージョン16.5.0以降

デバッグシンボルが使用可能であることの確認

コンテナに固有ではありませんが、デバッグシンボルがコンテナにデプロイされていることを確認する必要があります。

これは、Debugビルド構成を使用してソリューションイメージをビルドしている場合にすでに行われている可能性があります。たとえば、Docker Examplesリポジトリのcustom-imagesの例では、デフォルトでこれをDebugに設定するBUILD_CONFIGURATION環境変数を使用しています。

また、Visual Studioから実行中のコンテナーにDebugファイルのデプロイを行うこともできます。

Visual Studioデバッガーをアタッチする

Visual Studioでは、コンテナー内のプロセスにアタッチするための2つのオプションがあります。

オプション1: コンテナウィンドウを使用する

Containersウィンドウを使用するには:

  1. Containersウィンドウが表示されない場合は、上部のViewメニューから開きます。Other Windowsをクリックし、Containersをクリックします。

  2. 実行中のコンテナのリストで、デバッグするコンテナを右クリックし、Attach to Processをクリックします。

    Image showing how you attach to a process in Visual Studio.

  3. Attach to Processダイアログが表示され、コンテナで実行されている使用可能なプロセスが表示されます。

    Visual Studio dialog with a list of processes.

  4. Attach to Processでは、正しいコードタイプが選択されていることを確認します。CMまたはCD w3wp.exeをデバッグする場合、これはManaged Code (v4.6, v4.5, v4.0)になります。

  5. 通常どおりプロセス( w3wp.exeなど)を選択し(表示されていない場合はShow processes from all usersにチェックを入れます)、「 Attach」をクリックします。

オプション2: デバッグ メニューを使用する

または、Debugメニューを使用することもできますが、これにはContainersウィンドウよりもいくつかの手順が必要です。

Debugメニューを使用するには:

  1. 上部のDebugメニューからAttach to ProcessをクリックしてAttach to Processダイアログを開きます。

  2. Connection typeの場合は、Docker (Windows Container) をクリックします。

  3. Connection targetの場合は、Findをクリックします。実行中のコンテナがリストに表示されます。デバッグするコンテナを選択し、「OK」をクリックします。

  4. Attach toの場合は、正しいコード タイプが選択されていることを確認します。CMまたはCD w3wp.exeファイルをデバッグするには、Managed Code (v4.6, v4.5, v4.0)を使用します。

  5. 通常どおりプロセス( w3wp.exeなど)を選択し(表示されていない場合はShow processes from all usersにチェックを入れます)、「 Attach」をクリックします。

この記事を改善するための提案がある場合は、 お知らせください!