Visual Studio Code与 Dapr 集成

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

    • 脚手架Dapr任务、启动和组件资产
    • 查看正在运行的 Dapr 应用程序
      Dapr VSCode 扩展视图运行应用程序选项的截图
    • 调用 Dapr 应用的方法
    • 发布事件到 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) 输入并选择
    3. 输入 来过滤列表到可用的 Dapr 远程容器，并选择符合您应用程序的语言容器。 请注意，您可能需要选择
      添加 dapr 容器的截图
    4. Follow the prompts to rebuild your application in container.

    Example

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

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

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

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

    Note

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

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

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

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

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

    添加 daprd 任务到 tasks.json

    您需要在您的 tasks.json 文件中定义一个 daprd 任务和问题匹配器（problem matcher）。 这里有两个示例(均通过上述 成员引用。 注意，在 .NET Core daprd 任务(dpred -leaderboard)的情况下，还有一个dependsOn成员，它引用构建任务，以确保最新的代码正在运行/调试。 用了 ，这样当 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-grpc (-dapr-http-port 和 -dapr-grpc-port) 指定不同的 http/grpc 端口， 否则，当您尝试启动第二个配置时将端口冲突。

    收尾

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

    Note

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