コンテナー化されたアプリのデバッグ

Docker拡張機能は、Dockerコンテナー内のアプリケーションのデバッグをより強力にサポートします。例えば、コンテナー内で実行中のアプリケーションにデバッガーをアタッチするためのlaunch.json構成の作成などが可能です。

Docker拡張機能は、VS CodeがDockerコンテナー内でアプリケーションを起動したり、実行中のアプリケーションにデバッガーをアタッチしたりする方法を管理するdockerデバッグ構成プロバイダーを提供します。このプロバイダーはlaunch.json内のエントリを通じて構成され、構成はプロバイダーがサポートする各アプリケーションプラットフォームに固有です。

Docker拡張機能は現在、Dockerコンテナー内のNode.js、Python、および.NETアプリケーションのデバッグをサポートしています。

必要条件

launch.jsonに起動構成を生成または貼り付けるだけでは、Dockerコンテナーをビルドおよびデバッグするには**不十分**です。 Docker起動構成を正常に実行するには、以下が必要です。

• Dockerfile。
• tasks.json内のdocker-buildおよびdocker-runタスク。
• これらのタスクを呼び出す起動構成。

これらのアセットがまだ存在しない場合は、**Docker: Dockerファイルをワークスペースに追加...**コマンドを使用してこれらを作成することをお勧めします。 既に機能するDockerfileがある場合は、**Docker: Dockerデバッグ用に初期化**コマンドを使用して、起動構成とDocker関連のタスクを生成することをお勧めします。

Node.js

Dockerコンテナー内のNode.jsアプリケーションのデバッグの詳細については、コンテナー内でのNode.jsのデバッグを参照してください。

Node.jsアプリケーションのデバッグ用のlaunch.json構成の例

{
  "configurations": [
    {
      "name": "Docker Node.js Launch",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "docker-run: debug",
      "platform": "node"
    }
  ]
}

Python

Dockerコンテナー内のPythonアプリケーションのデバッグの詳細については、コンテナー内でのPythonのデバッグを参照してください。

Pythonアプリケーションのデバッグ用のlaunch.json構成の例

{
  "configurations": [
    {
      "name": "Docker: Python - Django",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "docker-run: debug",
      "python": {
        "pathMappings": [
          {
            "localRoot": "${workspaceFolder}",
            "remoteRoot": "/app"
          }
        ],
        "projectType": "django"
      }
    }
  ]
}

.NET

Dockerコンテナー内でプロジェクトをビルドおよびデバッグする2つの方法を選択できます。

• .NET SDKを使用: MSBuildに慣れている場合、またはDockerfileなしでプロジェクトをコンテナー化したい場合は、こちらをお勧めします。

  注: このオプションは.NET SDK 7以降でのみ利用可能で、dotnet publishコマンドを使用してイメージをビルドします。

• Dockerfileを使用: Dockerfileでプロジェクトをカスタマイズしたい場合は、このオプションを選択してください。

これら2つのオプションの詳細については、Dockerコンテナー内での.NETのデバッグを参照してください。

Dockerfileを使用した.NETアプリケーションのデバッグ用のlaunch.json構成の例

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch .NET Core in Docker",
      "type": "docker",
      "request": "launch",
      "preLaunchTask": "Run Docker Container",
      "netCore": {
        "appProject": "${workspaceFolder}/project.csproj"
      }
    }
  ]
}

構成リファレンス

dockerServerReadyActionオブジェクトのプロパティ

nodeオブジェクトのプロパティ

これらのプロパティは、Node.jsアプリケーションにデバッガーをアタッチするためのVS Codeドキュメントで説明されているものと同じです。 nodeオブジェクトで渡されるすべてのプロパティは、以下に具体的にリストされていなくても、Node.jsデバッグアダプターに渡されます。

pythonオブジェクトのプロパティ

netCoreオブジェクトのプロパティ

netCoreオブジェクトで渡されるプロパティは、一般的に.NETデバッグアダプターに渡されます。以下に具体的にリストされていなくても同様です。 デバッガープロパティの完全なリストは、OmniSharp VS Code拡張機能のドキュメントにあります。

次のステップ

詳細については、以下をお読みください。

• Dockerコンテナー内でのNode.jsのデバッグ
• Dockerコンテナー内でのPythonのデバッグ
• Dockerコンテナー内での.NETのデバッグ
• Docker Composeを使用したデバッグ
• トラブルシューティング