调试容器化应用程序

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

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

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

需求

将启动配置脚手架或粘贴到launch.json中不足以构建和调试Docker容器。要成功运行Docker启动配置，您必须拥有：

• 一个Dockerfile。
• docker-build 和 docker-run 任务在 tasks.json 中。
• 一个调用这些任务的启动配置。

我们建议使用Docker: Add Docker Files to Workspace...命令来创建这些项目，如果这些资产尚不存在。如果您已经有一个可用的Dockerfile，我们建议使用Docker: Initialize for Docker debugging命令来搭建启动配置和与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 对象属性

节点对象属性

这些属性与VS Code文档中描述的将调试器附加到Node.js应用程序的属性相同。所有在node对象中传递的属性都将传递给Node.js调试适配器，即使未在下面特别列出。

Python 对象属性

netCore 对象属性

在netCore对象中传递的属性通常会传递给.NET调试适配器，即使下面没有特别列出。完整的调试器属性列表在OmniSharp VS Code扩展文档中。

下一步

继续阅读以了解更多关于：

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