偵錯容器化應用程式

Docker 擴充功能提供更多對 Docker 容器內應用程式進行偵錯的支援，例如為將偵錯工具附加至容器內執行的應用程式，搭建 launch.json 組態。

Docker 擴充功能提供 docker 偵錯組態提供者，其管理 VS Code 如何啟動應用程式，以及/或將偵錯工具附加至執行中的 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 容器內組建和偵錯專案的方式

• 使用 .NET SDK：如果您熟悉 MSBuild 或想要在沒有 Dockerfile 的情況下容器化您的專案，這是建議的選擇。

  注意：此選項僅適用於 .NET SDK 7 及更高版本，並使用 dotnet publish 命令來組建映像。

• 使用 Dockerfile：如果您偏好使用 Dockerfile 自訂您的專案，請選擇此選項。

如需關於這兩個選項的更多詳細資訊，請參閱 在 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 物件屬性

這些屬性與 VS Code 文件中描述的用於將偵錯工具附加至 Node.js 應用程式的屬性相同。在 node 物件中傳遞的所有屬性都將傳遞至 Node.js 偵錯配接器，即使未在下方特別列出。

python 物件屬性

netCore 物件屬性

在 netCore 物件中傳遞的屬性通常會傳遞至 .NET 偵錯配接器，即使未在下方特別列出。偵錯工具屬性的完整清單位於 OmniSharp VS Code 擴充功能文件中。

後續步驟

繼續閱讀以深入瞭解

• 在 Docker 容器內偵錯 Node.js
• 在 Docker 容器內偵錯 Python
• 在 Docker 容器內偵錯 .NET
• 使用 Docker Compose 偵錯
• 疑難排解