调试容器化应用

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

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

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

要求

脚手架或粘贴启动配置到launch.json 不是 足够的 来构建和调试一个容器。要成功运行容器启动配置，您必须拥有：

• 一个Dockerfile。
• Docker 构建和docker运行任务在任务.json输入：.
• 一个调用这些任务的启动配置。

我们建议使用容器：将Docker文件添加到工作区...命令来创建这些项目，如果这些资产不存在的话。如果你已经有一个功能正常的Dockerfile，我们建议使用容器：初始化用于容器调试命令来生成一个启动配置和与容器相关的任务。

Node.js

有关在容器内调试 Node.js 应用程序的更多信息，请参见 在容器内调试 Node.js.

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

{
  "配置": [
    {
      "名称": "容器: Node.js 启动",
      "类型": "docker",
      "请求": "启动",
      "预启动任务": "docker-run: 调试",
      "平台": "node"
    }
  ]
}

Python

关于在容器内调试Python应用程序的更多信息，请参见 在容器内调试Python.

示例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 对象属性

节点对象属性

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

Python 对象属性

netCore 对象属性

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

下一步

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

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