Skip to main content

Azure Digital Twins入门 - 配置本地环境和工具

分类:  Azure物联网 标签:  #Azure # #Digitial Twin 发布于: 2023-06-15 20:15:45

我们前面一节已经创建了Azure Digital Twins的实例,那么我们本章学习如何配置本地的环境和工具。

注意
开始之前我们需要注意到Azure Digital Twins只能使用Azure AAD来认证和授权,因此我们需要使用Azure CLi先行登录到Azure,然后使用Azure CliSecurity Principal来直接认证和授权。

Azure Digital TwinsHost Name

创建完成之后,转到Azure Portal, 默认是显示Overview的内容,也可以明确的从左侧的菜单Overview进入,如下图拿到Host Name的信息:


如上图所示,如果完整的Host Name需要添加上协议https://

安装Azure Cli工具

请安装Azure Cli工具,安装这个工具的步骤您可以参考文档:https://www.azuredeveloper.cn/article/azure-tutorial-azure-cli-introduction

安装完成之后,需要安装IoT的扩展,使用如下的命令来安装该扩展:

az extension add --upgrade --name azure-iot

注意
安装azure-iot扩展会比较缓慢,因为它需要从github.com上下载相应的软件,耐心等待一下。

安装完成之后,需要使用Azure Cli首先登录Azure, 登录之后的Security Principal就可以给其他工具使用了。

登录的步骤如下:

注意
注意选择您的实例创建区域。例如创建在国内,那么需要设置云环境在AzureChinaCloud

$ az cloud list -o table
IsActive    Name               Profile
----------  -----------------  ---------
False       AzureCloud         latest
True        AzureChinaCloud    latest
False       AzureUSGovernment  latest
False       AzureGermanCloud   latest

$ az cloud set --name AzureChinaCloud

$ az login

$ az account list -o table

 $ az account set --subscription <Your Subscription id>

至此你的环境算是设置好了。

工具Azure Digital Twins Explorer本地配置

Azure通过开源的形式提供了一个可视化的工具Azure Digital Twins Explorer, 用户可以在本地配置这个工具供自己开发和设计时使用,我们这里讲述一下如何在安装和配置这个工具。

前提条件

这个工具是基于Node.js的,因此在开始之前,需要安装Node.js的环境,您可以从这里下载Node.js安装:https://nodejs.org/en/

同时该工具的认证默认使用Azure Cli登录之后的Security Principal,务必先安装Azure Cli, 并按照上面的提示设置好Azure Cli

配置Explorer

您可以从这里下载该工具: https://github.com/Azure-Samples/digital-twins-explorer

您可以右侧Code这里下载zip回来,解压后,进入到子目录:client/src中,运行:

npm install

会安装必要的包和模块。

安装完成后,在相同的目录下运行 npm run start, 即可以启动这个工具,该工具默认监听在端口3000, 因此打开浏览器访问:http://localhost:3000, 第一次启动时需要输入Host Name如下图:


配置好了之后就可以启动了。

安装Visual Studio Code扩展

为了方便自己开发数字模型,我们需要编辑器,推荐使用Visual Studio Code, 如何安装这个编辑器,请自行搜索一下,安装好了之后,请安装一下扩展DTDL, 使用该扩展方便大家编写数字模型。

我们下一节来开始编写数字模型,然后使用三个工具分别来试验使用Azure Digital Twins:

  • 使用Azure digital Twin Explorere可视化工具。
  • 使用Azure Cli IoT扩展
  • 使用Azure Digital Twin SDK代码的形式。