除錯容器化應用

Container Tools 擴充套件為在容器內除錯應用程式提供了更多支援，例如為將偵錯程式附加到在容器中執行的應用程式生成 launch.json 配置。

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

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

要求

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

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

我們建議使用Containers: Add Docker Files to Workspace... 命令來建立這些項，如果這些資產尚不存在。如果您已經有一個功能性的 Dockerfile，我們建議使用Containers: Initialize for container debugging 命令來生成啟動配置和與容器相關的任務。

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 進行除錯
• 故障排除