调试容器化应用

容器工具扩展为容器内的应用程序调试提供了更多支持，例如脚手架launch.json用于将调试器附加到容器内运行的应用程序的配置。

容器工具扩展提供了Docker调试配置提供者，管理 VS Code 如何启动应用程序和/或将调试器附加到运行容器中的应用程序。该提供者通过以下条目配置launch.json配置针对提供者支持的每个应用平台进行特定配置。

Container Tools 扩展目前支持在容器内调试 Node.js、Python 和 .NET 应用程序。

要求

将发射配置搭建或粘贴到launch.json但不足以构建和调试容器。要成功运行容器启动配置，您必须具备：

• 一个Dockerfile。
• docker-build以及docker-run任务tasks.json.
• 一个启动配置，调用这些任务。

如果这些资源还不存在，我们建议使用容器：将Docker 文件添加到工作区......命令来创建这些项目。如果你已经有一个功能正常的 Dockerfile，我们建议使用 Containers： Initialize for container debugg 命令来构建启动配置和容器相关任务。

Node.js

关于在容器中调试Node.js应用程序的更多信息，请参阅“容器中的调试”Node.js。

示例launch.json调试Node.js应用程序的配置：

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

Python

关于在容器中调试 Python 应用的更多信息，请参见“Debug Python in a container”。

示例launch.json调试 Python 应用程序的配置：

{
  "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 发布命令来构建映像。

• 使用 Dockerfile：如果你更喜欢用Dockerfile选择此选项。

关于这两个选项的更多细节，请参阅容器中的调试 .NET。

示例launch.json用于调试 .NET 应用程序的配置Dockerfile:

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

配置参考

dockerServerReadyAction object properties

节点对象属性

这些属性与 VS Code 文档中描述的用于将调试器附加到Node.js应用程序时相同。所有通过的性质节点对象会传递给Node.js调试适配器，即使下面没有具体列出。

Python 对象属性

netCore 对象属性

通过的财产网核对象通常传递给 .NET 调试适配器，即使下面没有具体列出。调试器属性的完整列表见 OmniSharp VS Code 扩展文档。

下一步

继续阅读，了解更多：

• 容器内的调试Node.js
• 在容器中调试 Python
• 在容器中调试 .NET
• 使用 Docker Compose 进行调试
• 故障排除