---
title: "XCコンテナで動作するデバッグコード"
slug: "debug-code-running-in-xc-containers"
abstract: "このトピックでは、コンテナ上で動作するCommerce Engineコードをデバッグする方法を示します。"
---
# XCコンテナで動作するデバッグコード

このトピックでは、ローカルDockerコンテナ上でCommerceエンジンのコードを [表示・診断するためにVisual Studio](https://docs.microsoft.com/en-us/visualstudio/containers/view-and-diagnose-containers?view=vs-2019)を使う方法について説明します。これは、Commerceソリューションのビルド出力を含む [カスタムDockerランタイムイメージの構築と実行](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/workflow-for-creating-custom-commerce-container-images.html "Workflow for creating custom Commerce container images") 方法を知っていることを前提としています。

ローカルDockerコンテナでアプリをデバッグするには、Visual Studio 2019バージョン16.5.0以降を使用する必要があります。

> !注コンテナに特有のものではありませんが、デバッグシンボルがコンテナにデプロイされていることを確認しなければなりません。これは*Debug*ビルド構成でソリューションイメージを構築する場合、すでに行われているかもしれません。
> 
> また、Visual Studioから実行中のコンテナに*Debug*ファイル展開を行うこともできます。

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

-   [オプション1:コンテナウィンドウを使ってVisual Studioデバッガを接続する](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/debug-code-running-in-xc-containers.html#UUID-401c6f7e-e899-4f4a-3bcc-fa5d67986159_N1615906914713 "Option 1: Attach the Visual Studio debugger using the Containers window")
-   [オプション2:Debugメニューを使ってVisual Studioデバッガを接続する](https://doc.sitecore.com/xp/ja/developers/101/sitecore-experience-commerce/debug-code-running-in-xc-containers.html#UUID-401c6f7e-e899-4f4a-3bcc-fa5d67986159_section-idm253231813139422 "Option 2: Attach the Visual Studio debugger using the Debug menu")

## オプション1:コンテナウィンドウを使ってVisual Studioデバッガを接続する

Visual Studioデバッガをコンテナ上で動作するプロセスにアタッチするには:

1.  もし **コンテナウィンドウ** が表示されない場合は、上部 **の「ビュー** 」メニューから開いてください。「 **その他のウィンドウ**」をクリックし、「コンテナ **」**をクリックします。
    
2.  実行中のコンテナリストで、デバッグしたいコンテナ(例えば*container\_engine\_authoring\_1*)を右クリックし、「 **プロセスに付け加え**る」をクリックしてください:
    
    ![In Visual Studio, the Attach to Process option in the dialog box containing debugging actions.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/AttachToProcess.png)
    
    **「プロセスにアタッチ」**ダイアログが開きます。
    
3.  **プロセスにアタッチ**するダイアログでは、Commerce Engine **dotnet.exe**プロセスをデバッグするには、以下の例のように**Automatic: Managed(.NET Core, .NET 5+)code**のコードタイプを使用します。
    
    ![The Attach to Process dialog box with the dotnet.exe process selected.](https://doc.sitecore.com/api/markdown-image/xp/ja/developers/101/sitecore-experience-commerce/images/Available_Process.png)
    
4.  **「添付**」をクリックします。
    

## オプション2:Debugメニューを使ってVisual Studioデバッガを接続する

あるいは、Visual Studioのデバッグメニューを使うこともできます。

Visual Studioデバッガをコンテナ上で動作するプロセスにアタッチするには:

1.  Visual Studioのメニューバーで **「Debug**」をクリックし、「Attach」をクリックしてから **「Attach to Process**」をクリックします。「 **Attach to Process** 」ダイアログボックスが開きます。
2.  **Connectionタイプの**ドロップダウンリストで**Docker(Windowsコンテナ)**をクリックします。
3.  **Connection target**フィールドで**「Find**」をクリックします。実行中のコンテナがリストに表示されます。デバッグしたいコンテナをクリックし、「**OK」**をクリックします。
4.  **「Attach**」欄で正しい型を選択してください。Commerce Engine dotnet.exeプロセスのデバッグには、コードタイプ **Automatic: Managed(.NET Core, .NET 5+)**を使用します。
5.  **「添付**」をクリックします。