Visual Studio Code与 Dapr 集成

有关如何在 VS Code中开发和运行Dapr应用程序的介绍

扩展

Dapr提供了一个预览版 的Dapr Visual Studio Code扩展 ,用于您的Dapr应用程序的本地开发和调试。

在 VSCode 中打开

功能概述

  • 脚手架Dapr任务、启动和组件资产
    Dapr VSCode 扩展 scaffold 选项的截图
  • 查看正在运行的 Dapr 应用程序
    Dapr VSCode 扩展视图运行应用程序选项的截图
  • 调用 Dapr 应用的方法
    Dapr VSCode 扩展调用选项的截图
  • 发布事件到 Dapr 应用程序
    Dapr VSCode 扩展发布选项的截图

Example

观看有关如何使用 Dapr VS 代码扩展的 视频:

远程开发容器

Visual Studio Code Remote Containers扩展允许您使用Docker容器作为功能齐全的开发环境,使您可以在容器中进行开发,而无需在本地文件系统中安装任何额外的框架或包。

Dapr 为每种语言的 SDK 预先构建了Docker 远程容器。 您可以选择您的一个选择来选择一个随时制作的环境。 注意这些预制容器自动更新到最新的 Dapr 版本。

设置远程开发容器

先决条件

创建远程 Dapr 容器

  1. 在 VS 代码中打开您的应用程序工作区(workspace)
  2. 在 command palette 中 (ctrl+shift+p) 输入并选择 Remote-Containers: Add Development Container Configuration Files...
    添加远程容器的截图
  3. 输入 dapr 来过滤列表到可用的 Dapr 远程容器,并选择符合您应用程序的语言容器。 请注意,您可能需要选择 Show All Definitions...
    添加 dapr 容器的截图
  4. Follow the prompts to rebuild your application in container.
    在开发容器中重新打开应用程序的截图

Example

观看有关如何使用应用程序的 Dapr VS 代码远程容器的 视频

疑难解答

同时调试多个Dapr应用程序

使用 VS Code extension,您可以通过Multi-target debugging同时调试多个Dapr应用程序

手动配置 Visual Studio Code 调试 daprd

如果你想要通过 tasks.jsonlaunch.json 文件配置一个项目使用Dapr而又不想使用 Dapr VS Code extension,这里有一些手动步骤说明。

开发 Dapr应用程序时,您通常使用 dapr cli 来启动你自定义的dapr服务,就像这样:

  1. dapr run --app-id nodeapp --app-port 3000 --dapr-http-port 3500 app.js

这将生成组件的 yaml 文件(如果它们不存在),以便您的服务能够与本地的redis 容器交互。 作为一个入门方法这很好用,但是如果你想要附加一个调试器到你的服务来进行代码调试呢? 您可以在这里使用 dapr 运行时(daprd) 来帮助实现这一点。

Note

Dapr runtime (daprd) 不会自动生成用于 Redis 的组件的 yaml 文件。 这些将需要手动创建,否则您需要运行 dapr cli (dapr) 来自动创建它们。

将调试器附加到您的服务中的一种方法是先从命令行中运行符合正确参数的 daprd,然后启动您的代码并附加调试器。 虽然这完全是一个可以接受的解决方案,但它也需要一些额外的步骤,以及对那些可能想要克隆你的仓库并点击 “play “按钮开始调试的开发人员进行一些指导。

使用 tasks.jsonlaunch.json 文件在 Visual Studio 代码中 您可以简化过程并要求 VS Code 在启动调试器之前启动 daprd 进程。

让我们开始吧!

修改 launch.json 配置以包含一个 preLaunchTask

在您的 launch.json 文件中,为您想要 daprd 启动的每个配置添加一个 preLaunchTaskpreLaunchTask 将引用您在 tasks.json 文件中定义的任务。 这里是 Node 和 .NET Core 的一个例子。 注意 preLaunchTasks 参考:daprd-web 和 daprd-leadboard。

  1. {
  2. "version": "0.2.0",
  3. "configurations": [
  4. {
  5. "type": "node",
  6. "request": "launch",
  7. "name": "Node Launch w/Dapr (Web)",
  8. "preLaunchTask": "daprd-web",
  9. "program": "${workspaceFolder}/Game/Web/server.js",
  10. "skipFiles": [
  11. "<node_internals>/**"
  12. ]
  13. },
  14. {
  15. "type": "coreclr",
  16. "request": "launch",
  17. "name": ".NET Core Launch w/Dapr (LeaderboardService)",
  18. "preLaunchTask": "daprd-leaderboard",
  19. "program": "${workspaceFolder}/Game/Services/LeaderboardService/bin/Debug/netcoreapp3.0/LeaderboardService.dll",
  20. "args": [],
  21. "cwd": "${workspaceFolder}/Game/Services/LeaderboardService",
  22. "stopAtEntry": false,
  23. "serverReadyAction": {
  24. "action": "openExternally",
  25. "pattern": "^\\s*Now listening on:\\s+(https?://\\S+)"
  26. },
  27. "env": {
  28. "ASPNETCORE_ENVIRONMENT": "Development"
  29. },
  30. "sourceFileMap": {
  31. "/Views": "${workspaceFolder}/Views"
  32. }
  33. }
  34. ]
  35. }

