Azure IoT Operations SDK
什么是 Azure IoT Operations?
Azure IoT Operations 是面向边缘的统一数据平面。它由一组模块化、可扩展且高可用的数据服务组成,这些服务运行在 Azure Arc 启用的边缘 Kubernetes 集群上。它支持从各种不同系统中捕获数据,并与 Microsoft Fabric 等数据建模应用集成,帮助组织部署工业元宇宙。
请参阅 Azure IoT Operations Learn 文档],以了解有关该产品的更多信息,以及详细的部署和配置说明。
为什么使用 SDK?
Azure IoT Operations SDK 是一套跨多种语言的工具和库,旨在辅助开发 Azure IoT Operations 的应用程序。
SDK 的重点是通过提供以下功能,协助客户开发应用程序:
| 功能 | 描述 |
|---|---|
| 高可用性 | 提供基础设施和指导,以便在应用程序中构建高可用性 |
| 语言选择 | SDK 支持多种语言,以适应任何开发环境 |
| 安全性 | 使用最新的加密库和协议 |
| 零数据丢失 | 基于 MQTT 代理构建,消除因应用程序故障导致的数据丢失 |
| 低延迟 | 优化的分层架构和紧密的 MQTT 客户端耦合,最小化开销 |
| 与 IoT Operations 服务集成 | 库提供对状态存储等服务的支持 |
| 简化复杂消息传递 | 通过 RPC 实现,提供基于 MQTT5 的应用程序间通信支持 |
| 支持 | SDK 由 Microsoft 的专门团队维护和支持 |
入门指南
使用 GitHub Codespaces 在 Kubernetes 集群上试用 Azure IoT Operations SDK,无需在本地机器上安装任何内容。
[!TIP] 有关其他平台和更详细的设置说明,请参阅设置文档。
-
从 Azure IoT Operations SDK 仓库创建一个 codespace:
-
按照 Azure IoT Operations 文档 连接 Azure Arc 并部署 Azure IoT Operations。
-
运行
configure-aio脚本以配置用于开发的 Azure IoT Operations:./tools/deployment/configure-aio.sh
后续步骤
组件
下表概述了当前组件及其相关的语言支持。
[!TIP] 有关 SDK 组件的更多信息,请参阅我们的组件文档。
| 状态 | 支持 |
|---|---|
| :green_circle: 已完成 | 该功能已发布,并由团队积极支持。 |
| :yellow_circle: 进行中 | 正在开发中,不提供支持。 |
| :orange_circle: 计划中 | 近期已计划进行相关工作。 |
| 功能 | 描述 | .NET | Go | Rust |
|---|---|---|---|---|
| Session 客户端 | 初始化 MQTT 客户端并连接到 MQTT broker。处理所有身份验证和重连。 | :green_circle: | :green_circle: | :green_circle: |
| Command 客户端 | 基于 MQTT5 构建的 Command (invoker/executor) 客户端 | :green_circle: | :green_circle: | :green_circle: |
| Telemetry 客户端 | 基于 MQTT5 构建的 Telemetry (sender/receiver) 客户端 | :green_circle: | :green_circle: | :green_circle: |
| Schema registry 客户端 | 与 schema registry 交互以获取和存储资产 schema | :green_circle: | :green_circle: | :green_circle: |
| State store 客户端 | 支持与 state store 交互的客户端,提供获取/设置/删除和监视键的能力 | :green_circle: | :green_circle: | :green_circle: |
| Lease lock 客户端 | 为共享资源创建锁 | :green_circle: | :green_circle: | :green_circle: |
| Azure Device Registry 客户端 | 设备端点和资产配置以及资产发现 | :green_circle: | :green_circle: | |
| Connector SDK | 简化连接器开发的 SDK | :yellow_circle: | :green_circle: |
需要支持?
请参阅 SUPPORT.md 以获取报告 bug、请求功能和获取协助的指导。
对于安全相关问题,请遵循 SECURITY.md 中概述的指导。
贡献
本项目欢迎贡献和建议。大多数贡献要求您同意一份贡献者许可协议(CLA),声明您有权并且确实授予我们使用您贡献的权利。有关详细信息,请访问 https://cla.opensource.microsoft.com。
当您提交拉取请求时,CLA 机器人将自动确定您是否需要提供 CLA,并相应地标记 PR(例如,状态检查、评论)。只需按照机器人提供的说明操作即可。您只需在所有使用我们 CLA 的仓库中执行一次此操作。
本项目已采纳 Microsoft Open Source Code of Conduct。有关更多信息,请参阅 Code of Conduct FAQ 或联系 opencode@microsoft.com 提出任何额外的问题或评论。
Trademarks
本项目可能包含项目、产品或服务的商标或徽标。Microsoft 商标或徽标的授权使用须遵守并遵循 Microsoft's Trademark & Brand Guidelines。在本项目的修改版本中使用 Microsoft 商标或徽标不得引起混淆或暗示 Microsoft 的赞助。任何第三方商标或徽标的使用均受该第三方政策约束。