引入用于 Azure IoT Edge 的 Visual Studio 工具

今天，我们很高兴地发布用于 Visual Studio 2017 的 Azure IoT Edge 工具的预览版。Azure IoT Edge 是一个全托管服务，通过直接在跨平台物联网设备上部署并运行人工智能、Azure 服务和自定义逻辑，从而在本地提供云智能。使用此预览版，您可以在 Visual Studio 中创建 Azure IoT Edge 项目，添加 C# 自定义模块，生成模块，并将这些模块推送到 IoT Edge 设备上。此外，您还可以在本地 Visual Studio 中同时调试单个 C# 模块或多个模块。

在这篇文章中，我们将向您介绍如何使用 Visual Studio 2017 创建、构建、调试和部署您的首个 IoT Edge 解决方案。

先决条件

开始使用前，我们需要做以下准备工作。

• 安装 .Net Core 2.1 SDK。

• 安装 Windows 版 Docker CE。同时确保 Docker CE 以所需的容器模式（Windows      或 Linux）运行。

• 安装 Python 和 Pip。要安装 Azure IoT Edge Hub Dev 工具，必须安装 Python 和 Pip。

• 在终端中运行以下命令，安装 Azure IoT Edge Hub Dev 工具 (iotedgehubdev)

pip install -U iotedgehubdev

• 从 Visual Studio 市场安装 Visual Studio 版 Azure IoT Edge 工具。

• 更新 Visual Studio 的 Cloud Explorer。“工具” > “扩展…” > “查找 Cloud Explorer”，然后单击“更新”按钮（版本号）

在Visual Studio中创建首个IoT Edge解决方案

在 Azure IoT Edge 示例项目中，我们将从 C# 模块开始，该模块可将消息从模拟温度传感器直接发送到 Azure IoT 中心。

■ 1、在 Visual Studio 中，导航到“文件” > “新建” > “项目”

■ 2、在 "Visual C#" 部分下选择“云”节点，然后选择 "Azure IoT Edge" 项目类型。如果需要，您可以指定“解决方案名称”和“解决方案位置”。然后单击“确定”。

■ 3、在“模块配置”窗口中，您需要提供 C# 模块项目名称和 Docker 映像存储库。若要在 Azure 容器注册表上托管映像，请将 localhost:5000 替换为从 ACR 复制的登录服务器值。最终字符串与 <注册表名称>.azurecr.io/iotedgemodule1 类似。然后单击“确定”。

现在，Visual Studio 向您提供 Azure IoT Edge 解决方案，其中有两个项目。

• AzureIoTEdgeApp1 是 Azure IoT Edge 项目，包含 Azure IoT Edge 部署清单模板，该模板描述解决方案的模块映像以及模块间的路由。

• IoTEdgeModule1 是第一个 C# 模块项目，属于 .Net Core 控制台应用程序。

构建和调试单个 C# 模块

通常，我们希望先测试/调试每个模块之后，再让该模块与多个模块一起在整个解决方案中运行。

■ 1、成功创建项目后，在上下文菜单中将 IoTEdgeModule1 选为默认项目。

■ 2、按 F5 或单击以下按钮运行模块，第一次可能耗时 10~20 秒。

注：如果发现任何冲突错误，则需使用 Docker CLI 停止正在运行的同名容器，然后再按一次 F5。

■ 3、如果模块已成功初始化，您将看到 .Net Core 控制台应用程序已启动。

■ 4、现在您可以在 Program.cs 的 PipeMessage 中设置断点，然后在 Git Bash 或 WSL Bash 中运行以下命令来发送消息（请勿在 CMD 或 Powershell 中运行以下命令）（您也可以在“输出”窗口中找到此命令）：

curl --header "Content-Type: application/json" --request POST --data '{"inputName": "input1","data":"hello world"}' http://localhost:53000/api/v1/messages

■ 5、断点应被触发。您可以在“Visual Studio 局部变量”窗口中查看变量。

构建和调试具有多个模块的 IoT Edge 解决方案

开发了单个模块之后，接下来，我们希望运行和调试具有多个模块的整个解决方案。

■ 1、将第二个 C# 模块添加到解决方案中。右击 AzureIoTEdgeApp1 并选择“添加” > “新建 IoT Edge 模块”。此操作将把 IoTEdgeModule2 添加到项目中，还会更新 AzureIoTEdgeApp1 项目中的 deployment.template.json。第二个模块仍然是一个管道模块，接收来自模拟温度传感器的消息，并将消息发送给 IoT 中心。

■ 2、将 AzureIoTEdgeApp1 项目设为启动项目。

■ 3、按 F5，然后即可同时运行和调试多个模块。您将会看到多个 .Net Core 控制台应用程序窗口，每个窗口都显示 C# 模块。若要更新模块拓扑，请更新 AzureIoTEdgeApp1 > deployment.template.json 中的路由部分。

生成和推送映像至 Azure 容器注册表

接下来，我们将所有 C# 模块放入 Docker 映像中并推送到 ACR。

■ 1、请确保启动项目是 AzureIoTEdgeApp1。选择“调试”或“发布”配置，以生成模块映像。

■ 2、在终端通过以下命令运行 Docker 登录

docker login -u <ACR username> -p <ACR password> <ACR login server> 

■ 3、使用以下内容更新 deployment.template.json。请记住将占位符替换为实际的管理员用户名和密码。

■ 4、右击 AzureIoTEdgeApp1 并选择上下文菜单项“生成并推送      Edge 解决方案”，该项将为每个模块生成和推送 Docker 映像。

在VisualStudioCloudExplorer中创建IoTEdge部署

现在所有映像都可以在 ACR 中部署。

■ 1、单击“试图” > Cloud Explorer，打开 Cloud Explorer

■ 2、右击 IoT Edge 设备，为其创建部署，你需要选择 $AzureIoTEdgeApp1\config\Debug|Release\deployment.json 下的部署清单文件。

注：您需要自行在 Windows 或 Linux 设备上设置 IoT Edge 守护程序。

查看生成的数据

要监视特定设备的 D2C 消息，请右击列表中的设备，然后选择“开始监视 D2C 消息”。

已知限制

由于这是 Visual Studio 中 IoT Edge 工具的第一个预览版，因此存在几个已知的局限，具体如下：

• 用于部署清单文件的 IntelliSense：除 Json 验证之外，我们还没有用于 deployment.template.json 和 deployment.json 的 IntelliSense。

• 仅支持 C# 自定义模块：我们计划尽快为自定义模块和函数支持添加其他语言。

• 仅支持 Amd64 Linux 和 Windows Docker 文件：我们正在为 arm-Linux 模块进行交叉编译。

结论

通过 Visual Studio 2017 中的这些新工具，您现在可以使用 Azure IoT Edge 轻松创建、调试和部署解决方案。请从 Azure IoT Edge for Visual Studio 下载并试用它（预览版）。此外，请将您遇到的任何问题、任何功能请求或其他问题报告给 vsciet@microsoft.com。

▶ 本文翻译转载自MSDN网站

▶ 原文作者：Xin_Shi