添加 daprd 任务到 tasks.json

您需要在您的 tasks.json 文件中定义一个 daprd 任务和问题匹配器(problem matcher)。 这里有两个示例(均通过上述 preLaunchTask 成员引用。 注意,在 .NET Core daprd 任务(dpred -leaderboard)的情况下,还有一个dependsOn成员,它引用构建任务,以确保最新的代码正在运行/调试。 用了 problemMatcher,这样当 daprd 进程启动和运行时,VSCode 就能够知道。

让我们大概看看正在传递到 daprd 命令的参数吧。

  • -app-id - 您微服务的 id (您将如何通过服务调用来定位它)
  • -app-port – 您的应用程序代码正在监听的端口号
  • -dapr-http-port – Dapr api的 http 端口
  • -dapr-grpc-port – Dapr api的 grpc 端口
  • -placement-host-address – 放置服务的位置(这应该在docker中运行,因为它是当你安装了dapr 并运行dapr init的时候创建) > 注意: 您将需要确保您为您创建的每个dapr-grpc (-dapr-http-port 和 -dapr-grpc-port) 指定不同的 http/grpc 端口, 否则,当您尝试启动第二个配置时将端口冲突。

注意: 您将需要确保您为您创建的每个dapr-grpc (-dapr-http-port 和 -dapr-grpc-port) 指定不同的 http/grpc 端口, 否则,当您尝试启动第二个配置时将端口冲突。

  1. {
  2. "version": "2.0.0",
  3. "tasks": [
  4. {
  5. "label": "build",
  6. "command": "dotnet",
  7. "type": "process",
  8. "args": [
  9. "build",
  10. "${workspaceFolder}/Game/Services/LeaderboardService/LeaderboardService.csproj",
  11. "/property:GenerateFullPaths=true",
  12. "/consoleloggerparameters:NoSummary"
  13. ],
  14. "problemMatcher": "$msCompile"
  15. },
  16. {
  17. "label": "daprd-web",
  18. "command": "daprd",
  19. "args": [
  20. "-app-id",
  21. "whac-a-mole--web",
  22. "-app-port",
  23. "3000",
  24. "-dapr-http-port",
  25. "51000",
  26. "-dapr-grpc-port",
  27. "52000",
  28. "-placement-host-address",
  29. "localhost:50005"
  30. ],
  31. "isBackground": true,
  32. "problemMatcher": {
  33. "pattern": [
  34. {
  35. "regexp": ".",
  36. "file": 1,
  37. "location": 2,
  38. "message": 3
  39. }
  40. ],
  41. "background": {
  42. "beginsPattern": "^.*starting Dapr Runtime.*",
  43. "endsPattern": "^.*waiting on port.*"
  44. }
  45. }
  46. },
  47. {
  48. "label": "daprd-leaderboard",
  49. "command": "daprd",
  50. "args": [
  51. "-app-id",
  52. "whac-a-mole--leaderboard",
  53. "-app-port",
  54. "5000",
  55. "-dapr-http-port",
  56. "51001",
  57. "-dapr-grpc-port",
  58. "52001",
  59. "-placement-host-address",
  60. "localhost:50005"
  61. ],
  62. "isBackground": true,
  63. "problemMatcher": {
  64. "pattern": [
  65. {
  66. "regexp": ".",
  67. "file": 1,
  68. "location": 2,
  69. "message": 3
  70. }
  71. ],
  72. "background": {
  73. "beginsPattern": "^.*starting Dapr Runtime.*",
  74. "endsPattern": "^.*waiting on port.*"
  75. }
  76. },
  77. "dependsOn": "build"
  78. }
  79. ]
  80. }

收尾

一旦您进行了所需的更改, 您应该能够在 VSCode 中切换到 debug 视图,然后点击“play”按钮来启动您的调试配置。 如果所有配置正确, 您应该在 VSCode 终端窗口中看到数据启动, debugger 应该附加到您的应用程序(您应该在调试窗口中看到它的输出)。

Note

因为您没有使用 dapr run* cli 命令, 但通过运行 daprd *list** 命令将不会显示当前正在运行的应用列表。