除錯容器化應用

“容器工具”擴充套件為在容器內除錯應用程式提供了更多支援，例如為附加偵錯程式到在容器內執行的應用程式搭建 launch.json 配置。

“容器工具”擴充套件提供了一個 docker 除錯配置提供程式，它管理 VS Code 如何啟動應用程式和/或將偵錯程式附加到正在執行的容器中的應用程式。該提供程式透過 launch.json 中的條目進行配置，配置特定於該提供程式支援的每個應用程式平臺。

“容器工具”擴充套件目前支援在容器內除錯 Node.js、Python 和 .NET 應用程式。

要求

僅僅搭建或將啟動配置貼上到 launch.json 中是不足以構建和除錯容器的。要成功執行容器啟動配置，您必須擁有：

• 一個 Dockerfile。
• tasks.json 中的 docker-build 和 docker-run 任務。
• 一個呼叫這些任務的啟動配置。

如果這些資產都不存在，我們建議使用容器：將 Docker 檔案新增到工作區... 命令來建立這些專案。如果您已經有一個可用的 Dockerfile，我們建議使用容器：為容器除錯初始化命令來搭建啟動配置和與容器相關的任務。

Node.js

有關在容器內除錯 Node.js 應用程式的更多資訊，請參見在容器內除錯 Node.js。

用於除錯 Node.js 應用程式的 launch.json 配置示例

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

Python

有關在容器內除錯 Python 應用程式的更多資訊，請參見在容器內除錯 Python。

用於除錯 Python 應用程式的 launch.json 配置示例

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

.NET

您可以在兩種方式中選擇一種來在容器內構建和除錯您的專案：

• 使用 .NET SDK：如果您熟悉 MSBuild 或希望在沒有 Dockerfile 的情況下將專案容器化，這是推薦的選擇。

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

• 使用 Dockerfile：如果您更喜歡使用 Dockerfile 自定義您的專案，請選擇此選項。

有關這兩個選項的更多詳細資訊，請參閱在容器內除錯 .NET。

使用 Dockerfile 除錯 .NET 應用程式的 launch.json 配置示例

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

配置參考

dockerServerReadyAction 物件屬性

node 物件屬性

這些屬性與 VS Code 文件中描述的用於將偵錯程式附加到 Node.js 應用程式的屬性相同。在 node 物件中傳遞的所有屬性都將傳遞給 Node.js 除錯介面卡，即使下面沒有特別列出。

python 物件屬性

netCore 物件屬性

在 netCore 物件中傳遞的屬性通常會傳遞給 .NET 除錯介面卡，即使下面沒有特別列出。完整的偵錯程式屬性列表在 OmniSharp VS Code 擴充套件文件中。

後續步驟

繼續閱讀以瞭解更多資訊

• 在容器內除錯 Node.js
• 在容器內除錯 Python
• 在容器內除錯 .NET
• 使用 Docker Compose 進行除錯
• 故障排除